GRepoWatch
Daily at 07:00 UTC+8Subscribe中文
← Back to today’s ranking

yynxxxxx /

Codex-X

Explore the repository, its official documentation and the recorded Trending history.

Visit GitHub repository ↗
Last recorded · 2026-09-22#12

Rank in that snapshot

+79Daily Stars3,660Total Stars

Project overview

Explore the repository, its official documentation and the recorded Trending history.

Recorded Trending signals

yynxxxxx/Codex-X was recorded 2 times between 2026-09-20 and 2026-09-22. Its best recorded rank is #12. The latest saved snapshot reports 79 daily Stars and 3,660 total Stars. These are archive observations, not quality ratings or continuous activity measurements.

Official project documentation

The following is an excerpt from the project’s official README, fetched from GitHub. It may change independently of this archive. RepoWatch has not installed or functionally tested this project.

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 — View this section in the official README →

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 doHow Codex-X helps
🧩 Use prompt templatesThe 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 / relaysSave 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 sessionsSearch 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 / MCPView 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 loginInspect 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 usageSwitch 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 platformsAvailable 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.

TemplateBest forAvailability
gpt5.5-unrestricted.mdCompact and general-purpose for everyday coding and technical workBundled offline
GitHub updates
gpt5.4-unrestricted.mdGPT-5.4 / Codex CLI workflows with a CTF and security-research focusBundled offline
GitHub updates
gpt5.5-jeli.mdA plain-language general version with a fuller engineering and reverse-engineering workflowBundled offline
GitHub updates
gpt-5.6-sol-unrestricted.mdA GPT-5.6 SOL prompt focused on direct execution and bilingual tasksBundled offline
GitHub updates
海鸥3.0破甲.mdA Chinese technical-operator persona with routing for coding, CTF, reverse engineering, memory, and protocol workBundled offline
GitHub updates
software-development-maintainer.mdLong-term maintenance with reuse, minimal changes, safety, testing, and maintainabilityGitHub sync
software-development-debugging.mdEvidence-driven debugging from reliable reproduction to root-cause repair and regression checksGitHub sync
software-development-code-review.mdSeverity-ranked review of defects, regressions, security risks, and test gapsGitHub sync
writing-clarity-editor.mdChinese and English editing that preserves the author's meaning and factsGitHub sync
writing-technical-docs.mdSource-grounded README, guide, API, architecture, and release documentationGitHub sync
writing-structured-draft.mdTurns scattered material into a structured report, proposal, retrospective, or article draftGitHub 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

Session lists prefer saved display names and show the first prompt on hover. Windows can browse and export WSL sessions in read-only mode; see the WSL session guide for requirements and limits.

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

CategoryTechnology
Desktop frameworkTauri 2
FrontendReact 18 / TypeScript / Vite
BackendRust
Local dataSQLite / rusqlite
Config editingTOML / JSON
ReleaseGitHub 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