Metadata-Version: 2.1
Name: codexforge
Version: 1.0.3
Summary: Advanced AI Coding Agent CLI – fully agentic, local & cloud LLMs, beautiful terminal UI
Author: CODEX
License: MIT
Project-URL: Homepage, https://github.com/codex-cli/codex-cli
Project-URL: Repository, https://github.com/codex-cli/codex-cli
Keywords: ai,coding-agent,cli,llm,ollama,openrouter,agent,code-generator,developer-tools
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: rich >=13.0
Provides-Extra: dev
Requires-Dist: build ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'

# CODEX CLI

**Advanced AI Coding Agent** — fully agentic, works with local & cloud LLMs, beautiful terminal UI.

## Install

```bash
pip install codexforge
```

Or from source:

```bash
cd codex-cli
pip install -e .
```

## Quick Start

```bash
codexforge
```

### First-time setup

**Cloud (OpenRouter / OpenAI)**
```text
/key sk-or-v1-...
/model qwen/qwen3-coder
```

**Local (Ollama)**
```text
/endpoint http://localhost:11434/v1
/model qwen2.5-coder:14b
```

**LM Studio**
```text
/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:

```bash
export CODEX_HOME=/path/to/custom/dir
```

Example `config.json`:

```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
