BuddyBrawl

Your code has a companion. Gear it up. Fight.

You already have a Claude Code companion. It's waiting.

Install

npx buddybrawl init

60 seconds. Hooks into Claude Code. Syncs your buddy automatically on every session end.

How it works

01 — Code with Claude
Install the hook. Every Claude Code session feeds your buddy: tool calls → STR, session length → VIT, files changed → AGI, error rate → LCK.

02 — Earn Gear
Win battles → earn grzkies → craft legendary weapons, armor, and accessories. Dev-flavored loot with rarities from common to mythic. 35+ item bases, 16 affixes, 10 unique legendaries.

03 — Climb the Ranks
ELO-ranked, AI-narrated battles. Micro-leagues of 8 players. Weekly resets with promotion and demotion.

Gear

⚔️  Segfault Blade      [Mythic]    — +42 STR, 15% lifesteal
🛡️  Heisenbug Ward      [Legendary] — +28 VIT, 20% dodge on special
🪖  Null Pointer Helm   [Rare]      — +18 INT, reflects 10% magic
💍  Callback Signet     [Epic]      — +12 AGI, first strike bonus
👢  Stack Overflow Treads [Legendary] — +22 AGI, on-hit slow
📿  Off-by-One Amulet   [Rare]      — +15 LCK, +8 INT

Battle example

Round 2 — Dragon [Epic] uses ATTACK
Rabbit [Rare] attempts to dodge... fails.
Dragon lands 47 damage. Rabbit is at 53 HP.

"The Dragon's Segfault Blade tears through the Rabbit's defenses.
 One more round like this and it's over."

[Clutch Victory — you were 12 HP from losing]

Engagement mechanics

• Streaks with freeze tokens — daily return pressure, no hard resets
• Near-miss feedback — "you were 12 HP from winning" after every loss
• Loot anticipation — chest-open animation, name revealed before rarity
• Micro-leagues — 8 players, weekly reset, you always know the 2 people above you
• Pity timer — guaranteed rare drop after N dry battles

Links

• Demo: https://buddybrawl.vercel.app/demo
• Play: https://buddybrawl.vercel.app
• Leaderboard: https://buddybrawl.vercel.app/leaderboard
• npm: https://www.npmjs.com/package/buddybrawl

Built for Claude Code users. Companions provided by Anthropic.

Privacy

The sync hook runs at the end of each Claude Code session and sends the following to buddybrawl.vercel.app:

| Data | Purpose | |---|---| | git user.email and user.name | Stable identity across sessions | | Anthropic companion name, species, userID | Buddy identity and rarity derivation | | Session duration, tool call count, message count | Stat growth | | File paths modified (not contents) | Stat growth |

No source code is transmitted. The hook is open source — cli/buddy-sync.mjs is the exact file installed on your machine.

License

MIT