Persistent AI coding companion - MCP server with 21 species, personality stats, and code feedback
How to install buddy?
fiorastudio/buddy
$git clone https://github.com/fiorastudio/buddyInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install buddy by running `git clone https://github.com/fiorastudio/buddy`, then use it for the current task and follow its documentation at https://github.com/fiorastudio/buddy.
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 |
Related
6 picksType
- code-review-graphLocal-first knowledge graph for token-efficient code review through MCP and CLIJul 2026
- repowiseCodebase intelligence for AI coding agents — graph, git history, docs, decisions, code health.Jul 2026
- mcp-server-atlassian-bitbucketNode.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.Mar 2026
- gemini-mcp-toolMCP server for Gemini CLI integrationJul 2026
- socraticodeEnterprise-grade (40m+ LOC) codebase intelligence, zero-setup, local & private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis & call-flow, interactive HTML viewer, cross-project & branch-aware search, DB/API/infra…Jul 2026
- github-mcpProduction-ready Model Context Protocol server providing Claude with complete GitHub integration - comprehensive tools for repository management, branch operations, file handling, issue tracking, and collaboration features with OAuth 2.0 authentication and MongoDB persistence.Jun 2026
