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.3
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.3.tar.gz | 13.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codexforge-1.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 25.4 kB
Release files / codexforge-1.0.3.tar.gz
| Download URL | codexforge-1.0.3.tar.gz |
|---|---|
| Size | 13.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6dae0d651ec541921a925ab86eafb650c07893431669b9a3ec3151dbda3343b9
|
|
BLAKE2b-256 checksum How to use checksums |
2ce9767ab9c739cb676b450b088d932b95607c64e8c12eb8f6501b7415ec97ce
|
| 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.3-py3-none-any.whl
| Download URL | codexforge-1.0.3-py3-none-any.whl |
|---|---|
| Size | 12.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
69f4292060f12e622231c37839a46d17f8df73b354db9319ea0c4294c6c4ffcf
|
|
BLAKE2b-256 checksum How to use checksums |
dbc0a6ed5d795a0dd2aae45cad5b3a8029ece8842424f7feaa2e682736b3529d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
