[开源自荐] Runner：让 Claude Code、Codex、OpenCode 等 CLI agent 组队干活的原生桌面工具

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

- 我的帖子已经打上 开源推广 标签： 是

- 我的开源项目完整开源，无未开源部分： 是

- 我的开源项目已链接认可 LINUX DO 社区： 是

- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

项目地址

Repo：GitHub - yicheng47/runner: Where terminal agents work together. Claude Code, Codex, Copilot CLI and pi on the same task, in one mission, each keeping its own TUI in a real terminal. · GitHub

官网：https://runnersh.dev

下载：Download · Runner

开源协议：MIT

为什么做这个项目

最近经过多个项目的打磨，逐渐形成了一套比较固定的 agent 工作流程。今天在这里分享下自己一直在用的一个小工具 Runner，希望大家能够帮忙尝试看看，给一些好的产品意见，感谢感谢。

Agent Orchestrator 是最近几个月比较火的一类工具，cmux、herdr、orca 等都在解决多 agent 并行时，如何更好地管理这些 agent 的需求。我自己再做一个 Runner，主要还是希望能够更加定制化自己的整个 workflow，让工具和自己的工作方式贴合。

另外也希望能够做一款跨 agent 的协作工具，可以尝试不同平台的 agent 能力，在日常工作中比较简单地切换 runtime，让整个工作流程是 agent agnostic 的，不会被一个大的 AI provider 公司所捆绑。

以下是一些主要的功能：

1. Crew：让几个 agent 一起合作

在 Runner 里面，会先定义一些 role，每个 role 就是一份 agent 配置，再将这些 role 编队组成一个 crew。给 crew 一个具体的任务，就会启动一个 mission，每个成员都有自己的 terminal。

我自己比较常用的是 coder / reviewer 这样的组合：一个负责实现，另一个看 diff 做 review，发现问题以后交回去修改，再做下一轮 review。Claude Code 和 Codex 可以搭在一个队伍里，任务需要的话也可以再加一个 QA 来做验证。

队员之间通过内置的 runner CLI 发消息，过程会展示在 mission 的 feed 里面。需要人来确认的事情，agent 会在 feed 里提问，我回答以后再继续。所以平时可以先让它们跑着，有需要的时候再介入。

现在 mission 启动以后也能增减成员了。比如做到一半觉得需要再加一个 reviewer，就可以从右侧的 Add role 加进去，并给它单独指定任务。单个 agent 的 stop / resume / restart 也都可以单独操作，不需要重建整个任务。

2. 多 agent 的会话管理

不需要组队的时候，也可以直接开一个普通 chat。每个 agent 都跑在真实 PTY 里，自己原来的 TUI、快捷键和工具还可以继续用。

会话用 tab 来管理，一个 tab 里面可以分屏，pane 可以拖动调整，也可以开多个窗口。项目绑定一个工作目录后，在这个目录下开的 chat 和 mission 会归到一起，常用的会话可以置顶。

目前接入了 Claude Code、Codex、Antigravity CLI、GitHub Copilot CLI、pi、Cursor、Grok Build 和 OpenCode v2，直接使用本机安装的 CLI 和自己的账号。Runner 本身不提供模型额度。

另外也做了 Skills 和 MCP 的管理页面，可以查看、编辑支持的配置。部分 CLI 可以在 Settings 里面直接升级，Claude Code、Codex 和 Antigravity 的用量也可以查看，对于有多个 subscription 的用户还是比较方便的。

3. 后台运行和桌面通知

会话跑在后台服务 runnerd 里，退出应用时可以选择 Keep them running，chat 和 mission 就会继续在后台跑。重新打开 Runner 后，会接回原来还在运行的会话。

桌面通知也加上了。Runner 在后台时，chat 需要输入、完成一轮回复或者失败都可以提醒，点击通知回到对应的会话。Settings → Notifications 里可以按事件开关，mission 的通知需要自己打开。

整个应用用 Rust 和 Zed 开源的 GPUI 框架写成，没有 webview，terminal 使用 alacritty_terminal。会话和任务记录都保存在本机，模型请求还是走各个 CLI 自己的服务商。

下载和使用

先安装并登录自己要用的 agent CLI，再安装 Runner。可以先开一个 chat 试一下，后续再配置 role 和 crew，针对队伍发起任务。各个 runtime 的支持程度有一些区别，README 里面有详细的表格。

目前支持 macOS（Apple Silicon）和 Windows x64（Windows 10 1809 及以上），安装包都已签名。Intel Mac、Windows ARM 和 Linux 暂时不支持，有其他平台需求的可以留言。

项目本身的初衷还是为了我自己的使用，也希望这套 workflow 能够对其他人有一些帮助。有问题或者想要的功能，欢迎留言，也欢迎提 issue 或者 PR。

感谢 LINUX DO 社区提供交流与开源推广平台。