onWatch 是一款免费、开源的 AI API 配额监控工具，旨在填补“当前用量快照”与开发者实际需要的“按周期、跨会话的历史视图”之间的空白。它把多个 AI 提供商的用量集中到一处，让用户在触发限流或超出预算前查看历史、接收告警并打开本地 Web 仪表盘。项目由 onllm.dev 提供，当前处于 Beta 阶段，功能和 API 可能随开发调整。
主要能力
onWatch 实时追踪以下提供商的配额：Synthetic、Z.ai、Anthropic（Claude Code）、Codex、GitHub Copilot、MiniMax、Gemini CLI（旧版）、Cursor、Grok、Kimi Code、Antigravity，以及 Moonshot、DeepSeek、OpenCode Go、Mistral（beta）、Ollama Cloud（beta）、Muse、Command Code 等按余额或订阅计量的服务。此外还支持通过 API Integrations 摄取自定义 API 驱动工作流的本地 JSONL 遥测数据，追踪 token 用量与花费。
仪表盘采用 Material Design 3 风格，支持深色/浅色模式（自动检测系统偏好），每个已配置的提供商会显示对应标签页。每张配额卡片展示：用量与上限的对比进度条、重置倒计时、状态徽章（healthy/warning/danger/critical）、消耗速率与预测用量。其他功能包括：Chart.js 面积图时间序列（1h/6h/24h/7d/30d）、API Integrations 专用遥测视图、Insights（燃烧率预测、计费周期平均值、用量方差、趋势检测、跨配额比率分析）、Cycle Overview（跨配额相关性表）、Sessions（每次代理运行创建会话并追踪峰值消耗）以及 Settings 设置页。
还提供 Prometheus 指标端点（Beta，可选用 Bearer Token 保护）、可安装的 PWA、菜单栏/系统托盘伴侣（macOS、Linux、Windows，Beta）、VS Code 扩展，以及邮件（SMTP）、浏览器推送（Web Push/VAPID）和 Webhook（可配合 ntfy、Gotify 等）通知。SMTP 密码使用 AES-GCM 加密存储，Webhook 载荷不含凭据。
使用方式
onWatch 以轻量后台守护进程运行，全部提供商并行轮询时内存占用低于 50MB，历史数据存入 SQLite，仪表盘默认在 http://localhost:9211 提供，使用 .env 中配置的凭据登录。
安装方式包括：一行安装脚本（Linux/macOS 会下载二进制到 ~/.onwatch/、创建 .env、设置 systemd 服务或 launchd agent 并加入 PATH；Windows 使用 PowerShell 一行安装或 install.bat）、Homebrew（macOS 与 Linux）、从 Releases 页面下载二进制（支持 macOS ARM64/AMD64、Linux AMD64/ARM64、Windows AMD64/ARM64）、从源码构建（需要 Go 1.25+）、Docker（含 distroless 基础镜像约 10-12 MB，非 root 运行，数据通过 /data 卷持久化）以及 app.sh。
配置时编辑 ~/.onwatch/.env（源码构建则为项目目录下的 .env），至少需要一个提供商密钥，可任意组合并行追踪。Anthropic token 会从 Claude Code 凭据自动检测（macOS Keychain、Linux keyring 或 ~/.claude/.credentials.json）；仅用 Codex 时设置 CODEX_TOKEN，运行时会重新读取 ~/.codex/auth.json（或 CODEX_HOME/auth.json）；Copilot 需要具备 copilot scope 的 GitHub Personal Access Token（classic）。官方还提供 Windows、Codex、Copilot、MiniMax、Antigravity、Cursor、API Integration 等设置指南。
VS Code 扩展发布在 VS Code Marketplace（onllm-dev.onwatch），是守护进程的轻量客户端，会自动发现正在运行的 onWatch，在状态栏显示最紧张的配额（关键时带重置时间），悬停显示各提供商明细，点击可打开快速视图或完整仪表盘。每个 GitHub 发布也会附带 onwatch-vscode-<version>.vsix。
菜单栏/托盘伴侣包含两种预设视图：Standard（提供商卡片与圆形配额仪表、重置信息）和 Detailed（展开卡片、迷你趋势线与完整配额明细），可在 Settings > Menubar 中配置显示项、顺序、刷新与阈值。
适用场景
onWatch 适合使用上述任意提供商 API 密钥的开发者与工具链，包括 Cline、Roo Code、Kilo Code、Claude Code、Codex CLI、Cursor、GitHub Copilot、MiniMax Coding Plan、Grok CLI、Antigravity 等。典型用途是跨会话、按周期查看历史用量，设置阈值告警，避免限流或预算超支，并对比不同工作阶段的消耗。
限制
项目当前处于 Beta，功能和 API 可能变化。文中未提及任何收费、价格或付费层级信息。Muse 追踪默认关闭，因为每次轮询会消耗用户自己 5 小时窗口中的一次 prompt，需设置 MUSE_ENABLED=true 显式开启。Gemini CLI 为旧版路径，Google 的 Gemini CLI 已被 Antigravity 取代，新安装建议使用 Antigravity 提供商的 agy 数据源。Codex 的多账户支持、自动配额启动器以及部分其他功能标记为 Beta。
