yynxxxxx/Codex-X

What It Does

Codex-X is a Tauri 2 desktop app for people who use OpenAI Codex Desktop or Codex CLI with several providers, prompt sets, Skills and MCP servers at once. Instead of hand-editing config.toml, auth.json and prompt files, it puts these into one interface: categorized prompt templates with per-item on/off switches, named official logins and third-party API providers, local session search/grouping/deletion, Skills and MCP enable/disable, and live TOML/Auth viewing. Token usage can be filtered by date and model.

Prompt injection supports two write modes: append to existing instructions, or replace them; a backup is created before each enable/disable action. Sessions can be checked for consistency with the current provider/model and synced without altering chat content.

Getting Started

Download an installer from GitHub Releases. Builds exist for macOS Apple Silicon and Intel (.dmg), Windows .msi and portable .zip, and Linux .deb/.rpm/.AppImage. Launch the app, then use the side navigation to open the prompt center, provider page, sessions, or Skills/MCP management. The app reads Codex's configuration from ~/.codex/config.toml and ~/.codex/auth.json by default, and stores its own database at ~/.codexx/codexx.db.

To develop from source, install pnpm and run:

pnpm install
pnpm dev

For the desktop build:

pnpm --dir apps/desktop tauri build

Configuration

Three environment variables redirect the app's data sources: CODEX_HOME for the Codex config directory, CODEXX_HOME for Codex-X's own data, and CC_SWITCH_HOME for importing providers from cc-switch. Provider editing covers Base URL, API Key, model, upstream protocol and headers, with a documented local routing layer for Responses, Chat Completions, Claude Messages and Gemini interfaces — see the provider protocol notes.

Constraints

• Deleting sessions is permanent and removes derived sub-sessions; close any Codex window or CLI still using them first.
• The "1M context window" toggle only applies if the selected model supports it.
• The macOS DMG is unsigned and not notarized, so Gatekeeper may report it as damaged; the README recommends Developer ID signing and notarization, and for local testing only offers removing the quarantine attribute with xattr.
• Windows portable builds update manually; in-app updates are limited to the MSI install.
• Windows WSL sessions are read-only and export-only, with limits covered in the WSL session notes.
• Licensed MIT.

HotRepo's take

The repository had four consecutive daily snapshots with gains of 64, 32, 79 and 50 stars between September 19 and 22, 2026, then appeared on the Rust daily list at 7th place on November 15 with 4,525 stars and 68 stars gained that day. No all-language daily rank has been recorded. The growth pattern fits a utility aimed at existing Codex users that is being shared through communities such as the one acknowledged in the README. Worth noting for prospective users: the project bundles prompt templates built around so-called "unrestricted/jailbreak" personas and reverse-engineering skills, and its main distribution artifacts are unsigned desktop installers, so the trust question is about the binary provenance rather than the feature set.