Pixel Cat

A pet that tells you when Claude Code is done

·

source at a8fe0f7

·

MIT license

A pixel cat wanders above the prompt, acts out the tool Claude is using, shows your 5-hour, 7-day and context usage, and says when a turn is done.

What this mod can do

  • Reviewed at commit a8fe0f7
  • Sees each prompt you send and can change or drop it
  • Runs slash commands
  • Sees each tool call before it runs and can block or change it
6 more things it can do
  • Remembers data between sessions
  • Adds the /cat command
  • Adds the /mods command
  • Lists running subagents
  • Lists the slash commands you can run
  • Runs on a timer
Good to know (3)
  • No cat? Add CLAUDE_CODE_ENABLE_FUNCTION_HOOKS set to 1 in the env block of ~/.claude/settings.json
  • It sends toasts at 75% and 90% of the 5-hour limit; the Popups setting turns them off
  • The ↻ button or /mods swaps in the Adventurer pack, or turns it off, and new sessions keep that choice
Are mods safe?

Preview

Terminal

▀▄ ▄▀ [-] ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▄ ▄▀▀▀▀▀▀▀ ▀▀▀▄▄▄ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀ ctx 22% [ Pet ♥ ] [ ⚙ ] [ ↻ Adventurer ] [ Hide ]

Claude Desktop

Pixel Cat in Claude Desktop

What it does

In the author's words

A little pixel cat that wanders above the Claude Code prompt, watches your usage limits and announces when work finishes; or switch packs for an adventurer who mines, chops trees and fights zombies

What you see
An animated pixel cat lane above the prompt
Works in
Terminal and Claude Desktop
Slash commands
/cat, /mods
Uses your tokens
No
Changes files
Nothing
Network access
None
Reviewed commit
a8fe0f7
Preview recorded with
Claude Code 2.1.309

How it works

  1. Appears above the prompt in every session; /cat hides or shows it
  2. Sees each tool call and holds a matching prop: a book for reads, a laptop for edits
  3. Reads your 5-hour, 7-day and context usage and colors each green, yellow or red
  4. Says done! with the time when a turn ends, plus a toast for turns over 20 seconds

Common questions

Is there a pet or companion for Claude Code?

Pixel Cat puts a pixel-art cat above the Claude Code prompt. It wanders, naps, and chases yarn or a laser dot while you're idle, and acts out what Claude is doing while it works. Each install rolls its own markings, with a 1 in 50 chance of a shiny cat.

How can I tell when Claude Code finishes a task?

The cat says done! with the turn's duration when a turn finishes, and the mod sends a toast for turns longer than 20 seconds. You can turn the toasts off with the Popups setting.

How do I see my 5-hour and weekly usage limits in Claude Code?

The cat's lane shows your 5-hour, 7-day and context usage in green, yellow or red, and /cat prints your current limits and when the 5-hour window resets. A toast also arrives at 75% and 90% of the 5-hour limit.

Badge for your README

Own this listing? Add it to your README. The badge shows the install count as it grows.

Reviewed on statuslin.es
[![Reviewed on statuslin.es](https://staging.statuslin.es/badge/mods/pixel-cat.svg)](https://staging.statuslin.es/mods/pixel-cat?utm_source=readme-badge)

Or show the preview card:

Preview on statuslin.es
[![Preview on statuslin.es](https://staging.statuslin.es/og/mods/pixel-cat.png)](https://staging.statuslin.es/mods/pixel-cat?utm_source=readme-badge)

More like this

Deck in Claude Desktop

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.

Flightdeck in Claude Desktop

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

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

✧ ███████████▋ 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.

app · main · Opus-4.8 · effort high · ctx 22% · 5h 26% ↻2h6m · 7d 7% ↻2d0h

Folder, git branch, model (color-coded by family), effort, context usage, and 5h/7d rate-limit usage with reset countdowns — all on one line, each percentage going green → yellow → red as it climbs. Needs jq.

[Opus 4.8] | ━━━━━━ 22% (44K/200K) | app | git:(main) | ⏱ 10m

Single-line status with a context bar, H/W usage limits, project, git branch, MCP server count, and a session timer, with cross-platform credential lookup. Source: github.com/AndyShaman/claude-statusline