onWatch

onWatch

Free, open-source AI API quota monitoring for developers.

Track usage across Synthetic, Z.ai, Anthropic, Codex, GitHub Copilot, MiniMax, Gemini CLI (legacy), Cursor, Grok, Kimi Code, and Antigravity in one place.
See history, get alerts, and open a local web dashboard before you hit throttling or run over budget. Additionally, you can ingest local telemetry from your own API-driven workflows with API Integrations, keeping track of token use and spending across multiple providers.

Links: Website | Buy Me a Coffee

Trust & Quality

Compatibility & Docs

onWatch fills the gap between "current usage snapshot" and the historical, per-cycle, cross-session view that developers actually need. It runs as a lightweight background agent ( Powered by onllm.dev | Landing Page

Quick Start

macOS & Linux

One-line install:

This downloads the binary to ~/.onwatch/, creates a .env config, sets up a systemd service (Linux) or a launchd agent (macOS, offered during install), and adds onwatch to your PATH.

The installer downloads the standard binary, which includes the menubar companion on macOS and the system tray on Linux desktops.

Homebrew (macOS & Linux)

Windows

One-line install (PowerShell):

Or download install.bat from the Releases page and double-click it.

This downloads the binary to %USERPROFILE%\.onwatch\, runs interactive setup for API keys, creates a .env config, and adds onwatch to your PATH.

For manual setup or troubleshooting, see the Windows Setup Guide.

Manual Installation

Download binaries from the Releases page. Binaries are available for macOS (ARM64, AMD64), Linux (AMD64, ARM64), and Windows (AMD64, ARM64).

Or build from source (requires Go 1.25+):

Or use Docker (requires Docker or Docker Compose):

Or via app.sh:

The Docker image uses a…