muzimu
e2b5c67a17
后端 (lib.rs):
- test_provider_connection 由探测 GET /models 改为向 {base}/responses 发送
最小模型请求 (content: "hi")，依据返回状态判断连通性与模型可用性，
对齐 new-api channel 测试逻辑；删除不再使用的 provider_test_request
- 命令新增 model 参数；端点跟随 Codex 约定拼 {base}/responses
(base_url 应含 /v1)，超时调整为 20s
- 失败时补全错误详情: HTTP 错误读取响应体提取上游信息 (extract_upstream_error:
优先 JSON error.message/error/message，HTML 跳过)，网络层错误展示 {e}
- 为 HTTP 404 增加"端点不存在，请确认 base_url 是否包含 /v1"诊断提示
前端 (main.tsx):
- 添加供应商表单新增"测试连通性"按钮，列表与表单共用 testProvider 入口 (DRY)
- testProvider 透传 model 至后端；前置 http/https 校验
- 新增 isHttpBaseUrl 工具函数，保存供应商与测试前校验 API 请求地址必须以
http:// 或 https:// 开头
- 修复测试失败时 toast 仍显示 ✅: toast 改为 {text, kind} 结构，失败走
setToastError 显示 AlertCircle 图标；保留 setToast(string) 兼容现有调用，
统一列表/表单测试按钮措辞为"测试连通性"
- 移除已废弃的 wire_api="chat" 选项与分支，wireApi 统一固定为 "responses"
(Codex 新版仅支持 responses)
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 - 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
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, 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. |
|
🚀 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:
~/.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
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
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
