codexplusplus

Codex++ is an external launcher and management tool designed for OpenAI Codex/ChatGPT desktop applications. It leverages the Chromium DevTools Protocol and local auxiliary services to provide vendor switching, protocol conversion, session management, and interface enhancements, without modifying the official app.asar or writing patch files to the installation directory. After installation, there are two entry points: Codex++ silently launches the official desktop application and loads saved vendor configurations and enhancements; the Codex++ Management Tool is used to manage vendors, models, tool plugins, sessions, enhancements, scripts, updates, and diagnostics. For first-time use, it is recommended to open the Management Tool first to confirm the application path and runtime status, then configure vendors and enhancements, and finally launch from the Codex++ entry point. The Windows installer creates shortcuts on the desktop and in the Start menu, while the macOS DMG installs Codex++.app and the Management Tool application. Vendor configuration supports official login, official login mixed with API, pure API, aggregated vendors, as well as Responses/Chat Completions protocols, model testing, model lists, Provider Doctor, cc-switch, and link import. Official login mode uses only the official account; official login plus API mode retains the official account and plugin entry, but model requests always go through a compatible API; pure API mode fully uses custom Base URL and Key; aggregated vendors can route between multiple regular API vendors, supporting failover, per-session rotation, per-request rotation, and weighted rotation. Chat Completions can be converted to the Responses protocol used by Codex through a local proxy. In terms of models and context, it supports per-model context windows, automatic compression thresholds, model_catalog_json, general configuration, and selection of MCP, Skill, and Plugin per vendor. Per-model windows support 1M, 200K, or plain numbers, and Codex++ generates an independent model_catalog_json. Session management supports scanning local sessions, batch deletion, Markdown export, token usage history, Provider metadata synchronization, and backup. Codex enhancements include a plugin marketplace and model whitelist, session operations, paste fixes, Chinese interface, quick launch, session width and scroll restoration, service level control, Goals, Stepwise, and image overlay. Development workflow supports project movement, Upstream worktree, thread ID, and Zed Remote project identification and opening. Scripts and maintenance include user script installation and start/stop, application detection, shortcuts, Watcher, environment conflicts, log diagnostics, health checks, and Release updates. All interface enhancements can be individually disabled; turning off the Codex enhancements master switch still allows use as a vendor and launch management tool. Data locations include Codex configuration at ~/.codex/config.toml, login state at ~/.codex/auth.json, local database at ~/.codex/sqlite/*.db (with fallback to state_5.sqlite for older versions), Codex++ state and logs at ~/.codex-session-delete/, and Provider sync backups at ~/.codex/backups_state/provider-sync. Real API keys are only stored locally on the machine. The project releases installation packages via GitHub Release, generating NSIS installers for Windows and two DMG files for macOS (Intel x64 and Apple Silicon arm64). The Management Tool's About page can check for and initiate updates. The project is licensed under the GNU Affero General Public License v3.0, with SPDX identifier AGPL-3.0-only. Codex++ relies on the official desktop application's page structure, CDP, and local data formats; some injected features may need adaptation following official application updates.