yicheng47/runner

Runner – AI 编码代理的原生桌面中心

它是什么 Runner 是一款 macOS 和 Windows 原生应用，可让您在真实终端窗格中并排运行多个 AI 驱动的编码助手（Claude Code、Codex、Antigravity CLI、GitHub Copilot CLI、pi 等）。它将那些代理组织成 团队（可复用的角色集合），共享任务源，通过类似聊天的界面进行协调，并且即使 UI 关闭，也能保持各自的 PTY 会话存活。

主要功能

功能	您获得什么
可复用团队	保存一组角色（例如，编码员、审查员、QA），并指定负责人和共享约定；一键在任何项目上启动同一团队。
任务与协调	实时任务源显示来自每个团队槽位的消息，让代理向您提问，并允许您暂停、恢复或重启单个槽位，而不影响其他槽位。
真实终端	每个代理都在由 alacritty_terminal 网格支持的自己的 PTY 中运行，支持鼠标、IME 输入、文件路径点击以及每个聊天下方的 shell 抽屉。
分屏标签页和窗口	拖放窗格，任意分割标签页，将标签页分组到文件夹中，并打开额外窗口（⌘⇧N / Ctrl+Shift+N）。
桌面通知	当代理需要输入、完成一轮或失败时，获取操作系统通知；点击直接跳转到相关聊天或任务。
后台服务（runnerd）	会话在守护进程中持久化；关闭 UI 或崩溃后，您的终端会从上次停止的地方恢复。
MCP 服务器和技能窗格	集中查看每个代理的配置，带有每个代理的开关、版本显示和一键更新器。
项目	绑定一次工作目录；所有在该目录中启动的聊天和任务都继承 cwd，并一起出现在侧边栏中。
主题	浅色、深色和 Catppuccin 调色板；UI 和嵌入式终端一起切换。

如何使用

1. 安装您想要的代理（Claude Code、Codex、Antigravity CLI、Copilot CLI、pi 等），并确保它们在您的 PATH 中。
2. 下载 Runner（原生 macOS Apple Silicon 或 Windows x64）从网站或 Releases 页面。
3. 创建团队 – 选择角色，为每个槽位分配一个代理，设置负责人和可选覆盖。
4. 启动任务 – Runner 打开一个分屏 UI，每个槽位都有自己的终端和用于协调的共享源。
5. 交互 – 回答问题、批准操作，或让代理自主运行。完成后，关闭应用；后台守护进程保持一切存活。

CLI 控制 Runner 用 runner 命令镜像每个 UI 操作，因此脚本或其他代理可以驱动它：

# 从脚本启动任务
mission=$(runner mission start --crew pair-coding --goal-file - -q brief.md)
runner mission feed "$mission" --follow   # 流式传输实时消息
runner msg post --mission "$mission" --to lead "Got it"
runner mission answer "$mission" <question_id> <choice>
runner mission stop "$mission"

所有命令都支持 --json 以输出机器可读，便于集成到自动化管道中。

支持的代理（截至最新版本）包括：

• Codex、Claude Code、Antigravity CLI、pi、GitHub Copilot CLI、Cursor、Grok（仅 macOS）以及可选的 TRAE CLI。
• 代理会自动检测；您可以覆盖可执行文件路径、查看版本信息，并从 设置 → 代理 更新它们。

安装

• macOS – 首次启动将 runner 安装到 ~/.local/bin（如果可写，则为 /usr/local/bin）。您也可以通过设置 → 常规 → 命令行手动添加。
• Windows – 安装程序将 runner.exe 添加到用户 PATH。
• 无需额外运行时；Runner 仅编排您已有的 CLI。

社区与支持

• 问题和功能请求：https://github.com/yicheng47/runner/issues
• 微信中文用户群（仓库中有二维码）。
• 欢迎通过 CONTRIBUTING.md 指南贡献。

许可证 MIT 许可证（2026 年至今）。早期版本（2026-08-22 至 2026-09-22）仅限 GPL-3.0，并仍在该许可证下可用。

---

底线 – Runner 是专为 AI 编码助手设计的桌面编排器，将一组独立的 CLI 代理转变为一个协调、持久且 UI 丰富的开发团队。