claude-code-mascot-statusline

Claude Code Mascot

A pixel-sprite mascot that lives in your Claude Code status line.

日本語版はこちら / Japanese

Concept

Claude Code has dramatically improved development efficiency — but it has also increased cognitive load. In the middle of intense coding sessions, we need a little moment of comfort.

This mascot changes its expression every time a tool runs during your session. When context window usage gets critical, it turns bright red in panic. You can even create your own custom character pack (this is still in beta — give it a try!).

For engineers who find themselves more and more consumed by their work — a small dose of comfort, right in your terminal.

Personality

- Pixel-art mascot rendered directly in the terminal — not ASCII art
- Reacts to 9 session states: idle, thinking, tool running, tool success, tool failure, permission prompt, subagent running, done, and auth success
- Heat-map color shift: the mascot's fur color shifts toward red as context window usage increases
- Status summary: git branch, model name, tool count, context %, and API usage
- Custom mascot packs: create and share your own characters

How It Works

The mascot detects session state through Claude Code's hook system. Each hook event (tool start, tool success, permission request, etc.) updates the mascot's internal state, and the status line renders the corresponding expression.

Because this is event-driven rather than continuous polling, the displayed state may not always reflect the exact real-time status of your session. For example, there can be brief delays or missed transitions depending on hook timing. Think of it as a companion that reacts to events — not a precise status monitor.

Bring One Home

Via Claude Code Plugin Marketplace (Recommended)

Then run the setup skill to…