Skip to content

About

Codex Cockpit: open-source local Codex workspace, conversation, diagnostics and prompt-management console.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Codex Cockpit

中文 | English

中文

Codex Cockpit 是一个面向本机 Codex Home 的开源管理工具,提供现代化 Web UI、REST/OpenAPI 和 MCP 接口。它可以检查和管理线程、项目、资源、插件状态、备份、导入导出与离线修复流程。

主要能力

  • 浏览全部主线程和子 agent 线程,按项目、状态、存储、Token 与更新时间筛选和排序。
  • 查看线程详情、子线程汇总、每日 Token 时间线、日志和纯净用户 Prompt。
  • 导出 Prompt,可选择是否包含元信息、附件上下文、自动化任务、跨线程委派和空行。
  • 预览后执行线程显示、隐藏、归档、复制、迁移、瘦身、备份与恢复。
  • 管理 AGENTS.md、memory、skills、插件缓存和其他 Codex Home 资源。
  • 从其他 Codex Home 导入线程、项目和资源。
  • 运行只读体检,并生成可直接交给 Codex 的修复 Prompt。
  • 在维护中心按主题查阅修复变更、证据、风险与回滚,核验登记文件指纹并导出决策计划;目录和历史回执不代表当前修复已生效。
  • 通过 REST/OpenAPI 与 MCP 为其他 agent 提供同等能力。

维护接口的参数、返回值及失败边界见 维护中心接口。展示名已改为 Codex Cockpit;应用标识、兼容数据路径、协议、远程仓库与域名保留,避免因改名破坏既有数据发现和升级路径。源码完成不等于安装版或公开站点已更新。

安全模型

  • 本机连接器只监听 loopback,线上页面不能直接读取任意本机文件。
  • 浏览器文件夹模式由用户主动选择目录,并保持只读。
  • 写操作需要短期本机授权、状态绑定的预览票据和运行中 Codex 风险确认。
  • 备份可选;需要备份时默认使用受控备份根目录。
  • 修改 SQLite、全局状态、插件配置或工作区绑定的离线修复必须在 Codex 完全退出后执行。
  • 桌面发行使用 Tauri/NSIS 安装器、内容寻址文件名、SHA-256、Ed25519 分离签名和独立 SPKI 公钥指纹。1.0.34 的 ZIP 包包含安装器,不是免安装版;校验脚本需要 Python 3 和 cryptography,先验签 manifest,再检查大小与 SHA-256。旧连接器的单文件校验器和 CI 构建证明不适用于新版桌面安装器。
  • Authenticode 只有在非自签名证书的公共受信任链验证通过时才标为 valid/public-trusted;自签名和其它不受信任签名必须显式标为不受信任。

本地开发

以下命令从公开 source 分支的仓库根目录执行。要求 Node.js 22 或更高版本、Python 3.12 和 PowerShell 7;桌面开发另需 Rust 和 Windows C++ Build Tools。

cd codex_home_manager
npm ci
python -m pip install --require-hashes --only-binary=:all: -r packaging/windows/requirements-connector.txt
npm run serve

另开一个终端启动前端:

npm run dev

访问 http://127.0.0.1:5173/。完整质量门:

npm run gate

源码完整性和隔离质量验收从仓库根目录执行:

python -B scripts/export_codex_home_manager_source.py verify --source . --run-gate

Windows 桌面封装使用受管构建入口 scripts/build_home_manager_guarded.py,冻结前端和资源后再生成 NSIS 安装器。旧 package-local-connector.ps1 仍用于独立 Python 连接器,不能用其产物替代桌面程序。1.0.34 的签名 manifest 明确记录本机 Tauri 构建与隔离源码验收,不声称安装器来自 GitHub CI,也不声称字节级可复现。源码发布快照包含打包后的发行工具调整,运行资源与安装器各自绑定冻结哈希。

English

Codex Cockpit is an open-source local management console for Codex Home. It provides a modern Web UI, REST/OpenAPI endpoints, and MCP tools for threads, projects, resources, diagnostics, backups, import/export, and guarded offline repair.

The local connector is loopback-only. Browser folder mode is user-selected and read-only. State-changing operations require short-lived local authorization and state-bound previews. Release artifacts are content-addressed and verified with SHA-256 plus detached Ed25519 signatures.

See CONTRIBUTING.md for development requirements and SECURITY.md for vulnerability reporting.

License

MIT. See LICENSE.

About

Codex Cockpit: open-source local Codex workspace, conversation, diagnostics and prompt-management console.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages