show-llm-usage

A macOS menu-bar overlay that shows live usage quotas for 12 LLM subscriptions — Claude, GitHub Copilot, OpenAI Codex, Z.ai, Kimi, Gemini/Antigravity, OpenCode, Ollama, Grok, Amp, ArliAI, and Devin — all in one floating window, refreshed automatically every 15–20 minutes.

macOS 選單列浮動視窗，一次看清 12 個 LLM 訂閱的用量配額，每 15–20 分鐘自動更新。

How it works

• Sources/main.swift — a single-file AppKit app (no Xcode project) that renders the two-column overlay and reads JSON snapshots from .data/.
• fetch-*-usage.sh — one fetcher per service. Some call local CLI status files (Claude), some call official APIs (Z.ai), and some drive your already-logged-in browser via opencli (Homebrew) to scrape SPA quota pages (Copilot, Codex, Kimi, Grok, Devin…).
• SQLite history — every snapshot is logged to .data/ for trend charts; older rows are downsampled daily.
• Optional Turso mirror — snapshots can be mirrored to a libsql/Turso DB for a cloud dashboard. Fully local if you skip it.

運作原理：AppKit 浮動視窗讀取 .data/ 內的 JSON 快照；每個服務一支 fetch 腳本（CLI 狀態檔／官方 API／opencli 驅動已登入瀏覽器爬取）；快照同步寫入 SQLite 歷史，可選同步到 Turso 雲端資料庫。

Requirements

• macOS with Swift (swiftc) — builds with build.sh, no Xcode needed
• bash, jq, python3, tmux
• opencli (Homebrew) with its Browser Bridge extension, for browser-driven fetchers
• The CLIs you want to monitor (Claude Code, Antigravity agy, etc.), logged in

Setup

git clone https://github.com/tboydar/show-llm-usage.git
cd show-llm-usage

# Optional: API keys (Z.ai) / Turso mirror — copy the template
mkdir -p .data && cp keys.env.example .data/keys.env

./run.sh            # build + launch overlay
./install-autostart.sh   # optional: LaunchAgent to start on login

Browser-driven services need a logged-in Chrome session — opencli reuses your existing profile, no credentials are stored by this project.

Documentation

• SERVICES.md — per-service monitoring details (fetch method, fields, caveats)
• docs/services/ — deep dives per service
• RCA-report-*.md — root-cause analyses of past incidents
• tests/ — regression suite, run with ./tests/run-all.sh

Note: most docs are written in Traditional Chinese.

Privacy

• All data stays in .data/ (gitignored). Credentials are read from .data/keys.env and never committed.
• The overlay only shows service names, percentages, and reset times — no account emails.
• See keys.env.example for the only two integrations that need secrets (Z.ai API key, optional Turso).

Disclaimer

This tool reads quota information from your own logged-in accounts for personal monitoring. It is not affiliated with, endorsed by, or supported by any of the monitored providers. Automated access may be subject to each provider's terms of service — use at your own risk.

License

MIT