GET THE CLI

Install the Claudemon wrapper and start catching creatures in 2 minutes.

REQUIREMENTS

Claude Code installed and working on your machine.

A Claudemon account. Create one here if you haven't already.

An API key — generate one from your dashboard after signing in.

INSTALL

Clone the repo and run the setup script. That's it.

# clone the catcher

$ git clone https://github.com/zwykstudio/claudemon-catcher.git

$ cd claudemon-catcher

$ ./install/setup.sh

The script aliases cc to the Claudemon wrapper. Your original claude command stays untouched.

CONFIGURATION

Export your API key so the wrapper can send catches to the Claudemon server. You'll find it in your dashboard under API Key.

# add to your .bashrc / .zshrc

$ export CLAUDEMON_API_KEY=sk_claudemon_...

Restart your terminal or run source ~/.zshrc to apply.

HOW IT WORKS

The wrapper cc is a thin shell around Claude Code. When you run it, it starts Claude normally and watches its output for spinner words — those little status messages Claude shows while thinking.

Intercepts the spinner. The wrapper captures every word Claude displays in its thinking indicator.

Sends them to the API. Caught words are sent to the Claudemon server, which creates eggs, awards XP, and tracks your progress.

Nothing magical. Nothing hidden. The code is open source — read it yourself.

WHAT IT DOES NOT DO

No access to your files. The wrapper only reads Claude's spinner output, nothing else.

No modification of Claude. Claude Code runs exactly the same. The wrapper is a pass-through.

No hidden telemetry. The only data sent is the spinner words + your API key. That's it.

If you don't trust us (fair enough), read the source. It's ~200 lines of bash.

Star it if you like it. Fork it if you want.