A cockpit for Claude Code: plan bars and subagent strips, context, usage limits with reset countdowns and burn rates, spend, the model route and a pet. Six bar styles, three collapsed looks. CLI and Desktop.
What this mod can do
- Reviewed at commit 5e07b94
- Runs programs
- Writes files
- Reads environment variables
- Sees each prompt you send and can change or drop it
- Sees each tool call before it runs and can block or change it
- Sees each subagent before it starts and can stop it or pick its model
- Also uses prompt.autocomplete, which this page doesn't describe yet
9 more things it can do
- Reads files
- Reads your settings
- Reads your prompt as you type
- Remembers data between sessions
- Plays sounds
- Adds the /pet command
- Lists running subagents
- Runs on a timer
- Runs on Claude Code hooks, such as session start
Good to know (3)
- Needs Claude Code 2.1.293 or later.
- Reads your prompt as you type to react to it, in memory only. It never saves or sends it.
- Saves settings in ~/.claude/pixel-pet.json, with project paths if a project gets its own pet.
Preview
Terminal
▀▀▀▀▀▀▀▀▀▀▀▀▀▀ [-]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
█▀▀▀▀▀██▀▀▀███ Pebble is waiting for you
█▀▀█▀▀██▀▀█▀▀▀ ━━━─────────── 22% 5h ▰▱▱▱▱ 26% week ▰▱▱▱▱ 7% $0.20 ⓘ
█████▀▀▀▀█████Claude Desktop
What it does
In the author's words
An animated pixel-art companion above your prompt that reacts to your session and your typing, with a live context meter.
- What you see
- A pet and a context meter above the prompt
- Works in
- Terminal and Claude Desktop
- Slash commands
- /pet
- Uses your tokens
- No
- Changes files
- ~/.claude/pixel-pet.json, plus an SVG from /pet card
- Network access
- Only through programs it runs
- Reviewed commit
- 5e07b94
- Preview recorded with
- Claude Code 2.1.309
How it works
- Starts asleep in a new session and wakes on your first keystroke.
- Reads hook events (tool calls, prompts, turns, subagents) and Claude Code's usage figures.
- Prints one line when the kind of work changes, and cheers or groans at test results.
- Draws a context bar beside it, then your plan's 5-hour and weekly use, or API dollars.
Common questions
How can I tell when Claude Code needs my approval?
Pixel Pet jumps up waving with an exclamation mark when a permission prompt appears, and says it needs your OK. When a turn of 30 seconds or more finishes, it waves until you're back. /pet sound on adds a soft chirp when it calls you.
How do I see my context and plan usage with Pixel Pet?
The meter on its second line is a bar for the context window, then your plan's 5-hour and weekly usage, or the dollars billed on the API, Bedrock, Vertex or Foundry. Point at the info icon for tokens, reset times and how you're billed. It notes once when a plan limit passes 80%, and again at 95%.
Can I turn off the animation or the background?
/pet calm on keeps motion small, with no bobbing or scrolling. /pet scene off shows just the pet, and /pet hide tucks it away until you run /pet show.
Does Pixel Pet send anything off my machine?
No. It makes no network calls. It runs date +%z once a session for your time zone, writes ~/.claude/pixel-pet.json, and /pet card saves an SVG to your Downloads folder.
Badge for your README
Own this listing? Add it to your README. The badge shows the install count as it grows.
[](https://staging.statuslin.es/mods/pixel-pet?utm_source=readme-badge)
Or show the preview card:
[](https://staging.statuslin.es/mods/pixel-pet?utm_source=readme-badge)
More like this
Flightdeck: a live agent dashboard for Claude Code. Main model vitals, an on-call architect, every permission check, subagent cards and swimlanes, a turn receipt and a session log, all from real session events
Live session cost odometer above the prompt: a burning fuse, real-world comparisons, threshold alerts
Shows branch safety, context headroom, and account usage in a compact session telemetry strip
Opus 4.8 high ✦ │ ctx 22% │ app (main) │ PR #1287 ● │ $0.41 · 10m +128 -34
Session ● ● ● ● ● ● ● ● ○ ○ ○ 74% left Resets in 2h 6m
Weekly ● ● ● ● ● ● ● ● ● ● ○ 93% left Resets in 2d 0h
Feature-rich bash status line with model, context bar, session cost (read live from Claude Code, so it stays correct on any model), rate-limit bars, and live tool/agent activity that adapts to terminal width. Source: github.com/JungHoonGhae/claude-statusline
Opus 4.8 │ ✍️ 78% │ app (main) │ +128/-34
Cost $0.4100
Tokens in 44.0k │ cache write 5000 │ cache read 2000 │ out 1.4k
Compact status line showing model, context remaining %, directory/git, session time and lines changed, with rate-limit bars or a cost/token breakdown. Source: github.com/susomejias/claude-statusline
✧ ███████████▋ 73% 🗝 Ultima Weapon ✦ app ∙ main
♥ ████████████████████████ 100% 「SAVE POINT」 ✶ Limit Form ◉ 41
Claude Code plan-usage HP bar that reads the Claude auth token to show remaining usage.
Opus 4.8 │ ✍️ 22% │ app (main) │ ● high
current ●●○○○○○○○○ 26% ⟳ 3:35pm
weekly ○○○○○○○○○○ 7% ⟳ oct 20, 2:28pmTwo-block bash status line: model, context %, directory/git and session time up top, with 5h/weekly rate-limit bars below. Source: github.com/nilbuild/claude-statusline