Manage Codex settings and prompts in a single desktop interface
When switching between multiple API providers and prompt templates, scattered configuration files can make it hard to track the current state. Codex-X is a tool for visually managing the settings of OpenAI Codex Desktop and CLI. It handles prompt injection, API switching, session cleanup, and Skills and MCP management within a single interface.
Consolidating scattered settings
Using Codex often results in config.toml, auth.json, and various prompt files being stored in different locations. Codex-X allows you to view and modify the current state without directly editing these files. In particular, frequently changed API providers or prompt templates can be switched with a few button clicks, which becomes more valuable as the work environment grows complex. The tool runs on macOS, Windows, and Linux, and is available in both installer and portable versions.
Managing prompts and APIs like plugins
The most notable feature is the method of 'injecting' prompts. It provides five built-in templates and six additional templates synchronized from GitHub, and allows you to register your own Markdown files directly. Each prompt has an independent switch and is applied to Codex in either 'keep existing' or 'replace all' mode. API provider management works similarly, storing multiple official logins and third-party APIs distinguished by name, allowing you to test connection status and models before switching immediately. It also supports importing existing settings from cc-switch.
Organizing sessions and extensions
It includes features for organizing local sessions, Skills, and MCP servers that accumulate over long-term use. Sessions are grouped by project path for easy search and deletion, and can be checked for consistency with the current API provider and synchronized if necessary. Skills and MCP can be installed via ZIP files or imported from existing settings, and can be individually enabled or disabled. An automatic backup is created before any changes are applied to prevent errors.
Things to check before use
This tool is intended for users who already use OpenAI Codex Desktop or CLI. Built on Rust and Tauri 2, it runs lightly, but installing an unsigned DMG on macOS may trigger a Gatekeeper warning. In this case, you must remove the quarantine attribute using the xattr command. Additionally, this software is for learning and research purposes and should not be used for attacks or illegal purposes. Session deletion is irreversible, so you must close the Codex window using that session before deleting it.
