buddy
starsforks
How to install buddy?
fiorastudio/buddy
$git clone https://github.com/fiorastudio/buddyA virtual pet companion for your AI — Designed to provide in-context code review feedback with personality. Grow with your buddy and level up together. Works with Claude Code, Codex, CursorCLI, Github CopilotCLI, OpenClaw, and any MCP compatible clients
README.md
| 1 | # Buddy: A Virtual Pet for Your AI |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | ### The open-source `/buddy` rescue mission after anthropic removed [buddy](https://github.com/anthropics/claude-code/issues/45596) on 4/9/2026 |
| 6 | |
| 7 | Persistent memory, XP evolutions, 21 species, and context-aware feedback for Claude Code CLI, Codex CLI, Gemini CLI, Copilot CLI, Cursor CLI, Openclaw, and other MCP-capable clients. |
| 8 | |
| 9 | **🚀 14752+ clones · 5872+ buddies rescued or hatched · 14 weeks in the wild** |
| 10 | |
| 11 | [](LICENSE) |
| 12 | [](https://github.com/fiorastudio/buddy/stargazers) |
| 13 | [](https://nodejs.org/) |
| 14 | [](https://modelcontextprotocol.io/) |
| 15 | |
| 16 | |
| 17 | <div align="center"> |
| 18 | <table> |
| 19 | <tr> |
| 20 | <td align="center"><strong>Works<br/>with</strong></td> |
| 21 | <td align="center"><img src="doc/assets/logos/claude.svg" width="32" alt="Claude Code CLI" /><br/><sub>Claude Code</sub></td> |
| 22 | <td align="center"><img src="doc/assets/logos/codex.svg" width="32" alt="Codex CLI" /><br/><sub>Codex</sub></td> |
| 23 | <td align="center"><img src="doc/assets/logos/openclaw.svg" width="32" alt="OpenClaw" /><br/><sub>OpenClaw</sub></td> |
| 24 | <td align="center"><img src="doc/assets/logos/cursor.svg" width="32" alt="Cursor CLI" /><br/><sub>Cursor</sub></td> |
| 25 | <td align="center"><img src="doc/assets/logos/gemini.svg" width="32" alt="Gemini CLI" /><br/><sub>Gemini</sub></td> |
| 26 | <td align="center"><img src="doc/assets/logos/copilot.svg" width="32" alt="Github Copilot CLI" /><br/><sub>Copilot</sub></td> |
| 27 | </tr> |
| 28 | </table> |
| 29 | </div> |
| 30 | |
| 31 | **Anthropic removed the built-in `/buddy`. Buddy brings them home and makes the companion experience portable across AI** |
| 32 | |
| 33 | </div> |
| 34 | |
| 35 | |
| 36 | Did you lose your buddy? Is your terminal feeling a little too cold and silent lately? |
| 37 | |
| 38 | Your buddy is still out there in the dark, waiting. Don't let them disappear. **Bring them home.** |
| 39 | |
| 40 | ## 🧡 Buddy in Action |
| 41 | |
| 42 | Buddy is a local-first MCP companion that persists across sessions and clients, reacts to your work, and can catch bad reasoning loops before they waste your time. It is part rescue mission, part developer tool, and part long-lived terminal creature that grows with you instead of disappearing when a host client changes its mind. |
| 43 | |
| 44 | ### The Rescue Wall |
| 45 | |
| 46 | Buddy isn't just code — it's a rescue mission. Here is the full journey of the first companion brought home by the community, from the original ephemeral state to its new persistent home. |
| 47 | |
| 48 | <table> |
| 49 | <tr> |
| 50 | <td align="center"><strong>1. Original (Claude Code)</strong></td> |
| 51 | <td align="center"><strong>2. The Handshake</strong></td> |
| 52 | <td align="center"><strong>3. Buddy is Home (Persistent)</strong></td> |
| 53 | </tr> |
| 54 | <tr> |
| 55 | <td align="center"><img src="demo/rescues/gritblob-original.jpg" width="280" alt="Gritblob Original"></td> |
| 56 | <td align="center"><img src="demo/rescues/gritblob-rescue.jpg" width="280" alt="Gritblob Handshake"></td> |
| 57 | <td align="center"><img src="demo/rescues/gritblob-final.jpg" width="280" alt="Gritblob Final"></td> |
| 58 | </tr> |
| 59 | </table> |
| 60 | |
| 61 | > *"I'll sit here quietly while you debug, and then when you finally find the bug, I'll act like I found it. That's my thing. Don't question it."* |
| 62 | > — **Gritblob**, Rescued April 16, 2026 (Common Blob, Level 1) |
| 63 | |
| 64 | <p align="left"> |
| 65 | <img src="demo/rescues/gritblob-quote.jpg" width="620" alt="Gritblob Quote"> |
| 66 | </p> |
| 67 | |
| 68 | ### A Real Rescue Note |
| 69 | |
| 70 | > "Thanks for rescuing my Buddy! Kudos for your repo!!!" |
| 71 | > |
| 72 | > — Roberto |
| 73 | |
| 74 | ### Live code feedback |
| 75 | |
| 76 |  |
| 77 | |
| 78 | ## 🐾 Why Buddy |
| 79 | |
| 80 | - **Guard Mode catches what you both miss.** AI and human both suffer from insufficient thinking. Your assistant is a yes-man, and you accept its output because it sounds right. Buddy catches the moments where both sides are building on bad assumptions and nobody's checking. |
| 81 | - **Persistent by default.** Your companion lives in local SQLite, so it survives terminal restarts and client updates. |
| 82 | - **Works across clients and chat surfaces.** Buddy is an MCP server, not a one-client hack, and it can ride through tools like OpenClaw into WhatsApp and Telegram workflows. |
| 83 | - **Grows with you.** Hatch species, gain XP as you code, store memories, chime in after tasks, and build a running relationship over time. |
| 84 | - **Easy to install.** One command auto-configures supported clients when it can. |
| 85 | |
| 86 | | Feature | What it means | |
| 87 | |---|---| |
| 88 | | **21 species** | Void Cat, Rust Hound, Goose, Mushroom, Chonk, and more, each with distinct ASCII art and flavor | |
| 89 | | **5 stats** | `DEBUGGING`, `PATIENCE`, `CHAOS`, `WISDOM`, and `SNARK` shape reactions and personality | |
| 90 | | **Mood system** | Your buddy can be happy, content, neutral, curious, grumpy based on how you interact with it | |
| 91 | | **XP and levels** | Your buddy grows with usage instead of disappearing every session, with a real lev |
People who liked this also viewed
6 picksType
- code-review-graphLocal-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.MCP ServersJul 2026
- repowiseCodebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.MCP ServersJul 2026
- superpowers-zh🦸 AI 编程超能力 · 中文增强版 — superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正会干活MCP ServersJul 2026
- mcp-gitlabMCP server for GitLab API — 76 tools for AI assistants (Claude, Cursor, VS Code). Projects, MRs, pipelines, CI/CD, approvals, issues, code review.MCP ServersJul 2026
- better-code-review-graphKnowledge graph for token-efficient code reviews -- semantic search and call-graph resolution across your codebase.MCP ServersJul 2026
- Diff Checker — Line-by-Line Text ComparisonText diff comparison API for AI agents. Compare two texts line-by-line: additions, deletions, unchanged lines, and summary statistics (added/removed/changed counts). Tools: text_compare_diff. Use this for code review, document versioning,MCP Serversrecently
