Runner 多 Agent 协作终端
让多个编码 Agent 在真实终端中围绕同一任务分工协作。
- Star 数
- ★ 543
- 最近更新
- 今天
- License
- MIT
- 主语言
- Rust
- FA 评分
- 64/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望由一个编码 Agent 实现、另一个 Agent 审查工作区 diff,并持续修复直至审查通过的开发者。
- 不适合
- 需要 Linux、Intel Mac 或 Windows ARM64 支持的团队
- 要求生产级稳定性的团队;项目目前仍处于 alpha 阶段
- 不愿单独安装和配置 Agent CLI 的用户
- 官网
- runnersh.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.20.2(2026-11-20)近 7 天每天 +4.0 ★
- 源码审查
- 64/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Runner 是一款原生桌面应用,用于让 Claude Code、Codex、GitHub Copilot CLI 和 pi 围绕同一个开发目标协作,而不只是各自在独立终端中并行运行。用户先定义包含运行时、系统提示词和工作目录的 Role,再将多个 Role 组成带唯一负责人和团队约定的 Crew,最后启动 Mission。每个 Mission slot 都运行在独立的真实 PTY 中,并通过可持久化、可重放的事件 feed 交换消息、信号和面向用户的决策问题。应用还提供普通单 Agent Chat、分屏终端、项目分组、会话恢复、MCP 与技能配置管理,以及覆盖这些对象的 runner CLI。Runner 使用 Rust、gpui-ce、alacritty_terminal 和 SQLite 构建,无 WebView;状态、聊天和任务保存在用户自己的机器上。
Runner 读取并管理 Role、Crew、Project、Chat、Session 和 Mission 配置。启动 Mission 时,它为 Crew 的每个 slot 创建一个实时 PTY,并将代理自己的 TUI 保留在终端中;各成员通过追加式事件 feed、runner msg post、runner signal 和 runner ask 协调工作。负责人可以在需要决策时调用 ask_human,问题会显示在 feed 中,用户则可用界面或 runner mission answer 回复。应用支持停止、恢复或单独重启某个 slot,并在退出或崩溃后重新连接仍在运行的会话。Settings → MCP 和 Settings → Skills 会读取各 Agent 自己的配置文件,允许按 Agent 查看和切换 MCP server 或技能,同时只修改用户触碰的条目。runner 命令还能创建和维护项目、角色及团队,启动和归档任务,读取任务状态,并以 JSON 输出结果供 Agent 或脚本使用。
- 希望由一个编码 Agent 实现、另一个 Agent 审查工作区 diff,并持续修复直至审查通过的开发者。
- 需要让 Claude Code 与 Codex 在同一任务中承担不同角色,以获得跨供应商复核的团队。
- 同时运行多个终端 Agent,但希望集中查看工作状态、未读完成提示和人工决策请求的个人开发者。
- 需要把复杂仓库拆给架构、实现和审查角色,并保留完整协作事件记录的工程团队。
- 希望从 shell 或日常 Agent 中启动 Mission、跟踪 feed,并向负责人发消息的自动化用户。
- 需要在一个原生桌面界面中统一查看和开关 Claude Code、Codex 等工具的 MCP server 与技能配置的用户。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 配置文件
~/.local/bin- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
从 GitHub Releases 下载对应平台的最新安装包。macOS 仅提供 Apple Silicon 的已签名、已公证 .dmg;Windows 提供面向 Windows 10 1809 或更高版本的已签名 Runner-Setup-…-x64.exe。Intel Mac、Windows ARM64 和 Linux 不受支持。
需要单独安装希望使用的 Agent CLI,并确保其位于 PATH;也可以在 Settings → Agents 中设置可执行文件路径。Windows 上,Claude Code 和 pi 的 bash 工具需要 Git for Windows;通过 npm 安装的 CLI 还需要 Node.js。
首次启动时,macOS 会在登录 PATH 已包含合适目录的情况下,把 runner 安装到 ~/.local/bin 或可写的 /usr/local/bin;否则可在 Settings → General → Command line 中点击安装。Windows 会把 Runner sidecar 目录加入用户 PATH。Runner 还会为检测到的 Agent 安装配套技能:Claude Code 使用 ~/.claude/skills/,Codex、GitHub Copilot CLI 和 pi 使用 ~/.agents/skills/。
如何使用这个 Agent?
先在桌面应用中创建或选择 Role,并把 Role 放入 Crew 的命名 slot;每个 Crew 必须有且只有一个 lead。设置任务目标后启动 Mission,即可在 feed 与各 slot 的实时终端之间切换。默认的 pair-coding Crew 使用 @coder 负责实现和修复,@reviewer 读取工作区 diff 并报告必须修复的问题。
可先确认 CLI 已连接到正在运行的 Runner:
runner status查看可用 Crew:
runner crew list --json从文件启动一个 Mission,并持续读取其 feed:
mission=$(runner mission start --crew <crew> --goal-file - -q < brief.md)
runner mission feed "$mission" --follow --json
runner mission show "$mission" --json向负责人发送消息、回答人工问题,然后停止并归档 Mission:
runner msg post --mission "$mission" --to <lead_handle> "message"
runner mission answer "$mission" <question_id> <choice>
runner mission stop "$mission"
runner mission archive "$mission"在 Mission 内部,Agent 可直接使用事件日志上下文:
runner msg post --to <handle> "message"
runner signal <type>
runner ask --human <prompt> --choices <a,b,...>自动化场景建议使用 --json;成功退出码为 0,Runner 拒绝操作为 1,用法或引用错误为 2,应用未运行为 3,沙箱阻止本地连接为 5。
这个 Agent 有哪些优点和局限?
- 每个 Agent 保留自己的真实 PTY 和原生 TUI,不需要把不同供应商的交互方式压缩成统一聊天界面。
- Mission feed 是持久化、可重放的追加式事件日志,应用退出或崩溃后仍可重新连接尚在运行的会话。
- 同时支持 Claude Code、Codex、GitHub Copilot CLI 和 pi,可在同一 Crew 中混合不同运行时。
- 桌面界面与
runnerCLI 覆盖 Role、Crew、Mission、Session、Chat 和 Project,便于人、脚本和 Agent 使用同一套控制面。 - MCP 与技能面板直接读取各 Agent 的原有配置文件,并承诺只修改用户操作的条目。
- 本地原生架构采用 Rust、gpui-ce、alacritty_terminal 和 SQLite,无 WebView,状态保存在用户机器上。
- 项目明确标记为 alpha,仍在积极迭代,采用者需要接受预发布阶段的稳定性和变更风险。
- 仅支持 Apple Silicon macOS 与 Windows x64;Linux、Intel Mac 和 Windows ARM64 均不受支持。
- 各 Agent CLI 必须单独安装;某些运行时还附带订阅或模型供应商要求,例如 GitHub Copilot CLI 需要 Copilot 订阅。
- Windows 上 GitHub Copilot CLI 与 pi 虽可原生运行,但尚未经过 smoke test。
- Codex 不支持在 Runner 中显示需要用户处理的批准和问题对话框;pi 仅能通过扩展提供该能力。
- Mission 默认使用 Bypass 权限模式,团队在采用前需要评估其权限策略是否符合自身安全要求。
这个 Agent 与同类方案有什么区别?
与给每个 Agent 单独开一个互不关联的终端相比,Runner 增加了 Role、Crew、唯一 lead、共享事件 feed、持久化 Mission 和 ask_human 决策流程,同时仍保留每个 Agent 的真实终端界面。它没有限定单一模型供应商:Claude Code、Codex、GitHub Copilot CLI 和 pi 可以组成同一 Crew,但不同运行时的功能覆盖并不完全一致。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Runner 多 Agent 协作终端 当前 | 64 · 存在缺口 | 桌面应用免费 | ★ 543 | 今天 | Rust | Codex · Claude Code |
| amux 智能体控制平面 | 51 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 566 | 今天 | Rust | Codex · Claude Code |
| zerostack | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.8k | 2 天前 | Rust | OpenAI API · Claude API |
| pitwall | 81 · 表现良好 | — | ★ 22 | 今天 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示 Runner 将 CLI Agent 置于各自 PTY 中,并说明会话和历史留在本机;MCP/Skills 可按 Agent 关闭,文件浏览只读,夜间版与正式发布流程也把发布或安装保留为独立动作。AGENTS.md 的开发测试指引要求使用隔离目录并避免操作既有会话。扣分原因:产品会启动真实 CLI Agent、维护后台守护进程并提供远程控制,样本没有完整说明权限模型、敏感数据保护、外传路径或用户确认边界;Cargo.lock 未提供,无法据此充分评估依赖安全;恢复和回滚说明也有限。
README、AGENTS.md、CLI 入口和工作流共同描述 Rust 桌面应用、runnerd、CLI 与 PTY 的分工,整体自洽;CI 文件列出多个平台的格式、Clippy、测试及生成文档检查。CLI 入口对隔离参数和启动失败给出错误信息。扣分原因:README 明确称 Linux 为 beta,且对硬件、发行版的验证有限;CI 中 Rust Linux 使用 Ubuntu 22.04 容器,而产品说明仅称在 Ubuntu 26.04 ARM64 虚拟机试用,样本未解释这两者的验证覆盖差异。
README 针对需要并行使用多个终端编码 Agent 的开发者,说明了 crews、missions、真实终端、CLI、支持的 Agent 与平台差异,并链接到对应指南。功能边界如只读文件浏览、Linux beta 和远程控制私有 beta 有明确提示。扣分原因:对 Agent 之外的受众、资源需求以及各 Agent 具体能力差异,当前样本只提供概览和外链;技能样本展示的是 issue、夜间版和 release 工作流,未覆盖产品所有交互入口。
仓库指南、架构、用户指南、功能规格、实施计划和测试记录各有目录,README 提供导航;仓库含 MIT LICENSE、明确作者、工作区版本和发布/夜间版流程。安装与开发命令覆盖 macOS、Windows、Linux,示例包括 crew 与 mission CLI。扣分原因:样本未提供面向用户的完整安装页面、FAQ 或完整 changelog;README 标明 Alpha,且历史 GPL 版本说明显示许可曾变更;维护者虽有姓名和社区入口,但没有更完整的响应时限或维护承诺。
产品提供复用角色与 crew、并行 mission、共享 feed、独立终端和 CLI,目标是协调多个编码 Agent;输出可在各自 TUI 中查看,并能用 CLI JSON 输出供脚本处理。扣分原因:样本未量化相对单 Agent 工作流的收益、运行成本或多 Agent 冲突处理成本;真实 Agent、daemon 与多终端也增加资源和配置负担。
README 的产品说明可与 AGENTS.md 的架构词汇、CLI 示例、Cargo workspace、入口代码及 CI 工作流交叉核对;平台支持与 Linux 验证限制有明确文字,测试工作流也列出具体命令。扣分原因:大量用户可见能力仍主要由 README 声称,样本未包含对应功能实现或各平台结果;本评估仅依据给定静态材料,没有运行或独立复现。
- 这是 Alpha 产品;Linux 标为 beta,且硬件与发行版覆盖有限。远程控制仍为中国大陆地区的私有 beta。
- Runner 会启动真实 CLI Agent 并保留后台守护进程;使用前应核对 Agent 自身权限、登录状态和工作目录。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.20.2 Runner 0.20.2
发布说明摘录
Runner 0.20.2 is a feature release for macOS, Windows and Linux on top of 0.20.1. It brings git worktrees into the app, reads Codex's status from Codex's own terminal reports, and finishes the fix for remote control dropping and the app hanging. New - Git worktrees in the app. When you start a local chat, terminal or mission inside a Git repository, a Checkout control in the launcher's Location row lets you stay in the main checkout, pick an existing worktree, or choose New worktree… to create a linked worktree under .worktrees/ from a new branch and a base branch. In the si …在 GitHub 查看 ↗ -
v0.20.1 Runner 0.20.1
发布说明摘录
Runner 0.20.1 is a bug-fix release for macOS, Windows and Linux on top of 0.20.0. It delivers mission messages to more agents mid-turn, adds macOS line-editing keys in the terminal and git worktrees in the runner CLI, and fixes a crash and an app-wide hang. New - Mission messages reach more agents mid-turn. Messages from the mission inbox now reach a working Codex, pi, Antigravity or OpenCode member during its turn, as they already did for Claude Code, instead of waiting until the turn ends. GitHub Copilot CLI, Cursor and Grok still receive them when idle. (#1369) …在 GitHub 查看 ↗ -
v0.20.0 Runner 0.20.0
发布说明摘录
Runner 0.20.0 is a feature release for macOS, Windows and Linux on top of 0.19.9, with first-run setup, a git Changes view with Split diffs, and one theme picker for the app and its terminals. New - First-run setup. A fresh install now opens on Setup instead of an empty launcher. It lists the agents Runner found, installs Claude Code, Codex, GitHub Copilot CLI and pi through npm when it is available, opens a terminal to finish sign-in, and offers a Pair coding starter crew built from your installed agents, two different ones when you have them. Start your first chat crea …在 GitHub 查看 ↗
常见问题
Runner 是否会把代码或任务状态托管到云端?
退出 Runner 会终止正在工作的 Agent 吗?
可以混用 Claude Code 和 Codex 吗?
Runner 是否要求使用 MCP?
Mission 使用什么权限模式?
Runner 多 Agent 协作终端 官网是什么?
Runner 多 Agent 协作终端 免费吗?
Runner 多 Agent 协作终端 开源吗?
Runner 多 Agent 协作终端 还在维护吗?
Runner 多 Agent 协作终端 是谁开发的?
谢谢反馈,我们会据此改进页面。