170-carry/codex-tools

What it solves

Codex Tools addresses the friction of managing multiple Codex accounts by providing a unified interface to track usage, automate account activation (pre-warming), and switch between identities. It also solves the limitation of using these accounts in external tools by providing a local, OpenAI-compatible API proxy.

How it works

The project acts as a management layer that sits on top of your existing Codex installation. It provides a GUI and CLI (ctc) to import and manage account credentials. When acting as an API proxy, it exposes a local /v1 endpoint that routes requests through your configured accounts, allowing you to rotate between them or prioritize specific accounts based on their remaining usage limits. It also integrates with cloudflared to expose this proxy to external tools that might block local network addresses.

Who it’s for

This tool is designed for power users and developers who rely on Codex for their workflows and need to manage multiple accounts, monitor usage quotas across different plans, or integrate Codex capabilities into third-party applications like Cursor or custom scripts.

Highlights

• Multi-Account Management: Import accounts via OAuth or JSON, with support for backups and account grouping.
• Usage Monitoring: Real-time tracking of account usage windows and plan types.
• Automated Pre-warming: Configurable automatic account activation to ensure accounts remain ready for use.
• OpenAI-Compatible Proxy: Exposes a local /v1 API that supports account rotation and priority-based selection.
• Cross-Platform CLI/GUI: Provides both a terminal-based interface (TUI/CLI) and a native desktop application for macOS and Windows.