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

  • Agent Cat Releases — Agent Cat downloads — a free macOS menu bar and Windows tray app that shows Claude Code, Codex and Gemini CLI 57 ★
  • Clawd Usage Winwidget — Claude usage limits in a tiny Windows widget + tray icon — with pixel Clawd who reacts to your Claude Code ses 40 ★
  • Cc Mod Image View — Claude Code mod: thumbnails of pasted images above the prompt instead of bare [Image #n] tags 27 ★

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