Know your LLM usage
at a glance.

A tiny open-source CLI and macOS menu bar app that tracks your subscriptions (Claude Max, Codex, Kimi Code, Cursor) and your API keys (OpenAI, Anthropic, Kimi) — cycle, usage, and reset times. Everything stays on your machine. No signup, no server, no database, no tracking.

sage menu bar app showing subscription usage bars for Claude, Codex, Kimi Code and Cursor 
● claude · Max (20x)
  Weekly       ████████░░░░░░░░ 52% left · 3d 4h
  Session (5h) ██░░░░░░░░░░░░░░ 87% left · 2h 10m
● codex · Pro
  Weekly              ██████░░░░░░░░░░ 41% left · 2026-08-08
  GPT-5.3-Codex-Spark ████████░░░░░░░░ 52% left · 2026-08-10
● kimi-code · Vivace
  Weekly        ██████░░░░░░░░ 38% left · 2026-08-07
  5h rate limit █░░░░░░░░░░░░░░░ 94% left · 4h 35m
● cursor · Pro
  Monthly  █████░░░░░░░░░░░ 34% left · 2026-08-06

API keys
  openai     $12.40 spent this cycle
  cycle: day 3/31 · resets 2026-09-01 (28d left)

What it tracks

Subscriptions — auto-detected

Nothing to configure. If the tool is signed in on your machine, sage reads its local credentials read-only and shows plan, usage windows, and reset times.

  • Claude — Max/Pro, session + weekly limits
  • Codex (ChatGPT) — plan, weekly limits, credits
  • Kimi Code — membership tier, weekly quota, rate limits
  • Cursor — plan, monthly included usage

API keys — pay-as-you-go

Add keys via the CLI, the app, or both (they share ~/.sage/).

  • Kimi (Moonshot) — account balance
  • OpenAI — key validity; spend with an admin key
  • Anthropic — key validity; spend with an admin key

No provider exposes your billing cycle, so API spend is anchored to a monthly reset day you choose (sage cycle --set-reset-day N).

Install

CLI
brew install thedevdavid/tap/sage   # or run without installing: bunx @thedevdavid/sage
macOS menu bar app
brew install --cask thedevdavid/tap/sage-app

Or grab sage.app.zip from GitHub releases.

Agent skill
npx skills add thedevdavid/sage   # or: sage skill install

Teaches your coding agent to answer “how much do I have left?” itself.

Usage

sage status [--json]              cycle + usage for keys and subscriptions (default)
sage add <provider>               add an API key: openai, anthropic, kimi
    [--key K] [--admin-key K]     prompts securely when flags are omitted;
                                  spend reporting needs an admin key
sage remove <provider>            remove an API-key provider
sage usage [name] [--json]        detailed usage for one source or all:
                                  openai, anthropic, kimi, claude, codex, kimi-code, cursor
sage cycle [--set-reset-day N]    show billing cycle, or set the monthly reset day
sage skill install [--project]    install the agent skill (~/.agents/skills,
                                  or ./.agents/skills with --project)
sage help                         show help
sage version                      show version

Local-only by design