单 Agent 容易跑偏，全程盯防太累
执行者盲区
单个 AI agent 编写代码时，容易陷入方向偏差、遗漏边界情况、重复犯错
人类疲于校准
全程监控 AI 输出耗尽精力，频繁打断思路，本该用来思考的时间被消耗在盯屏上
循环无收敛
没有审查闭环，修复 A 引入 Bug B，代码质量在反复修补中逐渐失控
执行 → 审查 → 交替 → 收敛
双方独立确认「完成」才会停止。不会因为一方过早判定而遗漏问题。Actor 完成后自动切换至对手方，你随时可以介入校准。
若一方说完成、另一方却继续改了代码，break 会被撤回，任务继续运行——收敛必须建立在双方都无新改动之上。
无人值守，全程可追踪
长任务跑到上下文耗尽也能自己续跑，每一轮的模型、Token、耗时都可回溯。Buddy 让两个 AI 真正跑完一个长任务而不崩。
不中断闭环
上下文耗尽自动重置续跑
长任务跑到上下文窗口耗尽时，自动识别中英文超限错误，重置会话并用 LLM 生成精简摘要在新会话续跑；摘要失败则回退截断摘要并备份原上下文。无需全程盯防，长任务自己跑完。
透明运行记录
运行详情面板
每一轮的模型、Token、耗时一目了然，并实时流式输出 stdout，过程完全可见。
完成统计表
任务结束时显示双 actor 汇总表：模型、Token（含缓存读取）、耗时、轮次。每一轮对话都可追溯、可审计。
新用户指南
Buddy 是一个桌面应用（macOS），让两个 AI 编程工具围绕你的本地代码仓库轮流工作。一个负责写代码，一个负责检查，交替进行，直到双方都认为任务完成。
使用前必须准备
Buddy 本身不内置 AI 能力。你需要先在自己的电脑上安装准备使用的 AI 命令行工具，并确认这些工具已经登录、授权可用。默认双 AI 协作建议先装好 Claude Code 和 Codex CLI。
安装后，先在终端里运行一次并确认能正常使用。只检查版本号不够；如果没有登录、登录态过期或权限不足，Buddy 也无法替你调用它。
基本用法
安装并登录 AI 命令行工具
先安装你想用的 AI 工具，比如 Claude Code 或 Codex。安装后在终端里运行一次，确认已经登录且能正常使用。
配置启动命令
打开 Buddy 的设置，填写 AI 工具的启动命令。默认配置通常可以直接用，也可以自定义路径和参数。
选择本地仓库
在 Buddy 中选择一个本地 Git 仓库作为工作目录。两个 Actor 都会在这个目录里读写代码。
写任务说明，开始运行
写清楚你想要什么，然后点开始。执行者先写代码，完成后审查者检查，交替进行直到双方都确认完成。
为协作而生的每一个细节
会话持久化
复用原生 CLI 会话（Claude Session ID / Codex Thread ID），上下文跨轮次保留，中断后无缝恢复
Git 集成
本地化 conventional commit 消息生成、变更查看、提交与推送
桌面通知
任务完成、失败或暂停时推送系统通知，完成通知附带轮次、耗时与 Token 统计，不用全程盯屏
指令队列
Actor 运行期间即可排队发送指令，轮次结束后自动执行
可定制快捷键
任务导航、侧栏切换、操作快捷键均可自定义，适配你的肌肉记忆
崩溃恢复
全量 JSON/JSONL/MD 持久化，重启自动恢复
23 主题 + 三语支持
15 暗色 + 8 亮色主题，英文 / 简中 / 繁中完整支持，CJK 自动检测
接入你熟悉的 AI 工具
Anthropic 旗舰编程 Agent，会话持久化，上下文深度最强
OpenAI CLI 编程助手，线程级上下文，审查视角互补
开源编程 Agent，灵活可定制，支持多种 LLM 后端
月之暗面出品，中文场景优化，自动检测 kimi-code/kimi-cli
支持任意遵循 Launcher Protocol 的自定义命令
常见问题
Buddy 和单个 AI CLI 工具有什么区别？
Buddy 让两个 AI Actor（执行方 + 审查方）轮流工作：执行方写代码，审查方挑毛病，循环推进。这比单次对话更接近真实团队协作，能显著提升一次通过率与代码质量。
任务什么时候会结束？
采用「双确认结束」机制：执行方和审查方都必须发出 type=break 信号，任务才会转为 DONE。单方 break 不会终止任务，避免一方偷懒提前结束。
崩溃或重启后任务还在吗？
在。所有任务状态以文件形式持久化在 ~/Library/Application Support/buddy/。重启时，处于 RUNNING 的任务会自动重置为 PAUSED，方便你继续。
能边运行边追加指令吗？
可以。Actor 运行期间发送的指令会进入指令队列，当前轮次结束后自动执行，无需打断。
数据会离开本地吗？
Buddy 本身不联网传输你的任务数据，所有状态、对话记录、产物都保存在本地文件系统。AI 推理由你配置的 CLI 工具各自完成。
Let's Buddy!
双 Agent 协作，收敛式编程
系统要求：macOS 12+ (Monterey)