Codex-X is a cross-platform desktop manager designed to enhance the OpenAI Codex CLI experience. It provides a user-friendly graphical interface for managing prompt templates, switching between official OpenAI and third-party API providers, visualizing and editing TOML configurations, and managing authentication files. This tool is beneficial for users who frequently interact with Codex CLI and require simplified control over its advanced features, particularly for security research and development workflows.

How It Works

Built on the Tauri framework with a Rust backend and React/TypeScript frontend, Codex-X acts as a visual overlay for the Codex CLI. It allows users to directly inject pre-defined prompt templates (like gpt5.5-unrestricted.md) to enable specific modes or bypass sandbox restrictions. The application facilitates easy switching between various API providers by managing their Base URLs, API Keys, and models, and offers direct visualization and editing of the ~/.codex/config.toml and ~/.codex/auth.json files. It also includes session management features to synchronize and repair provider metadata for historical threads.

Quick Start & Requirements

• Primary install: Download pre-built binaries from the GitHub Releases page: https://github.com/yynxxxxx/Codex-X/releases (available for macOS .dmg, Windows .msi/.zip, Linux .deb/.rpm).
• Prerequisites: No specific software prerequisites are listed for end-users beyond OS compatibility (macOS, Windows, Linux).
• Development: Requires pnpm for installation (pnpm install) and development (pnpm dev). Building the desktop application uses pnpm --dir apps/desktop tauri build.
• macOS Installation Note: Users may encounter "software is damaged" warnings due to macOS Gatekeeper; manual quarantine attribute removal (xattr -dr com.apple.quarantine /Applications/Codex-X.app) is suggested for local testing if not using a signed/notarized build.

Highlighted Details

• Features built-in prompt templates (gpt5.4-unrestricted.md, gpt5.5-unrestricted.md) designed for security research scenarios like SQL injection testing and reverse engineering, enabling direct responses with methodologies.
• Provides a visual interface for managing official OpenAI and third-party Codex API providers, including Base URL, API Key, Model, and Wire API configuration.
• Offers direct visualization and editing capabilities for Codex's config.toml and auth.json files, with syntax highlighting.
• Includes session management to inspect, sync, and repair provider metadata for historical Codex threads, ensuring continuity.
• Cross-platform builds are automatically published via GitHub Releases, with in-app update checks.

Maintenance & Community

The project acknowledges support and feedback from the "LINUX DO 论坛 社区." Automated builds and releases are managed through GitHub Actions and Releases. No specific community channels like Discord or Slack are listed.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license permits commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The prompt injection feature, while powerful for security research, enables "unrestricted modes" and "CTF sandbox bypass," implying potential use cases that may require careful consideration. macOS users may need to manually bypass Gatekeeper security warnings for unsigned application builds. The project's functionality is tied to the Codex CLI, which may be a niche or evolving tool.