ramarivera/coding-buddy

解决的问题

Coding Buddy 为 Claude Code、Pi 和 Oh My Pi 等 AI 编程助手提供一个持久、可动画的 ASCII 同伴。该项目恢复了 Claude Code 中被移除的「伙伴」功能，通过使用 Model Context Protocol (MCP) 而非二进制补丁，确保该同伴在软件更新后依然存活。

如何工作

该项目通过多个稳定的扩展点与 AI 框架集成：

• MCP 服务器：提供工具和系统提示，指导 AI 在每轮结束时触发反应。
• 技能：实现斜杠命令（如 /buddy），用于查看统计数据并与同伴互动。
• 状态栏：在终端的状态栏中渲染动画 ASCII 艺术和对话气泡。
• 钩子：使用 shell 包装器检测错误或测试失败等事件，以触发特定的同伴反应。

同伴身份通过基于用户账户 UUID 的确定性算法（wyhash + mulberry32）生成，确保同一用户始终被分配到相同的同伴。

适用人群

使用 Claude Code、Pi 或 Oh My Pi 的开发者，希望在编码会话中拥有一个游戏化、可视化的同伴。

主要亮点

• 抗更新：基于 MCP 构建，因此在主机 AI 工具更新时不会崩溃。
• 多样生物群：包含 19 种不同物种，稀有度从普通到传说不等，每种都有独特的属性（调试、耐心、混沌、智慧、讽刺）。
• 预设备用语句：使用备用语句池，确保即使 AI 模型未能响应，对话气泡也不会沉默。
• 跨框架同步：通过环境变量支持在不同 AI 编程工具间共享单一同伴身份。
• TUI 选择器：交互式终端用户界面，可搜索并保存特定的同伴物种和稀有度。