CODEX CLI
Advanced AI Coding Agent — fully agentic, works with local & cloud LLMs, beautiful terminal UI.
Install
pip install codexforge
Or from source:
cd codex-cli
pip install -e .
Quick Start
codexforge
First-time setup
Cloud (OpenRouter / OpenAI)
/key sk-or-v1-...
/model qwen/qwen3-coder
Local (Ollama)
/endpoint http://localhost:11434/v1
/model qwen2.5-coder:14b
LM Studio
/endpoint http://localhost:1234/v1
/model your-model-name
Config JSON
All settings are stored in a single JSON file:
~/.codex/config.json
You can override the directory with the environment variable:
export CODEX_HOME=/path/to/custom/dir
Example config.json:
{
"base_url": "https://openrouter.ai/api/v1",
"api_key": "sk-or-...",
"model": "qwen/qwen3-coder",
"temperature": 0.3,
"max_tokens": 8192,
"max_agent_steps": 15,
"max_history": 24
}
Commands
| Command | Description |
|---|---|
/key [key] |
Set API key |
/endpoint <url> |
Set custom API base URL |
/model [name] |
Show / change model |
/mode agent|chat |
Switch between agent and chat mode |
/root <path> |
Set project workspace |
/config |
Show current config + JSON path |
/ls, /read, /search, /run, /git |
Tools |
/save, /load |
Session management |
/help |
Full help |
/quit |
Exit |
Modes
- agent (default) — Autonomous agent with tools (read/write/edit files, shell, search, git)
- chat — Simple conversational coding assistant
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for codexforge 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| codexforge-1.0.1.tar.gz | 11.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codexforge-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.5 kB
Release files / codexforge-1.0.1.tar.gz
| Download URL | codexforge-1.0.1.tar.gz |
|---|---|
| Size | 11.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
142dfe91cf7871071f9c10333bf3c6a839f5480c0b27c88c17959dd1d8c41bbb
|
|
BLAKE2b-256 checksum How to use checksums |
7ed92181d5489a9991cee2614364c75581f4177dc743ca94403b0c94b519bc1c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / codexforge-1.0.1-py3-none-any.whl
| Download URL | codexforge-1.0.1-py3-none-any.whl |
|---|---|
| Size | 11.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
43082ae0fbeba2016655598d1f2c859d330e43e39f1db1ab4cc26ec8cf2af23b
|
|
BLAKE2b-256 checksum How to use checksums |
148380483bf02fe2a9a2653cfcd520b9af154c8f35c689eff2107ca81036e5e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
