Codex-X: A desktop hub for Codex prompts, providers, and sessions
For Codex desktop and CLI users, it puts prompts, providers, sessions, and MCP in one interface.
GitHub yynxxxxx/Codex-X Updated 2026-09-20 Branch main Stars 3.4K Forks 446
Tauri 2 React 18 Rust Codex CLI SQLite macOS/Windows/Linux

🧭 Decision Guide

Try it if you

  • You maintain Codex desktop, Codex CLI, and multiple third-party API providers at the same time.
    The README sections “What is Codex-X?” and “Provider / API” describe unified management and one-click switching for official logins and third-party providers.
  • You need to organize Markdown prompts under categories such as reverse engineering, software development, and writing assistance.
    The README section “Visual Prompt Injection Center” lists categorization, Markdown import, custom editing, and enable/disable controls.
  • You need to migrate providers from cc-switch and test connections and available models.
    The README section “Provider / API: Add, Check, Fetch Models, and Switch Anytime” explicitly supports cc-switch import, connection checks, and model fetching.
  • You need to manage Skills, MCP, and Codex configuration files on macOS, Windows, or Linux.
    The README sections “Skills / MCP Management,” “TOML and Official Auth Management,” and “Cross-platform Desktop Software” list these functions and packages.

Skip it if you

  • You need to restore Codex sessions after deletion.
    The README section “Session Management” warns that permanent deletion cannot be undone and removes sessions and derived child sessions from Codex storage.
  • Your model does not support a 1M context window but you expect enabling the option to provide one automatically.
    The README section “Configuration and Login” states that the 1M context window requires model support.
  • You require the macOS installer to be signed and notarized.
    The README section “Desktop Installation” says unsigned or unnotarized DMGs may trigger Gatekeeper warnings and lists signing and notarization as the best approach.
  • You only want a command-line tool and do not need a Tauri 2 desktop interface.
    The README describes Codex-X as a cross-platform desktop tool and provides Tauri 2, desktop packages, and visual management pages.

Requirements

  • Development requires the README commands “pnpm install” and “pnpm dev”.
  • By default, it reads “~/.codex/config.toml” and “~/.codex/auth.json”.
  • The Codex configuration directory can be set with “CODEX_HOME=/path/to/.codex”.
  • macOS provides Apple Silicon and Intel “.dmg” packages; Windows provides “.msi” and “.zip”; Linux provides “.deb”, “.rpm”, and “.AppImage”.
  • The “1M context window” can be enabled only when the model supports it.

First step (verbatim from README)

pnpm install

Watch out

  • Close Codex windows or CLI processes still using sessions before deletion.
    The CAUTION in the README’s “Session Management” section says permanent deletion cannot be undone and requires closing related Codex windows or CLI processes.
  • An unsigned DMG may show “the application is damaged” on macOS.
    The README’s “Desktop Installation” section explains the Gatekeeper behavior and provides the xattr command.
  • After enabling a provider, create or reopen a Codex session to use the new relay.
    The README’s “Provider / API” section says a full Codex client restart is unnecessary, but a new or reopened session is required.
  • Replacing the original prompt switches the instruction entry point completely rather than appending existing rules.
    The README’s “Visual Prompt Injection Center” distinguishes “preserve original prompt” from “replace original prompt” modes.

Not stated in the README

  • The README does not explain encryption or access control for API keys, auth.json, or config.toml in the local database.
  • The README does not specify supported Codex desktop or Codex CLI version ranges.
  • The README does not describe how invalid API keys or sensitive fields are handled during cc-switch import.
  • The README does not specify update signature verification, rollback behavior, or package-source validation for in-app updates.
  • The README does not describe SQLite migration, corruption recovery, or cross-device synchronization.
  • The README does not specify Linux distribution and desktop-environment compatibility for Tauri 2 packages.

💡 Deep Analysis

6
No I need to distribute Codex providers and Skills to multiple people, with access control, operation auditing, centralized secret management, and collaboration. Can Codex-X serve as a team-level console?
For: A technical lead who needs shared configuration, centralized API-key management, operation auditing, and enterprise-wide Codex configuration distribution

No, not as a team-level console, because the project is a single-machine local management tool rather than a centralized governance platform.

  • The project insights explicitly state that the README does not show access control, centralized configuration distribution, auditing, multi-user collaboration, or enterprise secret management.
  • The README section “配置路径” uses local paths such as ~/.codex and ~/.codexx/codexx.db, with CODEX_HOME, CODEXX_HOME, and CC_SWITCH_HOME for local data-location changes.
  • Provider entries contain API Keys, while Skills, MCP, and prompts are imported, enabled, disabled, or written directly on the local machine; this is not an approval or policy system.
  • Automatic backups are created before important writes, but they do not replace secret management, audit logs, or disaster recovery.

It can serve as each member’s personal workstation, but the organization still needs separate systems for secret storage, configuration approval, version control, and operation auditing.

  • Project insights “usage_limitations”: no shown access control, centralized distribution, auditing, multi-user collaboration, or enterprise secret management
  • README “配置路径”: `~/.codex/config.toml`, `~/.codex/auth.json`, and `~/.codexx/codexx.db`
  • README “配置路径”: supports `CODEX_HOME`, `CODEXX_HOME`, and `CC_SWITCH_HOME`
  • Project insights “best_practices”: teams need separate secret management, approval, version-control, and audit systems
Not stated in the README:The README does not say whether remote synchronization, organization accounts, RBAC, audit logs, or centralized policy APIs exist.;The README does not say whether the local database and backup files support encryption or enterprise key management.
Yes I have accumulated many local Codex CLI sessions across multiple project paths. I need to search by title, project path, provider, or ID and bulk-delete histories for selected projects. Is Codex-X suitable for this cleanup work?
For: A Codex CLI user with a large local session history who organizes records by project path and needs to bulk-clean closed projects

Yes, because the README explicitly provides project organization, status checking, and project-level bulk deletion. However, deletion is permanent and should not be treated as ordinary list cleanup.

  • “会话管理” supports searching by title, project path, provider, or ID, and grouping sessions by project path for long-term history management.
  • It can check whether sessions match the current Provider / Model and synchronize them to the current provider configuration when needed, without changing chat content.
  • Deletion supports single selection, multi-selection, and project-level selection, including deletion of corresponding derived child sessions from Codex storage.
  • The README warning requires closing Codex windows or CLI processes still using those sessions and reviewing the confirmation list; deletion cannot be recovered.

It is therefore suitable for local cleanup with clear project boundaries, but the README does not mention a recycle bin, export function, or cross-device session synchronization.

  • README “会话管理:同步、检查与永久删除”: search by title, project path, provider, or ID and group by project path
  • README “会话管理”: checks session consistency with the current Provider / model and can synchronize it
  • README “精确删除”: supports single, multiple, and project-level permanent deletion, including derived child sessions
  • README warning: deletion is irreversible and active Codex windows or CLI processes must be closed first
Not stated in the README:The README does not specify the session-index scan scope, refresh mechanism, or performance with very large session libraries.;The README does not say whether session export, a recycle bin, or automatic archiving before deletion is supported.
Yes I use both the Codex desktop app and CLI. I need to store multiple official logins, third-party APIs, Base URLs, Models, and Wire APIs, and switch providers frequently. Is Codex-X suitable for managing my local configuration?
For: A developer who uses both the Codex desktop app and Codex CLI and switches among OpenAI Official login and multiple third-party API providers

Yes, because it is specifically designed as a local management layer for multiple Codex configurations and provider switching.

  • The README section “Provider / API” supports multiple named OpenAI Codex logins and third-party providers, including copy, switching, connection checks, and model retrieval.
  • The editor covers Base URL, API Key, Model, Wire API, and complete TOML, which is useful for configurations more complex than a single environment variable.
  • Import from cc-switch distinguishes new, updated, merged, and skipped entries, while identical URL + Key combinations are not duplicated.
  • After enabling a third-party provider, creating or reopening a Codex session is sufficient; restarting the entire Codex client is not required.

However, it edits the real config.toml and auth.json. The README does not promise long-term format compatibility across Codex versions or full compatibility of every Codex capability with third-party providers.

  • README “Provider / API”: supports multiple named OpenAI Codex logins and third-party providers
  • README “Provider / API”: supports Base URL, API Key, Model, Wire API, and complete TOML
  • README “Provider / API”: cc-switch import distinguishes new, updated, merged, and skipped entries
  • README “Provider / API”: creating or reopening a Codex session is sufficient after enabling a new relay
pnpm install
Not stated in the README:The README does not specify which Codex versions and configuration formats are supported.;The README does not define the compatibility boundaries of each third-party Wire API for tool calls, streaming, or other Codex capabilities.
It depends I mainly work on Android APK, Windows EXE/DLL, and Web/API protocol reverse engineering. I want to install ZIP Skills, enable or disable MCP servers, and use GPT-5.5 / unrestricted jeli prompt guidance. Is Codex-X suitable for this workflow?
For: A CTF researcher working on Android APK, Windows EXE/DLL, and Web/API protocol reverse engineering who wants to organize Codex workflows with Skills, MCP, and prompt navigation

It depends. The feature set matches reverse-engineering and CTF workflows, but suitability depends on the sources of Skills and MCP configurations and whether the research is authorized.

  • The README section “逆向 Skills 导航” covers Android APK, Windows EXE / DLL, and Web / API / protocol reverse engineering, including Skill purposes, sources, installation methods, and recommended workflows.
  • The “Skills / MCP” page supports viewing, importing, ZIP installation, per-item enable/disable, and update checks for Skills; MCP servers can be previewed before import.
  • The prompt library includes gpt5.4-unrestricted.md, gpt5.5-jeli.md, and 海鸥3.0破甲.md, covering CTF, reverse engineering, memory, and protocol task routing.
  • However, the project statement limits use to learning, research, and communication and prohibits attacks or harm. Remote GitHub prompts, Skills, and MCP also introduce supply-chain and credential risks.

It is a reasonable fit for authorized labs or personal test targets, but should not be directly used against unauthorized targets, production systems, or high-compliance environments.

  • README “逆向 Skills 导航”: covers Android APK, Windows EXE / DLL, and Web / API / protocol reverse engineering
  • README “Skills / MCP 管理”: supports ZIP Skill installation, per-item enable/disable, update checks, and MCP preview before import
  • README “可视化提示词注入中心”: includes `gpt5.4-unrestricted.md`, `gpt5.5-jeli.md`, and `海鸥3.0破甲.md`
  • README “使用声明”: limited to learning, research, and communication; attacks, harm, and unlawful use are prohibited
Not stated in the README:The README does not document a security audit of every third-party Skill, MCP server, or remote prompt referenced by the navigation.;The README does not say that Codex-X provides reverse-engineering tools, debuggers, or APK/PE analysis environments.
Yes I maintain prompts for GPT-5.4 / Codex CLI, GPT-5.5, and gpt5.6-sol, and switch among software development, code review, writing, and reverse-engineering tasks. Can Codex-X replace my manual Markdown and instruction-file editing?
For: An advanced Codex user maintaining GPT-5.4 / Codex CLI, GPT-5.5, and gpt5.6-sol prompts while switching among software development, code review, and reverse-engineering tasks

Yes, especially if you want to turn multiple Markdown prompts into a categorized local library with independent enable/disable controls. However, model compatibility should not be interpreted as having been fully validated by the project.

  • The README section “可视化提示词注入中心” lists gpt5.4-unrestricted.md, gpt5.5-unrestricted.md, gpt5.5-jeli.md, and gpt-5.6-sol-unrestricted.md, covering coding, CTF, security research, and reverse-engineering workflows.
  • It also includes software-development-maintainer.md, software-development-debugging.md, software-development-code-review.md, and writing templates for switching task types.
  • Templates support Markdown import, categorization, description editing, independent enable/disable, GitHub synchronization, and local caching.
  • “Retain original prompt” appends Codex-X content, while “Replace original prompt” changes the primary instruction entry point; a backup is created before each enable or disable action.

The 1M context-window option only matters when the underlying model supports it. The README does not guarantee identical behavior across every provider or model.

  • README “可视化提示词注入中心”: lists `gpt5.4-unrestricted.md`, `gpt5.5-unrestricted.md`, `gpt5.5-jeli.md`, and `gpt-5.6-sol-unrestricted.md`
  • README “可视化提示词注入中心”: supports Markdown import, categories, GitHub sync, local caching, and independent enable/disable
  • README “启用方式切换”: supports retaining or replacing the original prompt
  • README “配置与登录”: enabling the 1M context window requires model support
pnpm install
Not stated in the README:The README does not describe behavioral differences for the same prompt across models.;The README does not describe conflict detection, precedence rules, or maximum instruction-file length when multiple templates are enabled.
It depends I work across macOS Apple Silicon and Windows environments without guaranteed installation privileges. I need the Windows Portable build and would prefer in-app updates. Does Codex-X’s cross-platform distribution meet this constraint?
For: An individual developer switching between macOS Apple Silicon and Windows Portable who cannot rely on administrator privileges and wants in-app Codex-X updates

It depends. The available packages cover your platforms, but Windows Portable and installed builds use different update paths, and macOS may encounter Gatekeeper restrictions for unsigned DMGs.

  • The README section “跨平台使用” provides macOS Apple Silicon .dmg, Windows .msi, and Windows Portable .zip packages, so both platforms have corresponding releases.
  • Installed builds can download, verify, and install updates in the application. The README explicitly states that Windows Portable continues to require manual downloads.
  • An unsigned or unnotarized macOS DMG may be marked as damaged by Gatekeeper; the documented local-testing workaround removes the quarantine attribute.
  • Project data shows the latest release is v0.3.20 with 5 releases. This confirms active packaging, but not long-term cross-platform compatibility.

If Windows must remain installation-free, manual updates are required. If your organization prohibits removing quarantine or running unnotarized applications, the macOS constraint is not satisfied.

  • README “跨平台使用”: macOS Apple Silicon `.dmg`, Windows `.msi`, and Windows Portable `.zip`
  • README “跨平台使用”: installed builds support in-app download, verification, and installation; portable builds require manual downloads
  • README “桌面端安装说明”: unsigned or unnotarized DMGs may be marked as damaged by macOS Gatekeeper
  • Project data: latest release is v0.3.20 and release_count is 5
xattr -dr com.apple.quarantine /Applications/Codex-X.app
Not stated in the README:The README does not say whether Windows Portable writes to administrator-restricted directories or registers system-level components.;The README does not say whether in-app updates support major-version rollback, offline updates, or enterprise proxy networks.

✨ Highlights

  • Includes 5 prompts and GitHub template synchronization
  • Providers support connection checks, model fetching, and cc-switch import
  • Centralizes Skills, MCP, config.toml, and auth.json management
  • Provides packages for macOS, Windows, and Linux

🔧 Engineering

  • Manage prompt categories, Markdown imports, and activation states visually
  • Switch official Codex logins, third-party APIs, and model settings centrally
  • Search, synchronize, inspect, and delete Codex sessions by project path
  • Built with Tauri 2, React 18, Rust, and SQLite

⚠️ Risks

  • Permanent session deletion is irreversible; Codex windows or CLI should be closed
  • Unsigned DMGs may trigger macOS Gatekeeper's damaged-app warning
  • The 1M context window works only when the model supports it
  • Switching a third-party provider requires creating or reopening a Codex session

👥 For who?

  • Developers using Codex desktop, CLI, and multiple providers
  • Codex users who need to manage Skills, MCP, and config.toml
  • Individual developers and small teams on macOS, Windows, or Linux