matthlh

Claude Cat Mod — Development skill for Claude Code

Development community

A tiny pixel cat that wanders above your Claude Code prompt, tracks usage limits and announces when Claude finishes.

How to install Claude Cat Mod

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

What Claude Cat Mod does

A tiny pixel cat that wanders above your Claude Code prompt, tracks usage limits and announces when Claude finishes.

Alternatives in Development

  • 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 ★
  • MCP Base — tilth — code intelligence MCP server 349 ★

README

Claude Cat Mod 🐱

A tiny pixel-art cat that lives above your [Claude Code](https://claude.com/claude-code) prompt. It wanders around, watches your usage limits, and tells you when Claude finishes.

![Claude cat poses: walk, walk 2, sit, happy, sleep](docs/preview.svg)

What it does

  • **Wanders** back and forth above the prompt, sits down now and then, and blinks.

  • **Works alongside Claude**, with a speech bubble showing the current tool (`‹Bash…›`) and a prop to match: a book for reading files, a laptop it types on for edits, a terminal for shell commands, a magnifying glass for searches. Between tools it runs around.

  • **Announces when a turn finishes** (`‹done! 42s›`), plus a toast for turns longer than 20 seconds.

  • **Reacts to failures** with a `>.<` face when a tool call errors.

  • **Food bowl = context:** a bowl at the right end empties as the conversation fills up. Near the limit the cat mentions it; when the conversation is compacted, the bowl refills ("nom nom!").

  • **Tracks your limits:** shows your 5-hour, 7-day and context usage in green, yellow or red. It gets sleepy at 80% of the 5-hour limit and sends a toast at 75% and 90%.

  • **Keeps itself busy while you're idle**, mostly calmly (strolling, sitting, grooming itself, napping), with play now and then:

    • chases a ball of yarn, follows a butterfly, hops around, and takes little cat naps
    • hunts a mouse, and sometimes pins it under a paw (before it wriggles free and runs off)
    • stalks a bird, pounces ("nom?!"), and watches it fly away
    • goes fishing: a fishbowl, a fish tank or a river, depending on the scene, and sometimes catches one
    • chases a laser pointer dot back and forth until it vanishes ("where'd it go?")
    • mischief: finds a mug on a table, taps it… and knocks it off ("CRASH", "oops :3"), or sits right on top of your usage stats until you pet it
    • at night (11pm–6am) it mostly naps

    ![Props for each tool, hats, a shiny cat, a mug about to be knocked off, and the