🪙 Token Catcher

A tiny retro browser game you play while your Claude Code agent works — it nudges you back the moment Claude finishes.

What it is

You know that little stretch where your agent is off thinking, running tools, and editing files? Too short to start something real, too long to just stare at the spinner. Token Catcher fills it.

Run it, and a retro arcade game pops open in your browser: catch the falling tokens, dodge the bugs, chase a high score. When your agent finishes its work, the game pings you — so you never miss the "it's done" moment, and you never have to babysit the terminal again.

It's small and a little silly, on purpose. Turns dead time into a tiny bit of fun.

Quick start

No install needed — this works for everyone:

npx token-catcher setup   # wire it into Claude Code
# restart Claude Code so it picks up the new hooks
npx token-catcher         # play, anytime

That's it. Once setup is done, just run npx token-catcher whenever you want to play.

Optional: install globally for a shorter command

If you'd rather type token-catcher instead of npx token-catcher, you can install it globally:

npm install -g token-catcher   # on macOS you may need: sudo npm install -g token-catcher
                               # (sudo will ask for your Mac password)
token-catcher setup            # wire it into Claude Code
# restart Claude Code so it picks up the new hooks
token-catcher                  # play, anytime

The commands

| Command | What it does | | --- | --- | | token-catcher setup | One-time setup. Installs two small Claude Code hooks so the game knows when your agent starts and finishes. Restart Claude Code afterward. | | token-catcher | Launches the game in your browser. Play while the agent works — when it's done, you get the ping. | | token-catcher remove | Cleanly uninstalls the hooks. Your other Claude Code settings are left untouched. |

How it works

Token Catcher uses Claude Code hooks. setup drops two little scripts into your ~/.claude config:

• one fires when you submit a prompt (your agent starts) → the game knows you're waiting,
• one fires when the agent stops (your agent finishes) → the game pings you.

That's the whole trick. The game runs locally in your browser; the hooks just tell it when to start and when to celebrate. remove takes both hooks back out and leaves everything else exactly as it was.

Requirements

• Node.js (v14 or newer)
• Claude Code

Credits

Made by Nadine the Builder.

High score > inbox zero. 🕹️