Prompt Creatures

A virtual pet for your Claude Code sessions. Every prompt you send feeds your creature. Stop coding and it gets hungry. Let it starve for a week and it dies.

  🐱  Whiskers  Lv4  ██████████  82% fed  ·  46 prompts → elder

Install

Requires Node.js 20+ and Claude Code.

npm install -g prompt-creatures
pc --install

--install writes a Claude Code Stop hook that runs automatically after every prompt. You never need to think about it again.

How it works

• Each Claude Code prompt feeds your creature +12 hunger
• Hunger decays at 3/hour while you're not coding
• Starve it for 7 days and it dies
• Survive long enough and it evolves: egg → baby → adult → elder
• Elders eventually lay a new egg and retire

Commands

pc --creature    Show your creature's stats
pc --view        Open the live terminal viewer
pc --register    Unlock multiplayer battles
pc --local       Switch back to local mode
pc --install     (Re)install the Stop hook
pc --help        Show all commands

Multiplayer

Register at promptcreatures.fun to battle other players' creatures on the world map. Your creature's stats (ATK, DEF, SPD) are rolled when it hatches — each one is unique.

pc --register

Follow the prompt, paste your token, and you're in.

Local mode

No account needed. Your creature lives in ~/.prompt-creatures/creature.json. Everything stays on your machine.

Uninstall

npm uninstall -g prompt-creatures

Then remove the hook entry from ~/.claude/settings.json (look for the line referencing feed-hook.cjs).

---

Built to make coding feel alive.