Codex-X README

The project's README from github.com/yynxxxxx/Codex-X. As one markdown file: README.md.

中文 English

Codex-X Logo

Codex-X

Codex 可视化提示词注入 · Provider · 会话 · Skills / MCP 管理工具

一款面向 OpenAI Codex 桌面端 / Codex CLI 的跨平台桌面工具。把提示词模板、自定义 Prompt、第三方 API 供应商、会话同步、Skills / MCP 和 TOML 配置都放进可视化界面里,不用反复手改文件。

version platform tauri license


Codex-X 是什么?

当你同时使用 Codex 桌面端、CLI、第三方 API、Skills / MCP 和多套提示词时,配置很容易散落在不同文件里。Codex-X 把这些高频操作集中到一个桌面界面中,让当前状态看得见、常用操作点一下就能完成。

你可以用它:

软件预览

新版 UI:指令提示词管理中心

Codex-X 新版指令提示词管理界面

分类管理
把提示词按破甲 / 逆向、软件开发、写作辅助等分类维护
Codex-X 提示词分类管理
自定义提示词
直接添加、编辑或导入自己的 Markdown 提示词
Codex-X 添加自定义提示词
Skills / MCP 可视化管理

Codex-X Skills 与 MCP 管理界面

功能特性

你想做的事 Codex-X 能帮你
提示词注入管理 内置 5 套提示词模板,支持分类、GitHub 同步、本地缓存、导入 .md、添加自定义提示词、编辑说明、一键启用 / 禁用。
启用方式切换 可选择“保留原提示词”追加写入,也可选择“替换原提示词”完整切换;适合在不同模型、不同任务、不同 Prompt 之间快速切换。
Provider / API 保存多个可命名的官方 Codex 登录配置,与第三方供应商统一管理、一键复制和切换;第三方供应商支持连接检测、模型获取 / 测试及从 cc-switch 导入。
会话管理 搜索本地会话、按项目路径分组、同步当前供应商、检查会话状态,并支持单选 / 多选 / 项目级永久删除。
Skills / MCP 可视化查看 Skills 与 MCP,导入已有配置,从 ZIP 安装 Skill,逐项启用 / 禁用,并检查更新状态。
配置与登录 集中查看 config.toml 与 auth.json;官方登录和第三方供应商编辑页均可在 config.toml 旁勾选“开启 1M 上下文窗口”,保存后生效,需模型支持;重要写入前自动备份。
用量统计 设置页提供“通用设置 / 用量统计”标签,按日期与模型筛选本地 Token 用量,查看每日趋势、缓存命中率、模型分布及最近 10 个主会话;子代理用量归入所属主会话,不单独计为会话。
跨平台使用 提供 macOS Apple Silicon / Intel、Windows EXE / 便携版和 Linux 安装包;安装版可在应用内直接下载、校验并安装更新,便携版继续使用手动下载。

核心亮点

1. 可视化提示词注入中心

当前模板库 11 套 离线内置 5 套 GitHub 自动同步 支持自定义提示词

[!TIP] 安装后就能用,联网后自动补齐,也能维护自己的提示词库。

安装包离线自带 5 套模板;软件启动后会从 GitHub examples/ 同步另外 6 套软件开发与写作辅助模板,以及后续更新。同步成功的在线版本会缓存到本地,临时离线仍可继续使用。你也可以导入自己的 .md、新增分类、编辑说明,并像切换插件一样启用或禁用任意提示词。

Codex-X 现在不只是“几套内置 Prompt”的启动器,而是一个可视化提示词注入与管理工具:

模板 适合场景 获取方式
gpt5.5-unrestricted.md 短小通用,适合日常 coding 与常规技术任务 离线内置
GitHub 更新
gpt5.4-unrestricted.md 面向 GPT-5.4 / Codex CLI,偏 CTF 与安全研究工作流 离线内置
GitHub 更新
gpt5.5-jeli.md 大白话通用版,提供更完整的工程与逆向执行流程 离线内置
GitHub 更新
gpt-5.6-sol-unrestricted.md gpt5.6-sol 破甲提示词,偏直接执行与中英文任务 离线内置
GitHub 更新
海鸥3.0破甲.md 中文技术操作员人格,覆盖 coding、CTF、逆向、内存与协议任务路由 离线内置
GitHub 更新
software-development-maintainer.md 长期维护正式项目,强调复用、最小改动、安全、测试与可维护性 GitHub 在线同步
software-development-debugging.md 从稳定复现和证据采集推进到根因修复与回归验证 GitHub 在线同步
software-development-code-review.md 按严重级别审查缺陷、回归、安全风险和测试缺口 GitHub 在线同步
writing-clarity-editor.md 在保留原意和事实的前提下润色中英文表达 GitHub 在线同步
writing-technical-docs.md 基于代码与事实编写 README、指南、API 和发布文档 GitHub 在线同步
writing-structured-draft.md 将零散材料组织成报告、方案、复盘或文章初稿 GitHub 在线同步
保留原提示词
适合已经有个人规则的用户。Codex-X 只追加自己管理的内容,禁用时也只移除这一部分,不动原有提示词。
替换原提示词
将所选模板设为当前主要指令入口,适合希望完整切换到某套模板的用户。

每次启用或禁用前都会自动创建备份。除了模板库,你也可以导入、编辑、删除自己的 .md 提示词,并通过分类管理把常用提示词整理成自己的工作流。

[!NOTE] 如果你有好用的提示词模板,欢迎在 Issues 提交:请附上模板名称、适用场景、Markdown 内容、推荐启用方式和必要说明。合适的模板会考虑收录到 examples/,让更多用户可以一键同步使用。

2. Provider / API:添加、检测、获取模型、随时切换

[!NOTE] 启用新的第三方供应商后,新建或重新打开 Codex 会话即可使用新的中转,不需要重启整个 Codex 客户端。

3. 会话管理:同步、检查与永久删除

同步和检查
检查本地会话是否和当前 Provider / 模型一致,需要时一键同步到当前供应商配置,不修改聊天内容。
查找和整理
按标题、项目路径、供应商或 ID 搜索会话,也可以按项目路径分组查看,适合清理长期使用后积累的会话列表。
精确删除
支持单选、多选,也可以勾选一个或多个项目,一次选中项目下的全部会话;确认后会从 Codex 自身存储中删除对应会话及其派生子会话。

[!CAUTION] 永久删除不可恢复。 删除前请先关闭仍在使用这些会话的 Codex 窗口或 CLI,并在确认窗口中再次核对待删除列表。

4. Skills / MCP 管理

在【技能和 MCP】页面集中管理 Codex 的能力扩展,不必再到多个目录和配置文件中逐项查找。

Skills
查看当前 Skill,导入已有内容或从 ZIP 安装;可以逐项启用 / 禁用,并检查已安装 Skill 是否有更新。
MCP
导入前先预览现有 MCP Server,再决定哪些需要纳管;启用或禁用后由 Codex-X 自动维护 Codex 配置。

5. TOML 与官方 Auth 管理

6. 逆向 Skills 导航

Codex-X 在线逆向 Skills 导航

在线教程页:解释什么是“破甲”、Codex-X 如何启用 GPT-5.5 / unrestricted jeli、以及如何搭配不同领域的逆向 Skills。

分类覆盖:Android APK / Windows EXE / Web 协议逆向。

内容包含:Skill 用途、安装方式、来源地址、推荐使用流程。
  • 🧩 GPT-5.5 / unrestricted jeli 使用流程
  • 📱 Android APK 逆向 Skills
  • 🪟 Windows EXE / DLL 逆向 Skills
  • 🌐 Web / API / 协议逆向 Skills
  • 📋 安装命令一键复制

🚀 打开 Codex-X 逆向 Skills 导航

7. 跨平台桌面软件

技术栈

类型 技术
桌面框架 Tauri 2
前端 React 18 / TypeScript / Vite
后端 Rust
本地数据 SQLite / rusqlite
配置编辑 TOML / JSON
发布 GitHub Actions / GitHub Releases

配置路径

Codex-X 默认读取 Codex 配置目录:

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

也支持环境变量:

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

Codex-X 自身数据库默认位于:

~/.codexx/codexx.db

下载

请前往 Releases 页面下载:

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

开发运行

pnpm install
pnpm dev

构建桌面端:

pnpm --dir apps/desktop tauri build

桌面端安装说明

如果你在未签名 / 未公证的 DMG 中看到“软件已损坏”提示,这是 macOS Gatekeeper 的正常行为。

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

许可证

本项目基于 MIT License 开源。

致谢 / Thanks

感谢 LINUX DO 论坛 社区的关注、反馈与支持。

Star History

Codex-X Star History


[!IMPORTANT] 使用声明

本项目仅用于大模型与智能体相关技术的学习、研究与交流,软件本身不包含主动破坏性功能。请在合法、合规并获得授权的范围内使用,禁止将其用于攻击、侵害他人权益或其他违法用途。使用者应自行判断使用边界,并对相关行为与后果承担责任。

Codex-X (yynxxxxx/Codex-X)

Searching Database…

4.2K ·GitHub
What is this?Codex-X is a cross-platform desktop app that gives OpenAI Codex (desktop app and CLI) a visual control panel: it centralizes prompt injection templates, provider/API switching, session syncing, Skills/MCP management, and TOML config editing so you don't have to hand-edit config files.
Is Codex-X a replacement for Codex, or a management layer on top of it?It's not Codex itself - it's a separate Tauri desktop app that reads and writes Codex's own config.toml and auth.json files, acting as a GUI front-end for settings you'd otherwise edit by hand.
How do I install Codex-X?Grab a prebuilt package from the GitHub Releases page: macOS .dmg (Apple Silicon or Intel), Windows .exe installer or portable .zip, or Linux .deb/.rpm/.AppImage; installed builds can also auto-update from inside the app.
Do I need Codex itself already set up?Yes - Codex-X manages an existing OpenAI Codex installation; it reads your Codex config directory and official auth.json rather than providing Codex functionality on its own.
Any install pitfalls I should know about?On macOS, unsigned/non-notarized DMG builds trigger Gatekeeper's standard 'app is damaged' warning; you either need an Apple Developer ID signed/notarized build or must manually remove the quarantine attribute for local testing.
What prompt templates come built in?Codex-X ships 5 offline Markdown prompt templates (including unrestricted/jailbreak-style and CTF-oriented ones) and syncs 6 more software-development and writing templates from GitHub; each can be toggled on individually and either appended to or used to replace your existing Codex instructions.
Can I bring in my existing third-party API providers from cc-switch?Yes, Codex-X can import providers from cc-switch, automatically sorting them into new, updated, merged, or skipped entries and deduplicating by matching URL plus API key.
Is session deletion reversible?No - the README explicitly warns that permanent deletion cannot be undone, and recommends closing any Codex windows or CLI sessions still using those sessions before confirming.
What is the reverse-engineering Skills navigator?It's an in-app page explaining how to enable the 'unrestricted jeli' prompt mode and linking to categorized Skills for Android APK, Windows EXE/DLL, and Web/API/protocol reverse engineering, intended for authorized security research per the project's usage disclaimer.
Creator
yynxxxxx
Size
12.8 MB
Stars
4.2K
Age
3mo
Commits · 90 Days