170-carry/codex-tools

What it solves

Codex Tools simplifies the management of multiple Codex accounts. It addresses the difficulty of switching between different account identities, tracking usage limits across multiple profiles, and integrating Codex capabilities into third-party tools that expect an OpenAI-compatible API.

How it works

The project provides a suite of tools including a desktop GUI, a command-line interface (CLI), and a local API proxy. It manages account credentials (via OAuth or JSON imports) and modifies local configuration files (auth.json and config.toml) to switch the active account. It also hosts a local server that acts as a reverse proxy, translating requests from OpenAI-compatible clients (like Cursor or ChatWise) into Codex requests, while automatically rotating through available accounts based on usage limits.

Who it’s for

Developers and power users who use multiple Codex accounts and want a centralized way to manage them, monitor usage, and expose their accounts as a standardized API for other AI tools.

Highlights

• Multi-account Management: Import accounts via OAuth or JSON and back up your account library.
• Usage Tracking: Monitor usage windows (5-hour and 1-week) and account plan types.
• OpenAI-Compatible Proxy: Provides a local /v1 endpoint with automatic account rotation and support for GPT-5.6 models.
• Flexible Interface: Access functionality via a desktop app, a TUI (Terminal User Interface), or a CLI (ctc).
• Cloudflare Integration: Built-in cloudflared support to expose the local proxy to the public internet for tools like Cursor.
• App Binding: One-click configuration to point the Codex App/CLI to the local proxy or restore original settings.