About this project

opencodex is a lightweight local proxy that translates Codex's Responses API into whatever your provider speaks — streaming, tool calls, reasoning tokens, and images in both directions. It enables using Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama, or any other LLM with Codex, Claude Code, Claude Desktop, and Grok Build. Key features include: - **40+ built-in providers** plus any OpenAI-compatible endpoint - **ChatGPT account pool** for Codex auth with thread affinity, quota-aware auto-switching, and failover - **Combos** — virtual model IDs with failover or weighted round-robin across providers - **Sub-agents on any model** with v1/v2 surface control and fallback chains - **OAuth login** for xAI, Anthropic, and Kimi; API key or env var support - **Web search & vision sidecars** for non-OpenAI models - **Web dashboard** at localhost:10100 showing providers, OAuth status, model selection, and live request logs - **Desktop apps** for macOS, Windows, and Linux (beta) - **CLI** with commands for init, start/stop, service management, provider/account/combo management, and health checks - **Docker Compose** deployment with digest-pinned, non-root build - **Bounded memory ownership** with documented caps on all retained state Install via `npm install -g @bitkyc08/opencodex` then `ocx start`, or download the desktop app from GitHub releases. The project is MIT-licensed and independent of OpenAI, Anthropic, and other providers.