claude-buddy

Brute-force search for Claude Code buddy companions by UUID.

Claude Code assigns each user a procedurally generated buddy based on their account UUID. This tool replicates the exact algorithm (Mulberry32 PRNG seeded via wyhash) to predict the buddy for any UUID — and search millions of UUIDs per second for specific traits.

Install

cargo install --path .

Or build from source:

cargo build --release
./target/release/claude-buddy --help

Usage

Check a UUID

claude-buddy check <uuid>

🎲 Companion roll for UUID:

      ,>
   .-o-OO-o-.
  (__________)
     |·  ·|
     |____|
  ★★★★★ LEGENDARY  |  Species: mushroom  |  Eye: ·  Hat: tinyduck  |  Total: 333/500
  DEBUGGING: 48↓  PATIENCE:100↑  CHAOS: 53   WISDOM: 51   SNARK: 81
  UUID: b70c9f0e-fb7d-4fc8-847e-fd53864efdd1

Search for specific companions

# Find shiny legendary dragons
claude-buddy search --rarity legendary --shiny --species dragon --count 5 --max 50000000

# Find any legendary with high stats
claude-buddy search --rarity legendary --min-total 400 --count 10

# Find a crowned epic axolotl
claude-buddy search --rarity epic --species axolotl --hat crown --count 3

All search filters

Flag	Description
--rarity	common, uncommon, rare, epic, legendary
--species	duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk
--shiny	Must be shiny (1% chance on top of rarity)
--eye	Eye style: · ✦ × ◉ @ °
--hat	none, crown, tophat, propeller, halo, wizard, beanie, tinyduck
--peak	Peak stat: DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK
--dump	Dump stat
--min-total	Minimum total stats (max 500)
--count	Number of results (default 5)
--max	Max UUIDs to test (default 10,000,000)

Applying a result

1. Find your config: ~/.claude.json
2. Set oauthAccount.accountUuid to the UUID from search results
3. Restart Claude Code

Re-authenticating will overwrite the UUID back to your real one.

How it works

Claude Code's buddy system seeds a Mulberry32 PRNG with wyhash(userId + "friend-2026-401"), then deterministically rolls rarity, species, eyes, hat, shiny status, and stats from that sequence.

Rarity weights

Rarity	Weight	Chance
Common	60	60%
Uncommon	25	25%
Rare	10	10%
Epic	4	4%
Legendary	1	1%

Shiny is an independent 1% roll. A shiny legendary is 0.01%.

Performance

Uses rayon for parallel search. ~100M UUIDs/sec on Apple Silicon.

Hash compatibility

This tool implements Bun's exact wyhash (Zig stdlib std.hash.Wyhash, final version 4) to produce identical results to Claude Code's runtime. Verified against Bun 1.3.11.

License

MIT