# 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.

version

--- ## 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 - Save, test, and switch between OpenAI Official and third-party APIs, including Providers imported 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 ## Preview

App preview: Home / Provider / TOML / Auth

Codex-X 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?}
SQL injection testing result

NSFW Response Test
_{Observe boundary response changes after prompt injection}
NSFW response test result

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, test, and enable multiple third-party Providers, or import them from cc-switch; entries with the same endpoint and Key are merged automatically. Create or reopen a session after switching to apply the change without restarting the entire Codex client.
💬 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 the active Codex `config.toml` and `auth.json` in one place, with a clear distinction between official login credentials and third-party API Keys. Important writes are backed up automatically and can be restored when needed.
📦 Use it across platforms	Available for macOS Apple Silicon / Intel, Windows installer / portable, and Linux packages. Check GitHub Releases from inside the app and open the download page when a new version is available.

## Highlights ### 1. Prompt Template Center

> [!TIP] > **Ready after installation, automatically expanded when online.** > > The app bundle includes 3 baseline templates for offline use. Opening the **Prompt** page automatically syncs 2 additional templates from GitHub `examples/`, bringing the current total to 5. Once a remote template has synced successfully, it is cached locally and remains 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	GitHub sync
`海鸥3.0破甲.md`	A Chinese technical-operator persona with routing for coding, CTF, reverse engineering, memory, and protocol work	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 third-party Providers and always see which one is currently active - 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` - Automatic GitHub Releases builds - In-app update checking ## 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: ```text ~/.codex/config.toml ~/.codex/auth.json ``` Environment variables are also supported: ```text 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: ```text ~/.codexx/codexx.db ``` ## Download Download from the Releases page: https://github.com/yynxxxxx/Codex-X/releases ## Development ```bash pnpm install pnpm dev ``` Build desktop bundles: ```bash pnpm --dir apps/desktop tauri build ``` ## macOS Installation Note 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 ```bash xattr -dr com.apple.quarantine /Applications/Codex-X.app ``` ## License This project is open-sourced under the [MIT License](https://github.com/yynxxxxx/Codex-X/blob/main/LICENSE). ## Thanks Thanks to the [LINUX DO forum](https://linux.do/) community for attention, feedback, and support. ## Star History