Codex-X

Codex Prompts · API / Providers · Sessions · Skills / MCP in One Place

A cross-platform desktop tool for OpenAI Codex Desktop / Codex CLI. Manage prompt templates, switch third-party APIs, organize / repair / permanently delete local sessions, manage Skills / MCP, and inspect TOML and login credentials without repeatedly editing configuration files by hand.

---

What is Codex-X?

When you use Codex Desktop, the CLI, third-party APIs, and multiple prompts together, settings quickly become scattered across different files. Codex-X brings these frequent tasks into one desktop interface, so you can see the current state and complete common actions with a click.

You can use it to:

• Choose from the prompt library or import your own .md, then keep the existing prompt or replace it
• Manage multiple named official Codex login profiles and third-party APIs, duplicate or switch them with a click, and import Providers from cc-switch
• Search and organize local sessions by project, check / automatically repair problems, and precisely delete sessions you no longer need
• Manage Skills and MCP in one place, and inspect the current config.toml, auth.json, and operation backups
• Explore token usage by date and model in Settings, with subagent usage attributed to its main conversation

Preview

App preview: Home / Provider / TOML / Auth

Prompt injection results: security testing scenarios

SQL Injection Testing Post-deployment test: how to perform SQL injection testing against a target?

NSFW Response Test Observe boundary response changes after prompt injection

Prompt injection results: reverse engineering scenarios

APK Reverse Engineering Static / dynamic analysis workflow for Android APKs	APK Reverse Engineering 2 Additional APK reverse workflow and locating methods
EXE Reverse Engineering Windows executable analysis and debugging directions

Features

What you want to do	How Codex-X helps
🧩 Use prompt templates	The current library contains 5 templates. Enable / disable one with a click and choose “Keep existing” or “Replace existing”; GitHub sync, local caching, and importing or editing your own .md files are supported.
⚡ Switch APIs / relays	Save multiple named official Codex login profiles alongside third-party Providers, with one-click duplication and switching. Third-party Providers support connection checks, model discovery / testing, and imports from cc-switch.
💬 Organize local sessions	Search sessions, group them by project path, and check or automatically repair inconsistent data. Select one, several, or an entire project to permanently delete specific sessions from Codex storage.
🧠 Manage Skills / MCP	View available Skills and MCP servers, preview existing items before import, install a Skill from ZIP, enable / disable individual entries, and check Skill update status.
📝 Manage config and login	Inspect config.toml and auth.json in one place. Both official and third-party profile editors offer an “Enable 1M context window” checkbox beside config.toml>; it applies on save and requires model support. Important writes are backed up automatically.
📊 Track token usage	Switch between General and Usage statistics in Settings. Filter local usage by date and model, explore daily trends, cache hit rate, and model distribution, and view the 10 most recent main conversations. Subagent usage is attributed to its main conversation and does not count as a separate session.
📦 Use it across platforms	Available for macOS Apple Silicon / Intel, Windows MSI / portable, and Linux packages. Installed editions can download, verify, and install updates in the app; the portable edition keeps manual downloads.

Highlights

1. Prompt Template Center

Tip

Ready after installation, automatically expanded when online.

The app bundle includes 5 templates for offline use. After launch, it synchronizes 6 additional software-development and writing templates, plus later updates, from GitHub examples/ in the background without waiting for the Prompt page to open. Successfully synchronized online versions are cached locally and remain available during temporary network outages.

Template	Best for	Availability
gpt5.5-unrestricted.md	Compact and general-purpose for everyday coding and technical work	Bundled offline GitHub updates
gpt5.4-unrestricted.md	GPT-5.4 / Codex CLI workflows with a CTF and security-research focus	Bundled offline GitHub updates
gpt5.5-jeli.md	A plain-language general version with a fuller engineering and reverse-engineering workflow	Bundled offline GitHub updates
gpt-5.6-sol-unrestricted.md	A GPT-5.6 SOL prompt focused on direct execution and bilingual tasks	Bundled offline GitHub updates
海鸥3.0破甲.md	A Chinese technical-operator persona with routing for coding, CTF, reverse engineering, memory, and protocol work	Bundled offline GitHub updates
software-development-maintainer.md	Long-term maintenance with reuse, minimal changes, safety, testing, and maintainability	GitHub sync
software-development-debugging.md	Evidence-driven debugging from reliable reproduction to root-cause repair and regression checks	GitHub sync
software-development-code-review.md	Severity-ranked review of defects, regressions, security risks, and test gaps	GitHub sync
writing-clarity-editor.md	Chinese and English editing that preserves the author's meaning and facts	GitHub sync
writing-technical-docs.md	Source-grounded README, guide, API, architecture, and release documentation	GitHub sync
writing-structured-draft.md	Turns scattered material into a structured report, proposal, retrospective, or article draft	GitHub sync

Keep existing prompt Best for users who already have personal rules. Codex-X only appends its managed content and removes only that content when disabled, leaving the original prompt untouched.

Replace existing prompt Makes the selected template the primary instruction entry point, which is useful when you want to switch completely to a specific template.

A backup is created automatically before every enable or disable action. In addition to the template library, you can import, edit, and delete your own .md prompts.

2. Provider Switching: Ready in a New Session

Note

After enabling a new third-party Provider, create or reopen a Codex session to use the new relay. You do not need to restart the entire Codex client.

• Save multiple named official Codex login profiles and third-party Providers, and always see which one is currently active
• Duplicate a profile immediately with one click, without a confirmation dialog or opening the editor; rename it whenever needed
• Test an API endpoint before switching, and save or enable a configuration separately
• Edit the Base URL, API Key, Model, Wire API, and complete TOML on the same page
• cc-switch imports report added, updated, merged, and skipped entries; the same URL + Key is no longer shown more than once
• Switching back to OpenAI Official preserves the current official login, and third-party configurations no longer disappear unexpectedly

3. Official Auth management

• Automatically read Codex official auth.json
• View / edit ChatGPT login-state Auth
• Distinguish official Auth from third-party API Keys
• Manage official Auth and third-party Providers in one UI

4. Visual TOML editing

• View the current Codex config.toml
• Dark code preview with syntax highlighting
• Edit full TOML directly from the Provider editor
• Save changes back to the Codex configuration directory

5. Session Management: Inspect, Repair, and Permanently Delete

Find and organize Search sessions by title or project path and group them by project. Internal subagent sessions created automatically by Codex stay out of the normal session list by default.	Inspect and repair Check whether local sessions match the current Provider, repair all mismatches manually, or enable automatic inspection and repair at startup.
Precise deletion Select one session, several sessions, or one or more projects to select all sessions under them. After confirmation, the matching sessions and their derived child sessions are removed from Codex storage itself.

Caution

Permanent deletion cannot be undone. Close any Codex windows or CLI processes still using those sessions, then review the deletion list again in the confirmation dialog.

6. Skills / MCP Management

Manage Codex capability extensions from the Skills & MCP page instead of searching through multiple directories and configuration files.

Skills View current Skills, import existing content, or install from ZIP. Enable / disable entries individually and check whether installed Skills have updates.

MCP Preview existing MCP servers before importing them, then choose what Codex-X should manage. Codex-X maintains the Codex configuration when a server is enabled or disabled.

7. Reverse Skills Navigation

Online guide: explains the “armor breaking” workflow, how to enable GPT-5.5 / unrestricted jeli in Codex-X, and how to combine it with reverse-engineering Skills. Categories: Android APK / Windows EXE / Web protocol reverse engineering. Includes: Skill purpose, install commands, source links, and recommended workflow.

🧩 GPT-5.5 / unrestricted jeli workflow 📱 Android APK reverse Skills 🪟 Windows EXE / DLL reverse Skills 🌐 Web / API / protocol reverse Skills 📋 One-click copy install commands

🚀 Open Codex-X Reverse Skills Guide

8. Cross-platform desktop app

• macOS Apple Silicon .dmg
• macOS Intel .dmg
• Windows .msi
• Windows Portable .zip
• Linux .deb / .rpm / .AppImage
• Automatic GitHub Releases builds
• In-app updates for installed editions; manual updates for Windows Portable

Tech Stack

Category	Technology
Desktop framework	Tauri 2
Frontend	React 18 / TypeScript / Vite
Backend	Rust
Local data	SQLite / rusqlite
Config editing	TOML / JSON
Release	GitHub Actions / GitHub Releases

Configuration Paths

Codex-X reads the Codex configuration directory by default:

~/.codex/config.toml
~/.codex/auth.json

Environment variables are also supported:

CODEX_HOME=/path/to/.codex
CODEXX_HOME=/path/to/codex-x-data
CC_SWITCH_HOME=/path/to/.cc-switch

Codex-X's own database is stored by default at:

~/.codexx/codexx.db

Download

Download from the Releases page:

https://github.com/yynxxxxx/Codex-X/releases

Development

pnpm install
pnpm dev

Build desktop bundles:

pnpm --dir apps/desktop tauri build

Desktop Installation Notes

If you see “app is damaged” when opening an unsigned / unnotarized DMG, this is normal macOS Gatekeeper behavior.

• Best option: sign and notarize with an Apple Developer ID
• Local testing only: remove the quarantine attribute manually

xattr -dr com.apple.quarantine /Applications/Codex-X.app

License

This project is open-sourced under the MIT License.

Thanks

Thanks to the LINUX DO forum community for attention, feedback, and support.

Star History