Agetor
本地优先的看板式编排器，让 Claude Code、Codex 等 CLI 编码代理在同一仓库中并行工作。
- Star 数
- ★ 121
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 60/100 · 存在缺口
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 开始前需要
- 典型场景
- 已订阅 Claude Code 或 Codex、想同时推进多个修复分支而不互相污染的独立开发者。
- 主要局限
- 目前只发布 macOS Apple Silicon 版，Linux 与 Windows 目标虽已配置但未构建也未测试。
- 源码审查
- 60/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Agetor 是一个基于 Electrobun 与 Bun 构建的 macOS 桌面应用，把看板变成多个编码代理的控制面板。每张卡片对应一个提示词、一个仓库和一个 harness（代理 CLI）；点击运行后，Agetor 会为任务创建独立的 git worktree 与分支，在 tmux 中启动真实的 CLI，并把对话流式呈现到面板里。它支持 Claude Code、Codex、Cursor、Gemini CLI、fx、Antigravity、GitHub Copilot 和 OpenCode 八种 harness，其中大多数仍需作为实验性功能对待。任务在 Backlog、Ready、Running、Blocked、Review、Done 之间随运行状态自动流转，问题、审批和计划以卡片形式等待你回答。此外还有 Agent 配置复用、Pipeline 多步编排、diff 审阅、GitHub/GitLab/Bitbucket 集成，以及一套操作同一状态的 agetor 命令行接口。
Agetor 在本机启动一个 Bun 核心进程，用 SQLite 保存任务、运行、事件、项目、harness 与偏好，并通过仅监听 127.0.0.1 的 HTTP + SSE 接口同时服务 React 前端和 agetor CLI。创建任务时它固定基准提交，在 ~/.agetor/worktrees/<task-id>/ 下建立 agetor/<id>-<slug> 分支的 worktree，然后在 tmux 中按 harness 各自的方式驱动真机 CLI：Claude Code 以交互会话运行并从其 JSONL 转录读取输出；Codex 每轮执行 codex exec --json；Gemini CLI 与 Antigravity 用 stream-json 无头模式；GitHub Copilot 用 --output-format json；OpenCode 2 则由 Agetor 为每个 harness 启动并托管一个服务器；fx 与 cursor-agent 通过 Agent Client Protocol 以 stdio 子进程通信。转录中的工具调用、计划、子代理与待办进度被解析成结构化界面元素，AskUserQuestion、计划审批和权限提示以卡片形式提交，回答再回写为真实按键或协议消息。Pipeline 功能把多个 Agent 串成带分支、扇出与回环的图，步骤之间通过 <handoff> JSON 块交接上下文。
- 已订阅 Claude Code 或 Codex、想同时推进多个修复分支而不互相污染的独立开发者。
- 需要把同一仓库的文档、测试和功能改动分派给不同代理并行处理的工程团队。
- 希望为团队保存可复用的 Agent 预设（harness、模型、思考强度、权限模式、技能）并一键启动任务的技术负责人。
- 想用 Plan → Implement → Review 之类的固定流水线把编码工作半自动化，并在阻塞时人工介入的开发者。
- 习惯在终端工作、希望用 agetor CLI 或 TUI 仪表盘管理任务、同时与桌面应用共享状态的工程师。
- 想把在别处启动的 Claude Code / OpenCode 会话导入看板继续跟进，并在应用内审阅 diff、提交并开 PR 的使用者。
如何安装或部署这个 Agent？
桌面版仅提供 macOS Apple Silicon 构建，下载后拖入“应用程序”即可，应用已签名并公证、可自更新。
# 1. 从最新 release 下载并安装桌面应用（手动步骤）
# https://github.com/alamops/agetor/releases/latest/download/Agetor-arm64.dmg
# 2. 安装并登录至少一个 harness CLI，例如 Claude Code
npm i -g @anthropic-ai/claude-code
claude
# 3. 可选：安装命令行接口（校验 SHA-256 后安装单个 agetor 二进制）
curl -fsSL https://github.com/alamops/agetor/releases/latest/download/install.sh | sh命令行接口默认安装到 /usr/local/bin，不可写时安装到 ~/.local/bin。从源码开发需要 Bun ≥ 1.3.5、Git、tmux 和至少一个 harness CLI：
git clone https://github.com/alamops/agetor.git
cd agetor
bun install
bun run dev:hmr如何使用这个 Agent？
在应用左侧点击 New task，选择项目文件夹（git 仓库会自动获得独立 worktree），挑选 Agent 或自行选择 harness、模型和模式，写下提示词后点击 Run task 立即运行，或 To backlog 排队。卡片打开后可以看实时转录、回答问题、追加消息、审阅 diff、开终端，或提交并开 PR。命令行接口与桌面应用共享 ~/.agetor 状态，应用未运行时 CLI 会启动一个无头守护进程：
agetor add --title "修复登录超时" --prompt "定位并修复会话过期问题"
agetor ls
agetor start <id>
agetor logs <id>
agetor answer <id>
agetor diff <id>
agetor commit <id>不带参数运行 agetor 会打开全屏 TUI 仪表盘。Agent 预设与 Pipeline 可通过 agetor export --all --out agents.json 与 agetor import agents.json 在机器之间迁移；后台常驻（含应用关闭后继续运行）需在设置中开启 Keep Agetor running in the background，该开关仅对安装在 /Applications 或 ~/Applications 的正式构建可用。
这个 Agent 有哪些优点和局限？
- 每个任务使用独立 git worktree 和 agetor/<id>-<slug> 分支，同一仓库的多个代理不会互相覆盖改动。
- 不替换也不包装你的代理：直接启动 PATH 上的真实 CLI，沿用原有登录、技能、MCP 服务器和斜杠命令，不安装 hook、不修改 CLAUDE.md。
- 基于 tmux 的会话在退出应用后可被重新接管，重启后回放转录且不重复，丢失会话的任务退回 Ready 而非卡在 Running。
- Pipeline 支持分支、并行扇出、回环与步骤上限，并以结构化 <handoff> JSON 在步骤间传递摘要、文件与待解决问题。
- 本地优先：无账号、无云中继、无遥测，数据存于 ~/.agetor/agetor.sqlite，API 只监听 127.0.0.1 且每次启动生成随机令牌。
- 目前只发布 macOS Apple Silicon 版，Linux 与 Windows 目标虽已配置但未构建也未测试。
- 八种 harness 中只有 Claude Code 等少数开箱即用，Codex、Cursor、Gemini CLI、fx、Antigravity、GitHub Copilot、OpenCode 均标注为实验性。
- fx 与 Cursor 作为 Agetor 子进程运行，不进入 tmux，因此应用重启会丢失进行中的回合；fx 在 Agetor 退出时停止。
- 多个 harness 有各自已知限制，例如 OpenCode 2 与 1.x 不能共用数据目录、Ask 模式仅在 OpenCode 2 可用、fx 0.0.14 会在某些模型上拒绝 shell 命令。
- Pipeline 的并行步骤共享同一个 worktree，源码明确警告无法阻止两个步骤改动同一文件。
- 代理以你的完整用户权限运行，Agetor 不自带额外沙箱，默认权限模式为放手执行。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agetor 当前 | 60 · 存在缺口 | — | ★ 121 | 今天 | TypeScript | Codex · Claude Code |
| Agentbox | 51 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 362 | 今天 | JavaScript | Codex · Claude Code |
| PandaCode | 58 · 缺口较多 | — | ★ 1.1k | 今天 | Rust | Codex · Claude Code · Claude.ai |
| Prometeu | 57 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 65 | 今天 | Rust | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
安全文档（docs/architecture/security.md）显示：API 默认绑定 127.0.0.1、双令牌、常量时间比较、路由默认拒绝、CLI 路径门控、子进程 disclaim、无跟随读取、OpenCode 密码 0600 且日志脱敏，权限最小化与敏感数据处理做得相当扎实（各 2-3 分）。但依赖安全仅凭 README 的安装命令与徽章，无锁文件/审计证据，给 1 分；外部副作用（推送、开 PR、写 worktree）有确认流程但未系统化，给 2 分；回滚依赖 git worktree 与分支，属间接保障，给 2 分；来源归属仅 MIT 与未验证发布者，给 1 分。
README 与安全文档对 tmux/ACP 两种驱动、重启恢复、OpenCode 1.x/2 差异描述一致，自洽性给 2 分；但依赖可用性只靠 README 表格与安装提示，无版本锁定或依赖清单证据，给 1 分；失败信息在文档中有大量具体错误码与提示（403 desktop-only、501 headless、升级提示），给 2 分。
受众与场景明确（macOS Apple Silicon 本地多 agent 编排），给 2 分；能力边界写得非常清楚（哪些 harness 实验性、哪些不支持重启、Ask 不是沙箱），给 3 分；触发精度依赖 CLI 探测与模式选择，文档有说明但无测试证据，给 2 分；环境适配仅 macOS ARM，Linux/Windows 未构建未测试，给 1 分。
信息架构有 README 与 docs/architecture 主题索引，给 2 分；安装说明完整（dmg、curl 安装、校验和），给 2 分；命名稳定性证据不足（大量实验性 harness、迁移编号需人工核对），给 1 分；示例与 FAQ 以 notes 形式存在，给 2 分；已知限制非常详尽，给 3 分；许可证 MIT 有徽章但未见 LICENSE 正文，给 2 分；版本与变更日志仅靠 release 徽章，给 1 分；维护责任因发布者未验证且无 CONTRIBUTING 证据，给 1 分。
输出可用性体现在结构化 transcript、diff 审阅、PR 流程，给 2 分；边际价值相对单终端并行确有提升，给 2 分；成本收益受限于仅 macOS ARM、需自备多个 CLI 登录与配额，给 1 分。
计划文档带 Base SHA、文件行号与实测数据，可追溯性给 2 分；但跨来源佐证有限（多为单文档自述，无测试或第三方复核），给 1 分；事实与推断分离较好（明确标注 spike 证据与假设），给 2 分。
- 发布者身份未经 FollowAgents 验证，维护责任与更新路径不明确，采用前应自行核实来源。
- 仅支持 macOS Apple Silicon；Linux/Windows 目标未构建未测试，跨平台部署不可行。
- 依赖安全无锁文件或审计证据，安装脚本通过 curl | sh 执行，需自行校验校验和与二进制来源。
- Ask/Plan 模式是同意提示而非沙箱，已批准的 shell 命令可读取 OpenCode 密码等本机凭据。
- 多个 harness 标注为实验性，行为可能随上游 CLI 版本变化；无版本锁定。
- 未提供 LICENSE 正文与变更日志，版本兼容性需以 release 页面为准。