fidelisakilan

Tokamon — Development skill for Claude Code

Development community

A pet for your Claude Code status line whose mood tracks your tokens, cost and usage limits.

How to install Tokamon

This entry records only its repository, not the path inside it, so there is no exact command to give. Open fidelisakilan/tokamon and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tokamon does

A pet for your Claude Code status line whose mood tracks your tokens, cost and usage limits.

Alternatives in Development

10 Statusline Setup Agent — Status Line Setup Agent System Prompt 2.3k ★
Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
Claude Auto Resume — A shell script utility that automatically resumes Claude CLI tasks when usage limits are lifted 732 ★

README

tokamon

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

![tokamon in the Claude Code status line](screenshots/default.png)

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.