<div align="center">
<!-- ============================================================ -->
<!-- LOGO / HERO -->
<!-- Later replace with: docs/logo.png -->
<!-- ============================================================ -->
<img src="https://placehold.co/120x120/6366f1/ffffff?text=%F0%9F%A6%89" alt="claude-buddy logo" width="120" />
Claude Code Buddy
Your Claude Code buddy — permanently. Survives every update.
<!-- ============================================================ -->
<!-- BADGES -->
<!-- ============================================================ -->
<!-- ============================================================ -->
<!-- HERO GIF — the most important asset -->
<!-- ============================================================ -->
<br>
<img src="docs/hero.gif" alt="claude-buddy in action" width="800" />
<br><br>
Anthropic removed /buddy in Claude Code v2.1.97. This brings it back — forever. Same species, same stats, same personality. Now powered by MCP, so no update can ever take it away again.
<br>
<!-- ============================================================ -->
<!-- FEATURE HIGHLIGHTS — 4-column grid, no borders -->
<!-- ============================================================ -->
<table>
<tr>
<td align="center" width="25%">
<h3>🛡️</h3>
<b>Survives Updates</b><br>
<sub>MCP-based, not binary-patched. Your buddy lives through every Claude Code release.</sub>
</td>
<td align="center" width="25%">
<h3>🎨</h3>
<b>18 Species</b><br>
<sub>From ducks to dragons — each with animated ASCII art and rarity colors.</sub>
</td>
<td align="center" width="25%">
<h3>💬</h3>
<b>Speech Bubbles</b><br>
<sub>Your buddy comments on your code in real time. Invisible, contextual, alive.</sub>
</td>
<td align="center" width="25%">
<h3>⚡</h3>
<b>One-Command Install</b><br>
<sub>Zero config. Works on any Claude Code v2.1.80+. Uninstall anytime.</sub>
</td>
</tr>
</table>
<br>
</div>
<!-- ============================================================ -->
<!-- QUICK START -->
<!-- ============================================================ -->
🚀 Quick Start
git clone https://github.com/1270011/claude-buddy
cd claude-buddy
bun install
bun run install-buddy
Then restart Claude Code and type /buddy. That's it.
<sub>💡 Need Bun? → curl -fsSL https://bun.sh/install | bash</sub>
<br>
<sub>💡 Want a global claude-buddy command? → bun link</sub>
<br>
<sub>💡 Need help? → bun run help or claude-buddy help (if linked) in terminal · /buddy help in Claude Code</sub>
<br>
<!-- ============================================================ -->
<!-- COLLAPSIBLE SECTIONS START HERE -->
<!-- ============================================================ -->
<details>
<summary><b>🐙 Meet the 18 Species</b></summary>
<br>
Every buddy is uniquely generated from your Claude Code account — same species, same stats, same personality every time. 18 species, each with 3 idle animation frames + a blink.
<!-- Later replace with: docs/species-grid.png -->
<p align="center">
<img src="https://placehold.co/800x500/1e1e2e/cdd6f4?text=%F0%9F%90%99+SPECIES+GRID+IMAGE+%F0%9F%90%99%0A%2818+species+in+a+visual+grid%29" alt="all 18 species" width="800" />
</p>
duck goose blob cat dragon octopus
__ (°> .----. /\_/\ /^\ /^\ .----.
<(° )___ || ( ° ° ) ( ° °) < ° ° > ( ° ° )
( ._> _(__)_ ( ) ( ω ) ( ~~ ) (______)
`--' ^^^^ `----' (")_(") `-vvvv-' /\/\/\/\
owl penguin turtle snail ghost axolotl
/\ /\ .---. _,--._ ° .--. .----. }~(______)~{
((°)(°)) (°>°) ( ° ° ) \ ( @ ) / ° ° \ }~(° .. °)~{
( >< ) /( )\ [______] \_`--' | | ( .--. )
`----' `---' `` `` ~~~~~~~ ~`~``~`~ (_/ \_)