【免费下载链接】overstoryMulti-agent orchestration for AI coding agents — pluggable runtime adapters for Claude Code, Pi, and more项目地址https://gitcode.com/gh_mirrors/ov/overstory点击查看免费下载Overstory 是一款面向 AI 编程代理AI coding agents的开源多智能体编排 CLI 工具它在隔离的 git worktree 中生成多个 worker 代理通过自研的 SQLite 邮件系统协调通信并用分级冲突解决机制自动合并成果。本手册把全部 38 个ov命令按 7 大功能域整理成速查清单并给出新手上手的典型实战流程5 分钟即可完成第一次多智能体编排。1. 安装与 60 秒上手Overstory 基于 Bun 运行时支持 Claude Code、Pi、Gemini CLI、Aider、Goose、Amp 等 11 种可插拔运行时适配器源码见 src/runtimes/。# 全局安装 bun install -g os-eco/overstory-cli # 在项目目录初始化 .overstory/ 目录 cd your-project ov init # 安装 hooks 到 .claude/settings.local.json ov hooks install # 启动常驻协调器 ov coordinator start # 打开 Web UI默认端口 7321 ov serve新手提示ov serve是主要的操作面板可以看代理舰队fleet、读邮件总线、检查每个代理的时间线。嫌 Web 界面麻烦时ov dashboard提供终端 TUI 替代方案。2. 全局标志所有命令通用的 5 个开关标志作用-q, --quiet静默模式只输出错误--json以 JSON 输出方便脚本化--timing把命令耗时打印到 stderr--project path指定项目根目录覆盖自动探测--verbose详细输出错误时附带堆栈全局标志定义在 CLI 入口 src/index.ts所有命令都接受这些标志且位置灵活ov --project /path status与ov status --project /path等价。终端配色遵循NO_COLOR环境变量。3. 核心工作流命令7 个日常使用频率最高的一组命令覆盖初始化 → 派工 → 停止 → 刷新全生命周期命令功能常用参数ov init初始化.overstory/并引导 os-eco 生态工具--yes非交互、--name、--tools、--skip-mulch/seeds/canopy、--jsonov sling task-id生成一个 worker 代理--capabilitybuilder/scout/reviewer/lead/merger、--name、--runtime、--no-headless、--recoverov stop agent-name终止运行中的代理--clean-worktree、--forceov prime为编排器/代理加载上下文--agent、--compactov spec write task-id写任务规格说明--bodyov discover由协调器驱动 scout 蜂群探索存量代码库--skip、--attach、--watchdogov update从已安装包刷新.overstory/托管文件--agents、--manifest、--hooks、--dry-runsling是核心中的核心实现见 src/commands/sling.ts。实战示例# 派一个 builder 代理去做任务 T-12 ov sling T-12 --capability builder --name my-builder # 想要中途实时接管强制 tmux 模式 ov sling T-12 --capability builder --name my-builder --no-headless tmux attach -t ov-my-builder⚠️坑位提醒如果代理中途意外退出且任务已关闭nudge和sling都会拒绝重新介入。此时用--recover跳过可工作状态检查ov sling T-12 --capability lead --recover --name fresh-lead。4. 协调层命令coordinator / orchestrator / supervisorOverstory 采用分层架构Orchestrator跨多仓库→Coordinator单项目常驻编排器→Lead/Workerscout、builder、reviewer、merger。各角色定义见 agents/ 目录。命令功能ov coordinator start/stop/status启动/停止/查看常驻协调器--attach、--watchdog、--monitorov coordinator send发火后不管的异步消息--subjectov coordinator ask同步请求/应答--subject、--timeoutov coordinator output查看协调器最近输出--linesov coordinator check-complete评估退出触发条件返回完成状态ov orchestrator start/stop/status/send/ask/output多仓库编排器的同构命令集ov supervisor start/stop/status已废弃请改用 coordinator实现细节可参考 src/commands/coordinator.ts 的头部注释——它清楚解释了 coordinator 与普通 sling 代理的三大区别没有 worktree、不认领任务、跨工作批次持久存在。5. 消息与协作命令mail / nudge / group代理间通信走自研 SQLite 邮件系统WAL 模式单次查询约 1-5ms支持 8 种类型化协议消息和all、builders等群发地址源码在 src/mail/。命令功能常用参数ov mail send发送消息--to、--subject、--body、--type、--priorityov mail check查看收件箱未读消息--agent、--inject注入到代理、--debounceov mail list按条件列消息--from、--to、--unreadov mail read id标记消息已读—ov mail reply id同线程回复--bodyov nudge agent [message]给卡住的代理发踢一脚消息--from、--forceov group create/status/add/list任务组批量追踪成员全部完成时自动关闭group add name issue-id实战示例ov mail check --inject # 检查未读并注入给代理 ov nudge my-builder 请继续T-12 还差测试用例 ov group create sprint-42 ov group add sprint-42 T-12 T-136. 合并命令merge命令功能常用参数ov merge把代理分支合并回主分支--branch、--all、--into、--dry-run底层是 FIFO 合并队列SQLite 存储 四级冲突解决 哨兵文件锁源码见 src/merge/。建议先--dry-run预检冲突再正式合并ov merge --dry-run # 只查冲突不合并 ov merge --all # 合并队列中所有待处理分支7. 可观测性命令11 个看懂你的蜂群命令功能常用参数ov status全部活跃代理、worktree、tracker 状态--json、--verbose、--allov dashboard实时 TUI 监控面板Web UI 的终端替代--interval、--allov inspect agent单代理深度检查--follow、--interval、--limitov trace查看代理/任务时间线--agent、--run、--since、--untilov errors跨代理错误聚合视图--agent、--run、--limitov replay交错式按时间重放事件--run、--agent、--limitov feed统一实时事件流--follow、--intervalov logs跨代理查询 NDJSON 日志--level、--since、--followov costsToken 与成本分析--live、--by-capability、--lastov metrics会话指标--lastov run list/show/complete编排 run 生命周期管理--last、run show id排障三板斧ov status看全局 →ov inspect agent钻单点 →ov replay --run id还原现场。成本超预算时用ov costs --live实时盯梢。8. ️ 基础设施命令12 个命令功能常用参数ov hooks install/uninstall/status管理编排器 hooks写入.claude/settings.local.json--forceov worktree list/clean列出/清理 worktree--completed、--all、--forceov watch启动 Tier 0 看门狗守护进程机械存活检测--interval、--backgroundov monitor start/stop/statusTier 2 监控代理持续巡航天团健康—ov log event记录一次 hook 事件--agentov clean清空运行态核弹级清理--all、--mail、--sessions、--worktrees、--branchesov doctor13 类健康检查支持自动修复--category、--fix、--jsonov serve启动 Web UI 的 HTTP WebSocket 服务--port默认 7321、--hostov ecosystem查看 os-eco 工具版本与健康状态--jsonov upgrade升级 overstory 到最新 npm 版本--check、--allov agents discover按能力/状态/父级查询代理--capability、--state、--parentov completions shell生成 bash/zsh/fish 补全脚本—ov doctor内置 13 个检查模块依赖、配置、目录结构、数据库、合并队列、providers、watchdog 等注册表见 src/commands/doctor.tsov doctor # 全量体检 ov doctor --category providers # 只查 API 网关配置 ov doctor --fix # 自动修复可修复项ov serve默认端口是 7321 而非 8080——因为 8080 容易与 Colima/Docker 等工具冲突这个细节写在 src/commands/serve.ts。9. 实战演练一天典型工作流把上面的命令串起来一个完整的编排日大概长这样# 早上体检 启动 ov doctor --fix ov coordinator start ov serve # 浏览器打开 http://localhost:7321 # 上午派工通常由 coordinator 自动完成这里手动演示 ov spec write T-12 --body 实现登录模块单元测试 ov sling T-12 --capability builder --name auth-builder # 下午盯盘 ov status ov feed --follow # 实时事件流 ov costs --live # 成本监控 ov nudge auth-builder 进度如何 # 收尾合并 清理 ov merge --dry-run ov merge --all ov stop auth-builder --clean-worktree ov clean --completed全部 38 个命令的实现都放在 src/commands/ 目录一文件一命令命令路由与模糊纠错逻辑打错命令名会提示Did you mean ...在 src/index.ts。10. 速查30 秒找命令我想…用这个命令初始化项目ov init派一个代理干活ov sling task-id看看谁在干活ov status或ov dashboard代理卡住了ov nudge name收到/发送消息ov mail check/ov mail send合并成果ov merge --all钱花哪了ov costs --live出错排查ov doctor --fixov inspect name清场ov clean --allOverstory 命令虽多但 80% 的场景只需记住init、sling、status、mail、merge、doctor六个动词。配合ov completions生成 shell 补全后多智能体编排会像git一样自然上手。 延伸阅读完整的风险说明请阅读仓库根目录的 STEELMAN.md多智能体的错误率叠加、成本放大是常态而非例外架构细节见 CLAUDE.md技术设计文档在 docs/。赞分享【免费下载链接】overstoryMulti-agent orchestration for AI coding agents — pluggable runtime adapters for Claude Code, Pi, and more项目地址https://gitcode.com/gh_mirrors/ov/overstory点击查看免费下载相关推荐Minari CLI命令行完全手册list、download、show、combine完整命令清单Minari CLI命令行完全手册list、download、show、combine完整命令清单 Minari 是离线强化学习Offline ReinfoArthas help 命令完全指南查看命令清单与单个命令用法详解Arthas help 命令完全指南查看命令清单与单个命令用法详解 本篇技术指南围绕 Alibaba Java 诊断工具 Arthas 的 help 命令展开开发工具可观测性调试器性能剖析Gemini CLI 命令行参考命令、选项与子命令的完整实战手册Gemini CLI 命令行参考命令、选项与子命令的完整实战手册 本文以 Gemini CLI 官方文档中的命令行速查表为骨架系统梳理 gemini 的启动人工智能AI Agent交互助手CLIMCP Clients创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考