Tokamon — Development skill for Claude Code

tokamon

**A tiny pet that lives in your Claude Code status line and feeds on your tokens.**


Your tokamon sits next to your usage stats and reacts to your session. It starts out bouncy, gets `$` eyes as the bill climbs, side-eyes you as your usage limit runs low, and keels over when you hit it. It fidgets while Claude works, bosses subagents around, and falls asleep when you walk away.

Install

You need [Claude Code](https://claude.com/claude-code), `jq` and `bash` (macOS, Linux, or WSL on Windows).

curl -fsSL https://raw.githubusercontent.com/fidelisakilan/tokamon/main/install.sh | bash

This copies `statusline.sh` to `~/.claude/` and adds the status line and four hooks to `~/.claude/settings.json`, keeping everything else in it. Your old settings are saved to `settings.json.bak`, and running it again is safe.

Manual install

curl -o ~/.claude/statusline.sh https://raw.githubusercontent.com/fidelisakilan/tokamon/main/statusline.sh
chmod +x ~/.claude/statusline.sh

Then add to `~/.claude/settings.json`, merging with any hooks you already have:

{
  "statusLine": { "type": "command", "command": "~/.claude/statusline.sh", "refreshInterval": 1 },
  "hooks": {
    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "~/.claude/statusline.sh busy" }] }],
    "Stop":             [{ "hooks": [{ "type": "command", "command": "~/.claude/statusline.sh idle" }] }],
    "SubagentStart":    [{ "hooks": [{ "type": "command", "command": "~/.claude/statusline.sh agent-start" }] }],
    "SubagentStop":     [{ "hooks": [{ "type": "command", "command": "~/.claude/statusline.sh agent-stop" }] }]
  }
}

Your tokamon hatches on the next redraw.

Moods


When several apply, the first match wins.

Face	Mood	When
(x_x)	dead	5h or 7d limit hit 100%