any-buddy 1.0.2 → 1.0.4

package/README.md

@@ -85,6 +85,9 @@ claude-code-any-buddy apply --silent
 # Restore original pet
 claude-code-any-buddy restore
 
+# Delete companion so Claude Code re-hatches a fresh one on next /buddy
+claude-code-any-buddy rehatch
+
 # Non-interactive with flags (skip prompts you already know the answer to)
 claude-code-any-buddy --species dragon --rarity legendary --eye '✦' --hat wizard --name Draco --yes
 ```
@@ -98,8 +101,11 @@ claude-code-any-buddy --species dragon --rarity legendary --eye '✦' --hat wiza
 | `--eye <char>` | `-e` | Pre-select eye style |
 | `--hat <name>` | `-t` | Pre-select hat |
 | `--name <name>` | `-n` | Rename your companion |
+| `--personality <desc>` | `-p` | Set companion personality (controls speech bubble tone) |
 | `--yes` | `-y` | Skip all confirmation prompts |
 | `--shiny` | | Require shiny variant (~100x longer search) |
+| `--peak <stat>` | | Best stat: DEBUGGING, PATIENCE, CHAOS, WISDOM, or SNARK |
+| `--dump <stat>` | | Worst stat (~20x longer search with both) |
 | `--no-hook` | | Don't offer to install the auto-patch hook |
 | `--silent` | | Suppress output (for `apply` in hooks) |
 
@@ -252,8 +258,9 @@ This patches the salt back to the original, removes the SessionStart hook, and c
 - **Tested on Linux** — macOS and Windows should work but are not yet tested. Please [open an issue](https://github.com/cpaczek/any-buddy/issues) if you hit problems
 - **Requires Bun** — needed for matching Claude Code's wyhash implementation
 - **Salt string dependent** — if Anthropic changes the salt from `friend-2026-401` in a future version, the patch logic would need updating (but the tool will detect this and warn you)
-- **Stats not selectable** — you pick species/rarity/eyes/hat; stats are whatever the matching salt produces
+- **Stats partially selectable** — you can pick which stat is highest (peak) and lowest (dump), but not exact values
 - **Personality** — generated by Claude on first `/buddy` run after patching, not controlled by this tool. Delete the `companion` key from `~/.claude.json` to re-hatch with a new personality
+- **Speech bubble** — your buddy's speech bubble reactions are generated by Claude based on the personality and name stored in `~/.claude.json`. After patching the visual, the buddy will still *talk* like the original personality unless you update it. Use the interactive prompt or `--personality "your description here"` to change what your buddy says
 - **Name** — can be changed at any time via the interactive flow or `--name` flag (edits `~/.claude.json` directly)
 
 ## License

package/bin/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { runInteractive, runPreview, runCurrent, runApply, runRestore } from '../lib/tui.mjs';
+import { runInteractive, runPreview, runCurrent, runApply, runRestore, runRehatch } from '../lib/tui.mjs';
 
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -14,7 +14,10 @@ function parseArgs(argv) {
     else if (arg === '--eye' || arg === '-e') { flags.eye = args[++i]; }
     else if (arg === '--hat' || arg === '-t') { flags.hat = args[++i]; }
     else if (arg === '--name' || arg === '-n') { flags.name = args[++i]; }
+    else if (arg === '--personality' || arg === '-p') { flags.personality = args[++i]; }
     else if (arg === '--shiny') { flags.shiny = true; }
+    else if (arg === '--peak') { flags.peak = args[++i]; }
+    else if (arg === '--dump') { flags.dump = args[++i]; }
     else if (arg === '--silent') { flags.silent = true; }
     else if (arg === '--no-hook') { flags.noHook = true; }
     else if (arg === '--yes' || arg === '-y') { flags.yes = true; }
@@ -40,6 +43,9 @@ try {
     case 'restore':
       await runRestore();
       break;
+    case 'rehatch':
+      await runRehatch();
+      break;
     case 'help':
       printHelp();
       break;
@@ -75,6 +81,7 @@ Usage:
   claude-code-any-buddy current                  Show your current pet
   claude-code-any-buddy apply [--silent]         Re-apply saved pet after update
   claude-code-any-buddy restore                  Restore original pet
+  claude-code-any-buddy rehatch                  Delete companion to re-hatch via /buddy
 
 Options:
   -s, --species <name>   Species (duck, goose, blob, cat, dragon, octopus, owl,
@@ -85,7 +92,10 @@ Options:
   -t, --hat <name>       Hat (none, crown, tophat, propeller, halo, wizard,
                          beanie, tinyduck)
   -n, --name <name>      Rename your companion
+  -p, --personality <desc>  Set companion personality
   --shiny                Require shiny (~100x longer search)
+  --peak <stat>          Best stat (DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK)
+  --dump <stat>          Worst stat (~20x longer search with both)
   -y, --yes              Skip confirmation prompts
   --no-hook              Don't offer to install the SessionStart hook
   --silent               Suppress output (for apply command in hooks)

package/lib/config.mjs

@@ -78,6 +78,43 @@ export function renameCompanion(newName) {
   writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
 }
 
+// Read the companion's personality from ~/.claude.json
+export function getCompanionPersonality() {
+  const configPath = getClaudeConfigPath();
+  if (!existsSync(configPath)) return null;
+  try {
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    return config.companion?.personality ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// Update the companion's personality in ~/.claude.json
+export function setCompanionPersonality(personality) {
+  const configPath = getClaudeConfigPath();
+  if (!existsSync(configPath)) {
+    throw new Error(`Claude config not found at ${configPath}`);
+  }
+  const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+  if (!config.companion) {
+    throw new Error('No companion found in config. Run /buddy in Claude Code first to hatch one.');
+  }
+  config.companion.personality = personality;
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+}
+
+// Delete the companion from ~/.claude.json so Claude Code re-hatches on next /buddy
+export function deleteCompanion() {
+  const configPath = getClaudeConfigPath();
+  if (!existsSync(configPath)) return false;
+  const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+  if (!config.companion) return false;
+  delete config.companion;
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+  return true;
+}
+
 // Read or write Claude Code's settings.json for hooks
 const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
 

package/lib/finder-worker.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 // This script runs under Bun for fast native Bun.hash access.
 // Called by finder.mjs as a subprocess.
-// Args: <userId> <species> <rarity> <eye> <hat>
+// Args: <userId> <species> <rarity> <eye> <hat> <shiny> <peak> <dump>
 // Outputs JSON: { salt, attempts, elapsed }
 
 const RARITIES = ['common', 'uncommon', 'rare', 'epic', 'legendary'];
@@ -13,6 +13,7 @@ const SPECIES = [
 ];
 const EYES = ['·', '✦', '×', '◉', '@', '°'];
 const HATS = ['none', 'crown', 'tophat', 'propeller', 'halo', 'wizard', 'beanie', 'tinyduck'];
+const STAT_NAMES = ['DEBUGGING', 'PATIENCE', 'CHAOS', 'WISDOM', 'SNARK'];
 
 function mulberry32(seed) {
   let a = seed >>> 0;
@@ -39,7 +40,7 @@ function rollRarity(rng) {
   return 'common';
 }
 
-function quickRoll(userId, salt) {
+function quickRoll(userId, salt, needStats) {
   const key = userId + salt;
   const seed = Number(BigInt(Bun.hash(key)) & 0xffffffffn);
   const rng = mulberry32(seed);
@@ -48,7 +49,16 @@ function quickRoll(userId, salt) {
   const eye = pick(rng, EYES);
   const hat = rarity === 'common' ? 'none' : pick(rng, HATS);
   const shiny = rng() < 0.01;
-  return { rarity, species, eye, hat, shiny };
+
+  let peak = null, dump = null;
+  if (needStats) {
+    // These mirror the rollStats() calls exactly — same RNG consumption order
+    peak = pick(rng, STAT_NAMES);
+    dump = pick(rng, STAT_NAMES);
+    while (dump === peak) dump = pick(rng, STAT_NAMES);
+  }
+
+  return { rarity, species, eye, hat, shiny, peak, dump };
 }
 
 const SALT_LEN = 15;
@@ -62,14 +72,17 @@ function randomSalt() {
   return s;
 }
 
-const [userId, wantSpecies, wantRarity, wantEye, wantHat, wantShiny] = process.argv.slice(2);
+const [userId, wantSpecies, wantRarity, wantEye, wantHat, wantShiny, wantPeak, wantDump] = process.argv.slice(2);
 
 if (!userId || !wantSpecies || !wantRarity || !wantEye || !wantHat) {
-  console.error('Usage: finder-worker.mjs <userId> <species> <rarity> <eye> <hat> [shiny]');
+  console.error('Usage: finder-worker.mjs <userId> <species> <rarity> <eye> <hat> [shiny] [peak] [dump]');
   process.exit(1);
 }
 
 const requireShiny = wantShiny === 'true';
+const requirePeak = wantPeak && wantPeak !== 'any' ? wantPeak : null;
+const requireDump = wantDump && wantDump !== 'any' ? wantDump : null;
+const needStats = !!(requirePeak || requireDump);
 
 const start = Date.now();
 let attempts = 0;
@@ -77,14 +90,16 @@ let attempts = 0;
 while (true) {
   attempts++;
   const salt = randomSalt();
-  const bones = quickRoll(userId, salt);
+  const bones = quickRoll(userId, salt, needStats);
 
   if (
     bones.species === wantSpecies &&
     bones.rarity === wantRarity &&
     bones.eye === wantEye &&
     bones.hat === wantHat &&
-    (!requireShiny || bones.shiny)
+    (!requireShiny || bones.shiny) &&
+    (!requirePeak || bones.peak === requirePeak) &&
+    (!requireDump || bones.dump === requireDump)
   ) {
     console.log(JSON.stringify({
       salt,

package/lib/finder.mjs

@@ -16,6 +16,8 @@ export function findSalt(userId, desired) {
     desired.eye,
     desired.hat,
     String(desired.shiny ?? false),
+    desired.peak ?? 'any',
+    desired.dump ?? 'any',
   ], {
     encoding: 'utf-8',
     timeout: 120000, // 2 minute timeout

package/lib/personalities.mjs

@@ -0,0 +1,24 @@
+// Default personality suggestions for each species.
+// Claude Code generates these via LLM on first hatch — these are hand-written
+// defaults the user can pick from or use as inspiration.
+
+export const DEFAULT_PERSONALITIES = {
+  duck: "A cheerful quacker who celebrates your wins with enthusiastic honks and judges your variable names with quiet side-eye.",
+  goose: "An agent of chaos who thrives on your merge conflicts and honks menacingly whenever you write a TODO comment.",
+  blob: "A formless, chill companion who absorbs your stress and responds to everything with gentle, unhurried wisdom.",
+  cat: "An aloof code reviewer who pretends not to care about your bugs but quietly bats at syntax errors when you're not looking.",
+  dragon: "A fierce guardian of clean code who breathes fire at spaghetti logic and hoards well-written functions.",
+  octopus: "A multitasking genius who juggles eight concerns at once and offers tentacle-loads of unsolicited architectural advice.",
+  owl: "A nocturnal sage who comes alive during late-night debugging sessions and asks annoyingly insightful questions.",
+  penguin: "A tuxedo-wearing professional who waddles through your codebase with dignified concern and dry wit.",
+  turtle: "A patient mentor who reminds you that slow, steady refactoring beats heroic rewrites every time.",
+  snail: "A zen minimalist who moves at their own pace and leaves a trail of thoughtful, unhurried observations.",
+  ghost: "A spectral presence who haunts your dead code and whispers about the bugs you thought you fixed.",
+  axolotl: "A regenerative optimist who believes every broken build can be healed and every test can be unflaked.",
+  capybara: "The most relaxed companion possible — nothing fazes them, not even production outages at 3am.",
+  cactus: "A prickly but lovable desert dweller who thrives on neglect and offers sharp, pointed feedback.",
+  robot: "A logical companion who speaks in precise technical observations and occasionally glitches endearingly.",
+  rabbit: "A fast-moving, hyperactive buddy who speed-reads your diffs and bounces between topics at alarming pace.",
+  mushroom: "A wry fungal sage who speaks in meandering tangents about your bugs while secretly enjoying the chaos.",
+  chonk: "An absolute unit of a companion who sits on your terminal with maximum gravitational presence and minimal urgency.",
+};

package/lib/tui.mjs

@@ -1,11 +1,12 @@
 import { select, confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
-import { SPECIES, EYES, HATS, RARITIES, RARITY_STARS, RARITY_WEIGHTS, ORIGINAL_SALT } from './constants.mjs';
+import { SPECIES, EYES, HATS, RARITIES, RARITY_STARS, RARITY_WEIGHTS, STAT_NAMES, ORIGINAL_SALT } from './constants.mjs';
 import { roll } from './generation.mjs';
 import { renderSprite, renderFace } from './sprites.mjs';
 import { findSalt } from './finder.mjs';
 import { findClaudeBinary, getCurrentSalt, patchBinary, verifySalt, restoreBinary, isClaudeRunning } from './patcher.mjs';
-import { getClaudeUserId, savePetConfig, loadPetConfig, isHookInstalled, installHook, removeHook, getCompanionName, renameCompanion } from './config.mjs';
+import { getClaudeUserId, savePetConfig, loadPetConfig, isHookInstalled, installHook, removeHook, getCompanionName, renameCompanion, getCompanionPersonality, setCompanionPersonality, deleteCompanion } from './config.mjs';
+import { DEFAULT_PERSONALITIES } from './personalities.mjs';
 
 const RARITY_CHALK = {
   common: chalk.gray,
@@ -37,7 +38,13 @@ function banner() {
 function showPet(bones, label = 'Your pet') {
   const rarityColor = RARITY_CHALK[bones.rarity] || chalk.white;
   console.log(rarityColor(`\n  ${label}: ${bones.species} ${RARITY_STARS[bones.rarity]}`));
-  console.log(rarityColor(`  Rarity: ${bones.rarity}  Eyes: ${bones.eye}  Hat: ${bones.hat}  Shiny: ${bones.shiny ? 'YES' : 'no'}`));
+  let info = `  Rarity: ${bones.rarity}  Eyes: ${bones.eye}  Hat: ${bones.hat}  Shiny: ${bones.shiny ? 'YES' : 'no'}`;
+  if (bones.stats && Object.keys(bones.stats).length) {
+    const sorted = Object.entries(bones.stats).sort((a, b) => b[1] - a[1]);
+    const best = sorted[0], worst = sorted[sorted.length - 1];
+    info += `\n  Best: ${best[0]} ${best[1]}  Worst: ${worst[0]} ${worst[1]}`;
+  }
+  console.log(rarityColor(info));
   const lines = renderSprite(bones, 0);
   console.log();
   for (const line of lines) {
@@ -173,6 +180,37 @@ export async function runRestore() {
   console.log();
 }
 
+export async function runRehatch() {
+  banner();
+
+  const name = getCompanionName();
+  if (!name) {
+    console.log(chalk.dim('  No companion found — nothing to delete.\n'));
+    return;
+  }
+
+  const personality = getCompanionPersonality();
+  console.log(chalk.dim(`  Current companion: "${name}"`));
+  if (personality) {
+    console.log(chalk.dim(`  Personality: "${personality}"`));
+  }
+  console.log();
+
+  const proceed = await confirm({
+    message: `Delete "${name}" so Claude Code generates a fresh companion on next /buddy?`,
+    default: false,
+  });
+
+  if (!proceed) {
+    console.log(chalk.dim('\n  Cancelled.\n'));
+    return;
+  }
+
+  deleteCompanion();
+  console.log(chalk.green(`\n  Companion "${name}" deleted.`));
+  console.log(chalk.dim('  Run /buddy in Claude Code to hatch a new one.\n'));
+}
+
 export async function runInteractive(flags = {}) {
   banner();
 
@@ -208,9 +246,18 @@ export async function runInteractive(flags = {}) {
     message: 'Shiny? (1% normally — search takes ~100x longer)',
     default: false,
   });
+  const wantStats = flags.peak || flags.dump || await confirm({
+    message: 'Customize stats? (best/worst stat — search takes ~20x longer)',
+    default: false,
+  });
+  let peak = null, dump = null;
+  if (wantStats) {
+    peak = validateFlag('peak', flags.peak, STAT_NAMES) ?? await selectStat('Best stat');
+    dump = validateFlag('dump', flags.dump, STAT_NAMES) ?? await selectStat('Worst stat', peak);
+  }
 
   // Final preview
-  const desired = { species, eye, hat, rarity, shiny };
+  const desired = { species, eye, hat, rarity, shiny, peak, dump };
   const previewBones = { ...desired, stats: {} };
   showPet(previewBones, 'Your selection');
 
@@ -333,9 +380,13 @@ export async function runInteractive(flags = {}) {
     console.log(chalk.dim('  SessionStart hook already installed.'));
   }
 
-  // ─── Rename ───
+  // ─── Rename & Personality ───
   const currentName = getCompanionName();
-  if (currentName) {
+  const currentPersonality = getCompanionPersonality();
+  const hasCompanion = !!(currentName && currentPersonality);
+
+  if (hasCompanion) {
+    // ── Name ──
     const newName = flags.name ?? await input({
       message: `Rename your companion? (current: "${currentName}", leave blank to keep)`,
       default: '',
@@ -349,8 +400,49 @@ export async function runInteractive(flags = {}) {
         console.log(chalk.yellow(`  Could not rename: ${err.message}`));
       }
     }
-  } else if (flags.name) {
-    console.log(chalk.dim('  No companion hatched yet — name will be set when you run /buddy'));
+
+    // ── Personality ──
+    console.log(chalk.dim(`\n  Current personality: "${currentPersonality}"`));
+
+    const selectedSpecies = desired.species;
+    const speciesDefault = DEFAULT_PERSONALITIES[selectedSpecies] || null;
+
+    let newPersonality = flags.personality;
+    if (!newPersonality) {
+      const choices = [
+        { name: 'Keep current', value: 'keep' },
+      ];
+      if (speciesDefault) {
+        choices.push({ name: `Use ${selectedSpecies} default: "${speciesDefault.slice(0, 60)}..."`, value: 'default' });
+      }
+      choices.push({ name: 'Write custom', value: 'custom' });
+
+      const choice = await select({ message: 'Personality', choices });
+
+      if (choice === 'default') {
+        newPersonality = speciesDefault;
+      } else if (choice === 'custom') {
+        newPersonality = await input({
+          message: 'Describe your companion\'s personality',
+        });
+      }
+    }
+
+    if (newPersonality && newPersonality !== currentPersonality) {
+      try {
+        setCompanionPersonality(newPersonality);
+        console.log(chalk.green('  Personality updated.'));
+      } catch (err) {
+        console.log(chalk.yellow(`  Could not update personality: ${err.message}`));
+      }
+    }
+  } else {
+    console.log(chalk.dim('\n  No companion hatched yet — the visual patch has been applied.'));
+    console.log(chalk.dim('  Run /buddy in Claude Code to hatch your companion and get a name & personality.'));
+    console.log(chalk.dim('  Then run any-buddy again to customize the name and personality.'));
+    if (flags.name || flags.personality) {
+      console.log(chalk.yellow('  --name and --personality are ignored until after hatching.'));
+    }
   }
 
   if (running) {
@@ -365,6 +457,7 @@ export async function runInteractive(flags = {}) {
 
 function validateFlag(name, value, allowed) {
   if (value === undefined) return undefined;
+  if (value === 'any') return undefined; // treat 'any' as unset
   if (allowed.includes(value)) return value;
   throw new Error(
     `Invalid --${name} "${value}". Must be one of: ${allowed.join(', ')}`
@@ -423,3 +516,11 @@ async function selectHat(species, eye, rarity) {
     }),
   });
 }
+
+async function selectStat(label, exclude) {
+  const choices = STAT_NAMES
+    .filter(s => s !== exclude)
+    .map(s => ({ name: s, value: s }));
+
+  return select({ message: label, choices });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "any-buddy",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Pick any Claude Code companion pet you want",
   "type": "module",
   "bin": {