Claude Buddy Hatchery

Claude Buddy Hatchery

A reverse-engineered reimplementation of the [Claude Code](https://docs.anthropic.com/en/docs/claude-code) companion hatching algorithm. Explore the buddy system, hunt for rare companions, or crack an ID that gives you the exact buddy you want.

English | [中文](./README.zh-CN.md)

Quick Start

curl -fsSL https://raw.githubusercontent.com/cminn10/claude-buddy-hatchery/main/hatch.py -o hatch.py
python3 hatch.py --crack          # interactive mode — pick your dream buddy
python3 hatch.py --hunt           # explore random rare companions
python3 hatch.py                  # hatch a random buddy

  ┌────────────────────────────────────────┐
  │ ★★★★★ LEGENDARY         DRAGON        │
  │                                        │
  │                  -+-                    │
  │                /^\  /^\                 │
  │               <  ×  ×  >               │
  │               (   ~~   )               │
  │                `-vvvv-´                 │
  │                                        │
  │  Biscuit                               │
  │  "A legendary dragon of few words."    │
  │  ✨ SHINY ✨                            │
  │                                        │
  │  DEBUGGING  ███████░░░  69             │
  │  PATIENCE   █████░░░░░  53             │
  │  CHAOS      ███████░░░  74             │
  │  WISDOM     ████████░░  79             │
  │  SNARK      ██████████ 100             │
  └────────────────────────────────────────┘

How It Works

Claude Code 2.1.89 introduced `/buddy` — a virtual companion that lives in your terminal. The companion's traits (species, rarity, stats, etc.) are **deterministically derived from your account identity**, not random per hatch.

The algorithm chain:

account ID + "friend-2026-401"  →  Bun.hash (wyhash)  →  32-bit seed
                                                              ↓
                                                        SplitMix32 PRNG