buddy-reroll

Pick the perfect Claude Code /buddy companion — any species, rarity, eye, hat, shiny, and stat combination you want.

_._.s.video.mp4

Install

# Bun (recommended)
bun install -g buddy-reroll

# npm
npm install -g buddy-reroll

# No install needed
npx buddy-reroll

Bun gives the speediest experience, but Node.js >= 20 works just as well.

Usage

# Interactive — pick your buddy step by step
buddy-reroll

# Know what you want? Go direct
buddy-reroll --species dragon --rarity legendary --eye ✦ --hat propeller --shiny

# Just pick a few things, leave the rest to chance
buddy-reroll --species cat --rarity epic

# Choose your buddy's strengths
buddy-reroll --peak WISDOM --dump CHAOS

# See what's available
buddy-reroll --list

# Check your current buddy
buddy-reroll --current

# Keep your buddy after Claude updates
buddy-reroll --hook

# Stop keeping after updates
buddy-reroll --unhook

# Something wrong? Check your setup
buddy-reroll --doctor

# Undo everything
buddy-reroll --restore

Options

Flag	Values
--species	duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk
--rarity	common, uncommon, rare, epic, legendary
--eye	· ✦ × ◉ @ °
--hat	none, crown, tophat, propeller, halo, wizard, beanie, tinyduck
--shiny	--shiny / --no-shiny
--peak	Best stat — DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK
--dump	Weakest stat (can't match --peak)
--list	See all options
--current	Show your current buddy
--restore	Undo changes and go back to default
--doctor	Check if everything is set up right
--hook	Keep your buddy after Claude Code updates
--unhook	Stop keeping after updates
--version, -v	Print version

Keeping your buddy

Claude Code updates can reset your companion. --hook tells Claude to automatically restore your buddy every time it starts up.

buddy-reroll --hook    # set it up once
buddy-reroll --unhook  # remove whenever you want

How fast is it?

buddy-reroll uses all your CPU cores (up to 8) to find the right companion. Bun is a bit faster because of its native hashing, but both runtimes produce identical results.

Runtime	Speed	Notes
Bun	Faster	Recommended
Node.js >= 20	Slightly slower	Works great too

Requirements

• Node.js >= 20 or Bun
• Claude Code

Troubleshooting

buddy-reroll --doctor

This checks your setup — where Claude is installed, whether buddy-reroll can write to it, and what to do next if something's off.

If Claude was installed system-wide and isn't writable, you can point to a different location:

CLAUDE_BINARY_PATH=/path/to/claude buddy-reroll --doctor

License

MIT