Runner
Runner

GitHub stars 下载量 许可证 加入 Runner Discord 微信用户群 macOS 与 Windows 通过爱发电赞助 Runner

English · 简体中文

让终端 agent 协同工作。
Claude Code、Codex、Antigravity CLI、Copilot CLI 和 pi 在同一个 mission 里做同一件事。每个 agent 在真实终端里保留自己的 TUI,Runner 是夹在它们中间的那一层。

官方网站 · 下载 Runner

Runner mission 工作区 — 共享 mission feed 中 @coder 将改动移交给 @reviewer,右侧是实时 crew 会话卡片

演示 · 移动端 · 功能 · Agent · CLI · Crew 示例 · 社区 · 参与贡献

> 原生支持 macOS(Apple Silicon 和 Intel)和 Windows(x64),Linux(ARM64、x86_64)处于 beta 阶段。 Runner 让命令行编码 agent 通过可复用的 crew、真实终端和共享 mission feed 一起工作。会话和历史记录都保存在你的机器上。 ## 演示 从第一次打开开始:设置会找到你的 agent 并组建入门 crew,mission 在真实终端里运行并向你提问,你在侧边栏查看改动,还能在手机上继续跟进。 https://github.com/user-attachments/assets/a45d2440-da17-4be4-8de5-0902f59eb1da ## 移动端 **Runner iOS 版**已开放公开 TestFlight:[通过 TestFlight 加入 →](https://testflight.apple.com/join/CRdfZzmS) 在 iPhone 上查看已配对电脑的实时终端、发起 chat 和 mission,随时回复你的 crew。 > **需要内测资格:** 仅安装 TestFlight 应用目前还无法直接使用——登录并连接电脑需要已获邀请的内测账号,因为中继服务器仍处于内测阶段(目前仅面向中国大陆,海外地区的 Tailscale 支持正在开发中)。[前往官方网站加入内测候补名单 →](https://runnersh.dev/zh-CN/beta/)

Runner iOS 版的项目概览,展示会话和嵌套的 mission    Runner iOS 版的 mission feed,展示等待你回答的 crew 问题    Runner iOS 版的实时 agent 终端与快捷按键

## 功能 - **可复用的 Crew** — 把保存的角色组合成 crew,设定共享的团队约定,按需覆盖各槽位的 agent 和模型配置,随时用同一支团队发起 mission。 - **Mission 与协作** — 每个 mission 为 crew 的各个槽位提供实时终端和共享 feed,agent 在这里协作,需要你决定的问题也会出现在这里。单个槽位可以单独停止、恢复或重启,不影响其他槽位。[架构 →](./docs/arch/arch.md) - **Mission 向 chat 汇报** — 从 chat 启动的 mission 会关联到这个 chat,并在侧边栏归到它下面,agent 可以直接结束这一轮,不用再盯着。mission 需要你处理、失败或进入稳定状态时,Runner 会向 chat 输入一行提示,agent 再去读 mission 发生了什么。[关联聊天与汇报 →](./docs/guide/zh-CN/concepts/missions.md#关联聊天与汇报) - **远程控制** — 在侧边栏切换到另一台电脑,或从 iPhone 连接,操作实时终端、发起 chat 和 mission,随时回复 crew,连接采用端到端加密。由于中继服务器目前处于仅面向中国大陆的内测阶段,远程控制整体仍在内测中;海外用户的 Tailscale 支持正在开发中。[加入内测候补名单 →](https://runnersh.dev/zh-CN/beta/) · [远程访问指南 →](./docs/guide/guides/remote-access.md) - **真实终端** — 每个 agent 都在真实 PTY 里保留自己的 TUI,跑在 GPU 绘制的 `alacritty_terminal` 网格上:鼠标上报、输入法(包括拼音)、文件路径粘贴和点击打开,每个 mission 下面还有一个终端抽屉。 - **分栏与多窗口** — 标签页可以一直分栏到窗口放不下为止,拖动各栏重新排列,把标签页归进文件夹,用 `⇧⌘N` 或 `Ctrl+Shift+N` 打开更多窗口。 - **在 agent 旁边看文件** — 侧面板的 Files 视图显示 agent 所在的 checkout 及其 git 状态,不离开 Runner 就能看清改了什么:代码带语法高亮,Markdown 直接渲染,`⇧⌘O` 按文件名查找,在终端里 `⌘`-点击文件路径即可在对应行打开。[文件指南 →](./docs/guide/zh-CN/guides/chats-and-windows.md#在侧面板中浏览文件) - **`runner` 命令行** — 你的 agent、脚本和终端都能通过 `runner` 命令发起 chat、启动 crew、跟踪 mission,应用关闭时也照样可用(支持 `--json` 输出)。Runner 会为检测到的 agent 安装 skill,让它们也能直接驱动 Runner。[CLI 指南 →](./docs/guide/guides/drive-runner-from-agents.md) - **Runner 关闭后 agent 照样工作** — 会话跑在 Runner 的后台服务 `runnerd` 里。退出应用或者应用崩溃,重新打开后会接回同一批正在运行的终端;停止的 agent 会在下次启动时各自接着原来的对话。 - **在一个地方管理 MCP 服务与技能** — **Settings → MCP** 和 **Settings → Skills** 按 agent 列出它自己的配置,可以按 agent 单独关掉某一项,只改动你碰过的那一条。 - **桌面通知** — agent 需要输入、完成一轮回复或失败时收到通知,点击即可打开对应的 chat 或 mission。在 **Settings → Notifications** 中选择通知事件。 - **项目** — 绑定一次工作目录;在项目里发起的 chat 和 mission 会继承它的 cwd,并在侧边栏里归在一起。 - **浅色与深色** — Runner Light 与 Runner,外加 Catppuccin、Rosé Pine、Tokyo Night、Gruvbox 与 Solarized,为每种模式选择一个主题即可同时设置应用和终端配色。Claude Code 会实时跟着切换。 ## 支持 Runner 如果 Runner 对你有帮助,欢迎赞助项目的持续开发与维护。 - [![通过爱发电赞助 Runner](https://img.shields.io/badge/%E8%B5%9E%E5%8A%A9%20Runner-%E7%88%B1%E5%8F%91%E7%94%B5-946BE7?style=for-the-badge)](https://afdian.com/a/runnersh) — 推荐中国大陆用户使用,通过微信支付或支付宝付款。 - [![通过 Ko-fi 赞助 Runner](https://img.shields.io/badge/%E8%B5%9E%E5%8A%A9%20Runner-Ko--fi-FF5E5B?style=for-the-badge)](https://ko-fi.com/yichengwang) — 推荐海外用户使用,通过 PayPal 付款。 ## 社区 - 加入 [Runner Discord](https://discord.gg/6BrfZdHKNf),交流使用问题、工作流、Bug 和代码贡献。 - Bug 和功能建议:[GitHub Issues](https://github.com/yicheng47/runner/issues)。 - 感谢 [LINUX DO](https://linux.do) 社区提供交流与开源推广平台。 - 扫码加入 Runner 微信用户群,交流使用问题、工作流和反馈。二维码于 2026-11-17 更新,7 天后过期;如果扫码提示失效,请[提一个 issue](https://github.com/yicheng47/runner/issues/new) 提醒我更新。 Runner 微信用户群二维码 ## 支持的 Agent **一级支持:** Claude Code、Codex、Antigravity CLI、Grok Build 和 pi。Runner 针对这些 agent 开发和测试。 **社区支持:** GitHub Copilot CLI、Cursor、OpenCode v2 和 TRAE CLI(按需启用)。它们可以运行聊天和任务,Runner 依靠使用者发现问题,遇到故障请[提交 issue](https://github.com/yicheng47/runner/issues/new)。 各 agent 的功能和平台支持有所不同。 [Agent 安装、功能对比与平台说明 →](./docs/guide/reference/supported-agents.md) ## 示例 Crew 全新安装会预置 **Pair coding crew**:coder 负责实现,reviewer 审查 diff,反复迭代直到审查通过。两个角色默认使用 Codex,也可以分别选择其他 agent。 [组建 Crew 并查看示例提示词 →](./docs/guide/guides/build-a-crew.md) ## 致谢 - **[GPUI](https://github.com/zed-industries/zed/tree/main/crates/gpui)** 与 **[gpui-pre](https://github.com/longbridge/gpui-kit)** — UI 使用 Zed GPU 加速 UI 框架的 crates.io 快照。感谢 Zed 团队构建并开源了 GPUI,感谢 gpui-kit 和 Jason Lee(huacnlee)发布 gpui-pre;Zed 的终端 crate 是 Runner 终端分层的架构参考。 - **[alacritty_terminal](https://github.com/alacritty/alacritty)** — 每一栏底下的终端网格、解析器和回滚。 - **[xterm.js](https://github.com/xtermjs/xterm.js)** — 程序化绘制的制表符字形表按其 MIT 声明转录自 WebGL 插件(`crates/runner-app/LICENSE.xterm`)。 - **[Windows Terminal ConPTY](https://github.com/microsoft/terminal)** — Windows 构建按 MIT 声明内置了微软的 `conpty.dll` 和 `OpenConsole.exe`(`crates/runner-app/LICENSE.conpty`)。 - **[Catppuccin](https://github.com/catppuccin/catppuccin)**(MIT)、**[Rosé Pine](https://github.com/rose-pine/rose-pine-theme)**(MIT)、**[Tokyo Night](https://github.com/folke/tokyonight.nvim)**(Apache-2.0)、**[Gruvbox](https://github.com/morhetz/gruvbox)**(MIT)与 **[Solarized](https://ethanschoonover.com/solarized/)**(MIT)— 内置应用与终端主题(`crates/runner-app/LICENSE.themes`)。 - **[Sparkle](https://sparkle-project.org)** — macOS 的更新器。 ## 作者 Runner 由 **王逸成**(Yicheng Wang / Jason Wang)编写和维护,GitHub 账号 [@yicheng47](https://github.com/yicheng47)。 ## 许可证 MIT。Copyright (c) 2026 Yicheng Wang (Jason Wang)。你可以将 Runner 用于任何用途,包括工作场景和闭源产品,并可自由修改和再分发,只需保留版权声明(见 `LICENSE`)。2026-08-22 至 2026-09-22 期间发布的版本以 GPL-3.0-only 许可证发布,并继续以该许可证提供。