Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验。

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MIT LINUX DO

Codex Pi Claude Code DeepSeek Harness Grok

English

界面预览

Pi、Claude Code、DeepSeek Harness 和 Grok 在同一个 Codex Desktop 中作为独立会话运行。各 Harness 支持的流式输出、思考过程、工具状态、Diff、审批与提问会实时渲染。

Pi 与 Claude Code 在 Codex Desktop 中运行的完整演示

界面

Pi、Claude Code 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

功能状态

能力 Codex Pi Claude Code Grok Build DeepSeek Harness
流式回复 原生
Thinking 原生
工具状态 原生
Edit Diff 原生
提问 / 取消 原生 🚧
Model / Thinking 选择 原生 🚧
工具审批 原生
权限模式 原生
Usage 原生
会话恢复 原生
Thread 管理 原生 🚧 🚧 🚧
Fork 原生
上下文压缩 原生
斜杠命令 原生 🚧 🚧
修订上一条消息 原生 🚧

已支持,🚧 部分支持或开发中, 当前不支持。

快速使用

方式一:使用 npm

npm install -g @codexhost/cli
codexhost

方式二:下载安装包

GitHub Releases 下载最新版安装包,并选择与你的操作系统和 CPU 架构对应的文件。

macOS 安装后,如果首次打开时提示 Apple 无法验证该应用,请在终端执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

然后重新打开 codexhost

怎么做的

多数「多 Agent 客户端」通过 ACP 协议接入不同 Harness。接入快,但工具、审批、权限、Diff、提问等原生能力会先被削平,再在 UI 里补一层近似实现。

CodexHost 尽量不走这条路:

  • Desktop 侧:用 CDP / Electron Inspector 在官方 Codex Desktop 上增强 Agent 选择与会话界面,不重做聊天壳,也不改官方安装包
  • 协议侧:用 CLI Shim 透明接入官方 app-server;Codex 请求原样转发
  • Harness 侧:按各自原生接口接入——Pi 走官方 RPC,Claude Code 走 Agent SDK / CLI——再投影到 Desktop 已有的流式输出、工具、Diff、审批和提问

目标是保真,不只「能聊」。流式、工具状态、可靠 Patch、原生审批和提问,都尽量来自 Harness 自己,而不是 Host 猜测或伪造。

交互展示

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Topics

Resources

Stars

299 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages