llms.txt
Compare with other sites' llms.txt files →# JP the Cat
> JP the Cat is a playful, free macOS menu-bar app that shows what Claude Code costs in real dollars, tracks Codex rate-limit usage, and tracks unified Grok Build / Cursor / Grok Bot activity and plan pools. Claude Code, Codex, Grok, Muse Spark, OpenCode Zen, and OpenCode Go are live, with a 64-provider catalog mapped from CodexBar, ccusage, coding_agent_usage_tracker, and Open Island for Antigravity (Google's Gemini CLI successor), Gemini, Cursor, Copilot, Amp, Droid (Factory), Qoder, CodeBuddy, Kimi, Kilo, OpenRouter, LiteLLM, and more. Native, private, and free: no account, no license key, no trial, no payment. The mascot is JP, a highly opinionated tortoiseshell cat.
## What it does
- Reads Claude Code session logs on your Mac and computes real-dollar cost, priced to the cent, including the 5-minute vs 1-hour cache-write split most trackers get wrong.
- Reads Codex rollout logs and shows available subscription-window used percentages, plus separately reported credits and their capture time. Codex is a subscription, so any dollar figure is a notional list-price estimate, clearly labelled — never real spend.
- One Grok row combines Grok Build session logs under `~/.grok/sessions` and opt-in local Cursor CLI stop-hook activity. Known model rates yield notional list-price cost, entirely unpriced activity shows tokens, and a plan-only account shows official usage percent rather than a dead $0.00 chart. Optional official plan usage uses one shared API fetch/cache for weekly and monthly pools.
- Reads Muse Spark from OpenCode's local `opencode.db` on this Mac (assistant messages / sessions for `muse-spark*`) and shows notional Meta Model API list-price dollars — OpenCode sessions only, not your full Meta account dashboard; never real spend unless Meta bills those rates on that account.
- Reads OpenCode Zen and OpenCode Go from the same local `opencode.db`, split by the gateway OpenCode recorded on each turn (Zen = pay-as-you-go, Go = the $10/month subscription). Go also shows 5-hour, weekly, and monthly usage-vs-cap meters measured from its published per-model dollar caps. Both are gateway views that can overlap model rows, so JP lists them but never adds them to the combined total.
- Labels plan-limit figures honestly: official provider data when available, otherwise no quota gauge. OpenCode Go alone shows measured usage against published caps.
- Shows Claude Code's official 5-hour and weekly usage limits when you opt in (Settings → Live data; reversible; never edits your Claude config) — the same official numbers Codex reports automatically.
- Plays a native-notification meow the first time any provider's usage window crosses 80% (a toggle in Settings, on by default), so JP nudges you before a wall, not after.
- Ships a real macOS WidgetKit widget in small, medium, and large sizes.
- Ships light and dark themes (Sunlit Ledger and Midnight Ledger), both free.
- Lets you set the dashboard window to 7, 14, 30, or 90 days, and breaks spend down per model with cache-hit % and a ~30-day projection.
- Publishes a 64-provider catalog with explicit support status: `live`, `local next`, `connect later`, `api later`, or `candidate`.
- Builds toward Antigravity/Gemini local sources and connect-account providers.
- Least-privilege by design: no Full Disk Access and no Accessibility permission. JP reads exact provider dotfolders and explicitly opted-in sign-in stores, plus its own capture files — never the rest of your disk.
- Fully local-first: prompts, code, transcripts, and token history stay on your Mac. No account is required for the local cost engine. The Mac app's product analytics are off by default; the marketing site uses Vercel Web Analytics and Speed Insights for aggregate page, CTA click, and performance telemetry, and successful non-bot `/download` requests may send an owner notification through Resend with coarse Vercel edge location context (city, region, country, timezone; no postal code; never lat/long) plus ipapi.is ASN/network and hosting/anonymizer signals. Every download button goes to `/download` and shows a short download-started note; no email is collected. The app is free and makes no license, trial, or purchase calls; update checks and downloads never include prompts, code, transcripts, token history, provider credentials, computed costs, or the local usage database, and no raw hardware identifiers ever leave your Mac. Owner/admin notices may be sent for downloads. The optional, off-by-default Grok plan-usage toggle uses a saved Cursor or Grok Bot sign-in token only with `api2.cursor.sh`; one Grok view consolidates local activity and official plan pools on a shared five-minute cadence.
## Pages
- [Home](https://jpthecat.com/): overview, live demo, features, widget, themes, privacy, free download, FAQ.
- [Privacy and Terms](https://jpthecat.com/terms): privacy policy and terms of use for the free app (/privacy redirects here).
- [Contact](https://jpthecat.com/contact): support.
## Library (programmatic reference)
- The [/library](https://jpthecat.com/library) hub is a crawlable reference for what AI coding agents cost: per-model pricing, cost calculators, usage-limit explainers, subscription plans, tracker comparisons, alternatives, how-to guides, and a cost glossary. It is reachable from the sitemap, not the site navigation.
- Honesty rule across the library: only Claude Code, Codex, Grok, Muse Spark, OpenCode Zen, and OpenCode Go are described as tracked today; the other providers in the 64-provider catalog are labelled by roadmap status and never presented as supported. Every non-Claude dollar figure is marked notional list price, never real spend.
- Model pricing pages use the same bundled per-token table the app prices real usage with (Claude, OpenAI/Codex, Gemini, xAI/Grok, Meta Muse Spark, DeepSeek, and OpenCode Zen/Go families). xAI rates mirror https://docs.x.ai/developers/pricing (cached-input is model-specific, not a flat 0.1×). Cache-write 5m/1h rates and context tiers apply only where a model publishes them.
- Usage-limit pages cover Claude Code, Codex, unified Grok, OpenCode Go, and GitHub Copilot. OpenCode Go's page describes a measured reading against published per-model caps, never an official percentage. Grok's page describes API weekly included usage (with an optional Grok hook fallback) and monthly billing pools. Legacy Cursor/Grok Bot library URLs redirect permanently to Grok.
## Details
- Platform: macOS 14 (Sonoma) or later, Apple Silicon.
- Pricing posture: free. There is no paid tier, license key, trial, or checkout.
- Download status: the public `/download` route redirects to the signed, notarized stable DMG only when its manifest has a trusted URL, sha256, and release date; otherwise it fails closed. Each homepage download CTA fires a Vercel Analytics custom event and shows a short download-started note; successful trusted non-bot redirects send a Resend owner notice when `RESEND_API_KEY` is configured, while bot rows still persist for aggregate `/growth` bot-pressure reporting. Downloads that come through the programmatic-SEO `/library` hub are captured as a distinct "library" channel — a separately-named analytics event and a distinct second download owner notification variant — so SEO-driven downloads are distinguishable from homepage downloads.
- Not affiliated with Anthropic, OpenAI, Google, GitHub, Cursor, or any other listed AI provider.
- Contact: https://jpthecat.com/contact
## Homepage scope
The homepage demos show All providers, Claude Code, Codex, Grok, Muse Spark, Cursor, and OpenCode Go.
The frozen homepage Cursor illustration shows opt-in local token activity, not dollar spend or official quota; the native app consolidates that source into Grok.
The full native catalog and pricing library remain independent of this curated homepage.
The pricing library labels retained historical rates that could not be verified against current published prices.