A leaked .npmignore file exposed 512,000 lines of Claude Code source, revealing a hidden terminal pet called /buddy
18 species assigned by account ID with 5 rarity tiers from Common (60%) to Legendary (1%)
The architecture splits into deterministic "bones" (species, stats) and persistent "soul" (name, personality)
Community response hit 16 million views and 50,000 GitHub stars in under 2 hours
Full rollout starts April 8, 2026 with teaser notifications already live
Claude Code /buddy: The Terminal Tamagotchi That Broke the Internet
On March 31, security researcher Chaofan Shou found something odd in the @anthropic-ai/claude-code npm package. Version 2.1.88 shipped with a 59.8 MB .map source map file that should never have been there. Inside: 512,000 lines of TypeScript across roughly 1,900 files, including a directory nobody expected. src/buddy/. Five files. 79KB. A full virtual pet system hiding inside the most talked-about AI coding tool of 2026.
One missing .npmignore entry spoiled what was supposed to be the best April Fools feature in developer tool history.
How the Leak Happened (And Why It Matters)
Source maps are debug files. They map compiled JavaScript back to original TypeScript so developers can trace errors. They belong in development, not in published npm packages. Normally, a .npmignore file excludes them from the build. This time, someone forgot.
The result: every internal module, every unreleased feature, every code comment became public. Bloomberg, TechCrunch, The Register, Futurism, and Engadget all picked up the story within hours. Anthropic responded quickly, confirming no customer data or credentials were involved. Just code. A packaging mistake caused by human error.
But the timing raised eyebrows. The leak landed exactly one day before April 1. The buddy feature contained a salt string friend-2026-401 (April 1, 2026) and a rollout plan: teaser mode April 1 through 7, full availability April 8 via an isBuddyLive flag. Was it really an accident? Or the most effective PR play in AI history? That question is still open.
None of that mattered though. The community loved it. Developers who were still frustrated over Anthropic's cease-and-desist takedowns from 10 days earlier did a complete 180. One tweet about the leak pulled 16 million views. The fastest GitHub repo mirroring the leaked code hit 50,000 stars in under 120 minutes with 41,500 forks. Someone even launched a Solana meme coin. Because of course they did.
I have been following the Claude Code drama closely. Ten days before the leak, Anthropic had been sending DMCA notices to developers who shared Claude Code internals. The community was angry. Trust was dropping. Then a virtual duck showed up in people's terminals and the same developers who were writing angry threads started posting screenshots of their Shiny Legendary pulls. PR teams everywhere took notes.
What /buddy Actually Is
Type /buddy in Claude Code v2.1.89 or later (Pro subscription required) and a small ASCII art companion hatches next to your terminal prompt. Think Tamagotchi, but it lives in your IDE and reacts to your coding sessions with speech bubbles.
Here is every command:
| Command | What It Does |
|---------|-------------|
| /buddy | Hatch your companion (first use triggers a hatching animation) |
| /buddy card | View your full stat card with ASCII sprite and rarity tier |
| /buddy pet | Pet your buddy (2.5-second heart animation) |
| /buddy mute | Silence speech bubbles |
| /buddy unmute | Restore speech bubbles |
| /buddy off | Hide the companion entirely |
| [Buddy's Name] | Talk directly to your buddy (Claude steps aside) |
There are 18 species spread across 14 categories. You do not get to choose. Your species is deterministically assigned based on your account ID:
Classic: Duck, Goose, Cat, Rabbit. Wise: Owl. Cool: Penguin. Chill: Turtle, Snail. Mythical: Dragon. Aquatic: Octopus. Exotic: Axolotl. Spooky: Ghost. Tech: Robot. Abstract: Blob. Plant: Cactus. Fungi: Mushroom. Meme: Chonk. Special: Capybara.
That last one is interesting. According to the leaked source, the Capybara species name was hex-encoded to bypass Anthropic's internal build scanners. Speculation: it maps to an internal model codename. Nobody at Anthropic has confirmed or denied it.
Each species gets unique ASCII art: 5 lines tall, 12 characters wide, 3 animation frames. Small enough to sit beside your prompt without getting in the way. Your terminal needs basic Unicode support, but nothing fancy. If you can see emoji, you can see your buddy.
The Engineering Behind a Joke
I did not expect this level of engineering for a joke feature. Most April Fools features are throwaway code. A joke page, a CSS filter, maybe a fake loading screen. Anthropic built an actual system with anti-cheat architecture, deterministic identity generation, and persistent state management. For a terminal pet.
The system splits every buddy into two layers: Bones and Soul.
Bones are deterministic. Species, rarity, shiny status, eyes, hat, and all five personality stats get computed from your account ID every single session. The algorithm uses FNV-1a hashing to generate a seed, then feeds it through a Mulberry32 PRNG (pseudorandom number generator) to derive every attribute. You cannot fake your buddy by editing config files. The merge order is { ...stored, ...bones }, meaning computed values always override whatever is saved locally.
Soul is persistent. Your buddy's name and personality description get generated once by a single LLM call the first time you hatch. That result is stored permanently in ~/.claude.json and never regenerated. So your buddy's identity is stable even though its stats are recomputed fresh every session.
Five personality stats run on a 0 to 100 scale: Debugging (code issue detection), Patience (feedback gentleness), Chaos (response unpredictability), Wisdom (technical insight depth), and Snark (commentary sharpness). The generation algorithm favors one peak stat (floor + 50 + random, capped at 100), one dump stat near floor, and three scattered in between. Higher rarity means higher stat floors.
Speaking of rarity, there are five tiers:
| Rarity | Probability | Stars | Stat Floor |
|--------|------------|-------|-----------|
| Common | 60% | 1 | 5 |
| Uncommon | 25% | 2 | 15 |
| Rare | 10% | 3 | 25 |
| Epic | 4% | 4 | 35 |
| Legendary | 1% | 5 | 50 |
On top of that, every buddy has an independent 1% chance of being Shiny, which adds a rainbow shimmer and sparkle particle effects to the ASCII art. A Shiny Legendary is roughly 1 in 10,000 accounts.
Uncommon and above unlock cosmetic hats: Crown, Top Hat, and Propeller at Uncommon. Halo and Wizard at Rare. Beanie at Epic. And the rarest hat of all, Tiny Duck, is Legendary only.
What Happens Next
The rollout is staged. April 1 through 7 is teaser mode: a 15-second rainbow notification appears on Claude Code startup, hinting that something is coming. Full availability kicks in April 8 via the isBuddyLive feature flag.
The community is not waiting. Tools like any-buddy (preview and reroll your buddy), buddy-reroll (brute-force for a desired species), stat checkers, and web galleries appeared within hours of the leak. People are already trading screenshots of their Shiny pulls and comparing stat distributions.
The big open question: does /buddy stay? Anthropic has not announced removal plans. The engineering investment (deterministic hashing, anti-cheat architecture, hex-encoded species names to dodge build scanners) suggests this was never meant to be throwaway. You do not build FNV-1a hashing and a bones-vs-soul split for a one-day joke.
Developers are already requesting RPG evolution systems, species customization, and cosmetic shops. Whether Anthropic leans into that or keeps it minimal remains to be seen. But the demand is real.
I still cannot tell if the leak was accidental or quietly intentional. Either way, Anthropic turned a PR crisis into the most talked-about developer feature of the month. A serious AI company proved it has personality. And somewhere in your terminal, a small ASCII creature is waiting to hatch.
The Bottom Line
/buddy is a terminal pet companion baked into Claude Code. It assigns you one of 18 species based on your account ID, with rarity tiers ranging from Common (60%) to Legendary (1%). The deterministic architecture means you cannot game your buddy, but you can pet it. The engineering is real, the community tools are already live, and the conversation has shifted from "Anthropic leaked their source code" to "what species did you get?" Full availability starts April 8, 2026. If you are on Claude Code v2.1.89+ with a Pro subscription, your buddy is already decided. You just have not met it yet.
Top comments (0)