tokenmonsters
v0.1.3
Published
Your AI tokens are feeding something.
Readme
Token Monsters
Your AI tokens are feeding something.
A terminal creature that lives off your AI coding tool usage. Every token you spend feeds it. Neglect it and it starves. Keep coding and watch it grow.
Quick Start
npx tokenmonsters
Requirements
- Bun runtime —
curl -fsSL https://bun.sh/install | bash - GPU-accelerated terminal: Ghostty, Alacritty, Kitty, or WezTerm
If you have Ghostty installed, tokenmonsters will auto-launch in it. Otherwise, run from a supported terminal directly.
Supported AI Tools
Token usage is automatically detected from:
- Claude Code (Anthropic)
- Codex CLI (OpenAI)
- OpenCode
Just use your AI tools as normal. tokenmonsters watches for token activity in the background.
Controls
| Key | Action |
|-----|--------|
| e | New egg |
| p | Party — switch active monster |
| r | Registry — species index |
| i / tab | Info screen |
| t | Cycle theme |
| m | Toggle sound |
| q | Quit |
How It Works
- Install and run
tokenmonsters - Your first egg is generated automatically
- Use any supported AI coding tool — tokens feed your monster
- Monsters hatch, evolve, and grow through stages: egg, hatchling, prime, apex
- Keep up to 10 monsters in your party — only the active one receives XP
- Neglected monsters lose hunger and happiness over time
Themes
5 built-in themes: Midnight, Catppuccin, Phosphor, Dracula, Flexoki. Press t to cycle.
