onllm-dev/onWatch
Track AI API quotas across Synthetic, Z.ai, Anthropic (Claude Code), Codex, GitHub Copilot & Antigravity in real time. Lightweight background daemon (<50MB RAM), SQLite storage, Material Design 3 dashboard. Zero telemetry.
onWatch – AI‑API quota monitoring made easy
What it does – onWatch is a lightweight, cross‑platform daemon (single binary < 50 MiB) that polls the usage APIs of many popular LLM‑backed services – Anthropic, OpenAI Codex, GitHub Copilot, MiniMax, Gemini, Cursor, Grok, Kimi, and more – stores the results in a local SQLite database, and serves a Material‑Design web dashboard (and optional menubar / VS Code status‑bar widget) so developers can see historical trends, upcoming reset times, and get alerts before they hit a quota limit or run out of budget.
Why it matters – Most providers only show a current snapshot of usage. onWatch fills the gap by keeping a per‑cycle history, calculating burn‑rate forecasts, and unifying dozens of providers into one view. This helps developers avoid unexpected throttling, plan experiments, and keep cloud‑spending under control.
Key features
- Multi‑provider support – Synthetic, Z.ai, Anthropic, Codex, GitHub Copilot, MiniMax, Gemini CLI (legacy), Cursor, Grok, Kimi Code, Antigravity, Moonshot, DeepSeek, OpenCode Go, Mistral, Ollama Cloud, Muse, Command Code, plus custom JSONL API integrations.
- Historical data – SQLite stores per‑poll usage; dashboard shows time‑series charts (1 h‑30 d) and cycle‑overview tables.
- Alerts & notifications – Email, push (PWA), webhook, and on‑screen warnings when thresholds are crossed; configurable per‑quota.
- Dashboard – Material Design 3 UI with dark/light mode, live countdown timers, burn‑rate projections, and a Prometheus
/metricsendpoint (beta). - Desktop integration – System‑tray / menubar widget on macOS, Linux, Windows; VS Code extension shows the tightest quota in the status bar.
- Zero telemetry – All data stays on the machine; the binary is self‑contained, no external services required.
- Easy installation – One‑line script, Homebrew tap, Windows PowerShell installer, Docker image, or manual build from source (Go 1.25+).
Typical workflow
- Install the binary (or Docker image) and run
onwatch setupto add API keys in~/.onwatch/.env. - Start the daemon (
onwatchor via systemd/launchd). It polls each configured provider in parallel and writes usage rows to SQLite. - Open
http://localhost:9211– log in with the admin credentials from.env– and explore the dashboard. - Optionally enable email/push/webhook alerts and install the VS Code extension for in‑IDE visibility.
Who should use it – Individual developers, small teams, or anyone who runs code‑generation, code‑review, or other LLM‑driven workflows across multiple AI services and needs a single place to monitor consumption and avoid surprise throttling.
Project health – The repo shows GitHub stars, CI badges (coverage, downloads), a recent version tag (v2.14.11), and is listed in the Awesome Go collection. It is actively maintained (beta status) and provides extensive documentation for each provider.
Quick‑start summary
# macOS / Linux one‑liner
curl -fsSL https://raw.githubusercontent.com/onllm-dev/onwatch/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/onllm-dev/onwatch/main/install.ps1 | iex
# Then start the daemon
onwatch
# Open the UI
open http://localhost:9211 # or visit in a browser
Links – Website: https://onwatch.onllm.dev • VS Code Marketplace: onllm-dev.onwatch • GitHub: https://github.com/onllm-dev/onwatch
Related
- Project
- Project
- Project
- Project
- Project