The offline-only Claude Code status line. A cute cat tells you how much usage is left — without touching a single network endpoint.

한국어 README →

3-row kawaii card — --full --kawaii

claude-cat only renders the JSON that Claude Code already pipes to statusLine scripts via stdin. Nothing else. That's the whole design — and the whole safety story:

• 🚫 Zero network calls. No api.anthropic.com. No claude.ai. No /api/oauth/usage. Run it behind a firewall; it works the same. tcpdump stays empty.
• 🚫 Zero credential reads. Never touches ~/.claude/.credentials.json, the macOS Keychain, or any OAuth token. If your npm account is ever compromised, the worst case is a funny-looking status line — not a leaked Anthropic account.
• 🚫 Zero outbound writes. Only writes to ~/.claude/claude-cat/ (a local sync cache + optional debug dumps). Nothing leaves your machine.
• ✅ Stdin-only, by policy. Documented in SECURITY.md and enforced by the project's threat model — not a side effect.

Pick claude-cat when you want a friendly always-on status line and you care that your toolchain isn't quietly talking to Anthropic behind your back. Pair with ccusage if you also want on-demand cost reports — the two are complementary (claude-cat for live render, ccusage for analysis).

"Just a cat" isn't a cute tagline — it's the threat model.

Run the interactive wizard — it walks you through layout, cat theme, refresh interval, and plan in 30 seconds:

npx -y claude-cat@latest configure

It writes ~/.claude/settings.json for you (with a diff preview first, leaving every other setting untouched). Restart Claude Code and the line shows up on the next turn.

Pick a mode, paste the prompt into Claude Code, and it edits ~/.claude/settings.json for you.

You get a single line: usage bars + $ cost + ctx %. No cat. Wraps on narrow terminals.

5h ▓▓▓▓░░░░░░ 47% (1h 19m) | week ▓▓▓░░░░░░░ 31% (Fri 1pm) | $37.37 | ctx 20%

Install claude-cat (https://github.com/thingineeer/claude-cat) into my
~/.claude/settings.json as the statusLine.

- type: "command"
- command: "npx -y claude-cat@latest"
- padding: 0
- refreshInterval: 300

Don't touch any other key. Show me the diff first.

You get a 3-row card: ASCII cat on the left, data rows on the right. The cat's face and prop change with your usage.

 /\_/\    Opus 4.6  ·  $38.52  ·  ctx 23% used (77% left)
( ^ω^ )   Current session            ▓▓▓▓▓▓░░░░░░░  51% · 1h 15m
 / >🍣    Current week (all models)  ▓▓▓░░░░░░░░░░  31% · Resets Apr 17, 1pm

Install claude-cat (https://github.com/thingineeer/claude-cat) into my
~/.claude/settings.json as the statusLine.

- type: "command"
- command: "npx -y claude-cat@latest --full --kawaii"
- padding: 0
- refreshInterval: 300

Don't touch any other key. Show me the diff first.

5h ▓░░░░░░░░░ 10% (3h 21m) | week ▓▓░░░░░░░░ 18% (Fri 1pm) | $0.123

 /\_/\   Opus 4.6 · $0.123
( ^ω^ )  session  ▓░░░░░░░░░░░░░ 10% · 3h 21m
 / >🍣   week     ▓▓▓░░░░░░░░░░░ 18% · Resets Apr 17, 1pm

/ᐠ ^ᴥ^ ᐟ\  Opus 4.6 · $0.123
session  ▓░░░░░░░░░░░░░ 10% · 3h 21m
week     ▓▓▓░░░░░░░░░░░ 18% · Resets Apr 17, 1pm

5h ▓░░░░░░░ 10% (3h 21m) | week ▓░░░░░░░ 18% (Fri 1pm) | $0.123

Opus 4.6 · $0.123
session  ▓░░░░░░░░░░░░░ 10% · 3h 21m
week     ▓▓▓░░░░░░░░░░░ 18% · Resets Apr 17, 1pm

5h ▓▓▓▓░░░░░░ 47% (1h 19m) | week ▓▓▓░░░░░░░ 31% (Fri 1pm) | $37.37 | ctx 20%

It's this single Claude Code session's running cost, computed by Claude Code itself (cost.total_cost_usd from stdin JSON).

• ❌ NOT "Extra usage" plan-overage fees — that's a different /usage popup bar and isn't piped to statusLine scripts.
• ❌ NOT your monthly subscription bill.
• ❌ NOT money leaving your account right now if you're on Pro/Max (those are flat-rate — the number is informational).
• ✅ On an API key it's the real cost. On Bedrock / Vertex it stays $0.00 (Claude Code can't compute cost there).

The cat only shows up in --full modes. Six moods — five driven by usage, one state-driven (resting).

Mood policy: weekly ≥ 60 % or session ≥ 75 % → alert; any window ≥ 85 → nervous; any ≥ 95 → critical. Weekly drives the mood because it's the bar that actually constrains your week.

 /\_/\
( -.-)
 / >🚬~

 /\_/\
( ^ω^ )
 / >🍣

 /\_/\
( •ㅅ•)
 / >⌨️

 /\_/\
( -ㅅ-)
 / づ☕

 /\_/\
( xㅅx)
 / づ💤

 /\_/|
( -.-)zzZ
 /   \

Two things /usage popup shows but Claude Code doesn't pipe to statusLine scripts, so claude-cat can't render them today:

• Current week (Sonnet only) — server includes rate_limits.seven_day_sonnet only sometimes (condition undocumented).
• Extra usage (e.g. $14 / $20 spent) — comes from /api/oauth/usage (private endpoint).

A future opt-in daemon could proxy that endpoint locally and cache values. Tracked in issues.

claude-cat is deliberately small and network-free so it fits Claude Code's per-message hot path safely.

What it does — reads the stdin JSON Claude Code already pipes to statusLine scripts, prints a colored line.

What it doesn't do — no network requests, no credential reads, no keychain access, no writes outside ~/.claude/claude-cat/. The invariants are listed in SECURITY.md.

npx -y claude-cat@latest downloads and runs the latest published version every time. This is standard for npm but worth knowing:

• Pin if you want reproducibility — npx -y [email protected] instead of @latest. Upgrade when an advisory is published.
• Review the package — the published tarball only ships bin/, src/, examples/, and README/LICENSE (files in package.json). You can audit it before install: npm pack claude-cat && tar -tf claude-cat-*.tgz.
• Local install alternative — clone the repo and point your statusLine at node /path/to/claude-cat/bin/cli.js. No npm fetch at all.

Private advisory only: https://github.com/thingineeer/claude-cat/security/advisories/new

Don't open a public issue. See SECURITY.md.

git clone https://github.com/thingineeer/claude-cat.git
cd claude-cat
git config core.hooksPath .githooks

npm run test:sample    # try a fixture
npm run test:full

Contributing guide: CONTRIBUTING.md. For Claude-Code sessions: CLAUDE.md.

MIT © thingineeer