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.2
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.2.tar.gz | 11.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codexforge-1.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.5 kB
Release files / codexforge-1.0.2.tar.gz
| Download URL | codexforge-1.0.2.tar.gz |
|---|---|
| Size | 11.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c5c64b72c7a4ffea5b9255b225bbd18b466643b11e9d5987da8968a30d5c717c
|
|
BLAKE2b-256 checksum How to use checksums |
bc36e7b8d0e9f3ef373f454b1f42df84c1f653c5b010dfba82e2c6a6ce669efb
|
| 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.2-py3-none-any.whl
| Download URL | codexforge-1.0.2-py3-none-any.whl |
|---|---|
| Size | 11.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad9cf2c6a95dec2ee5dc2c613d5086cf9e5d5f40c4a8f40e5f871f718c964793
|
|
BLAKE2b-256 checksum How to use checksums |
f0fa4ec9eda3d2e2a4e7168da9e7e2c876e2ed3e2610ea0ea73f87e0adc2841c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
