any-buddy

Node version

Pick any Claude Code companion pet you want. Choose your species, rarity, eyes, hat, and name.

Quick Start

npx any-buddy@latest

That's it. If Bun is installed, you get the full interactive builder with live preview. Otherwise you'll see sequential prompts with a note to install Bun.

Interactive Builder

The builder lets you browse species, eyes, rarity, hats, and stats with a live ASCII art preview that updates as you scroll. Navigate with arrow keys, Tab/Enter to advance, Esc to cancel.

Install

# npm (global)
npm install -g any-buddy

# or clone
git clone https://github.com/cpaczek/any-buddy.git
cd any-buddy && pnpm install && pnpm link --global

Requirements

Node.js >= 20
Bun -- for the interactive builder TUI and correct hash computation (typically already installed with Claude Code). Without Bun, the tool falls back to basic sequential prompts.
Claude Code -- installed via any standard method

Platform Support

Platform	Status	Notes
Linux	Tested	Auto-detects `~/.local/share/claude/versions/`
macOS	Tested	Auto-detects + ad-hoc re-signs after patching
Windows	Tested	Works with npm-based installs (`cli.js`)

Set CLAUDE_BINARY=/path/to/binary if auto-detection fails.

Usage

any-buddy                    # Start screen — build, browse presets, or switch buddies

The start screen lets you pick between:

Build your own — full interactive builder with live ASCII preview
Browse presets — 23 curated themed builds with animated preview
Saved buddies — switch between your saved pets (shown when you have saves)

After picking your pet, the entire flow stays in the TUI — salt search with progress bar, naming, personality, patching, and hook setup.

any-buddy current            # Show your current pet
any-buddy preview            # Browse without applying
any-buddy apply              # Re-apply after Claude Code update
any-buddy restore            # Restore original pet
any-buddy buddies            # Browse and switch between your buddies
any-buddy rehatch            # Delete companion, re-hatch via /buddy

Non-Interactive Mode

Skip prompts with flags (bypasses the start screen):

any-buddy -s dragon -r legendary -e '✦' -t wizard --shiny --name Draco -y
any-buddy --preset "Arcane Dragon" -y

All CLI Flags

Flag	Short	Description
`--species <name>`	`-s`	Species (duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk)
`--rarity <level>`	`-r`	Rarity (common, uncommon, rare, epic, legendary)
`--eye <char>`	`-e`	Eye style (`· ✦ × ◉ @ °`)
`--hat <name>`	`-t`	Hat (crown, tophat, propeller, halo, wizard, beanie, tinyduck)
`--preset <name>`		Use a curated preset (e.g., "Arcane Dragon")
`--name <name>`	`-n`	Rename companion
`--personality <desc>`	`-p`	Set personality (controls speech bubble)
`--shiny`		Require shiny (~100x longer search)
`--peak <stat>`		Best stat (DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK)
`--dump <stat>`		Worst stat
`--yes`	`-y`	Skip confirmations
`--no-hook`		Don't offer auto-patch hook
`--silent`		Suppress output (for hooks)

All 18 Species

All 18 species

Customization Options

Customization options

Restoring

any-buddy restore

Patches the salt back to original and removes the auto-patch hook. Your saved buddies are preserved — use any-buddy buddies to reactivate one later.

How It Works

See HOW_IT_WORKS.md for the full technical deep-dive on hashing, binary patching, the salt search algorithm, and the auto-patch hook.

Known Limitations

macOS: Binary is ad-hoc re-signed after patching. If Claude Code won't launch, run any-buddy restore
Bun recommended: Required for the interactive builder and correct wyhash computation. Without Bun, falls back to sequential prompts with FNV-1a (Node-based installs)
Salt dependent: If Anthropic changes the salt string, the tool will detect this and warn you
Stats: You pick peak/dump stats, but exact values are seed-determined

Contributing

See CONTRIBUTING.md for development setup, project structure, and how to submit changes.

Credits

@jtuskan -- Windows support for npm-based installs (#5)
@aaronepinto -- macOS ad-hoc code signing (#3)
@joshpocock -- FNV-1a hash support for Node runtime (#8)
@Co-Messi -- Multi-worker parallelism + early-exit optimization (#11), curated preset builds (#15)
@Ahmad8864 -- 8-core cap idea (#10), buddy profiles (#17)

License

WTFPL -- Do What The Fuck You Want To Public License.