Usage windows#
Usage readouts cover Claude Code, Codex, Cursor, GitHub Copilot, Kimi Code, Hermes, OpenCode, MiMo Code, Kilo Code, Antigravity, Qwen Code, Pi, Oh My Pi, Goose, Kiro, Cline, Mistral Vibe, ZCode, Devin, Command Code, and Aider when its analytics log is already configured. Most come from local records. Kimi and Cursor read provider usage with the sign-ins already on your Mac:
- 5-hour and 7-day windows (Claude Code, Kimi), each with its resets in or refills time when reported.
- 7-day window (Codex), with its refill countdown when reported.
- Monthly window (Cursor), with its refill date and a choice of measure (Weighted, Spend, Auto, or API).
- Monthly totals: tokens, spend, cost, or daily history when the agent records them. AgentPeek leaves unavailable values blank and never invents a quota or reset window.
AgentPeek uses the data and provider sign-ins already on your Mac. You do not paste API keys into AgentPeek.
Per-agent sources#
Each agent reports only what its own records contain, and the readout honors those exact boundaries:
- Claude Code: the 5-hour and 7-day rate limit windows, each with its reset or refill countdown.
- Codex: the 7-day rate limit window with its refill countdown.
- Cursor: the monthly window read from your Cursor account, using the sign-in already on your Mac.
- Kimi Code: provider five-hour and seven-day usage windows with reset times, plus local daily token history.
- Kilo Code: monthly token and cost totals from its local session database.
- Kiro: monthly token totals and daily history from Kiro's own persisted session stores.
- MiMo Code: monthly tokens, daily history, and recorded cost from its local database; no plan quota or billing-cycle percentage is inferred.
- Devin: monthly token totals and daily history from its local CLI session database.
- Command Code: calendar-month tokens, cache breakdowns, daily history, and exact persisted cost from local v3 project records; no provider quota, reset window, or missing cost is inferred.
- Qwen Code: monthly token totals and daily history from local JSONL session records.
- Goose: calendar-month token totals, daily history, and recorded cost from its local sessions and usage ledger.
- Cline: calendar-month persisted tokens and exact recorded cost from its local index and session artifacts; cache portions are never counted twice.
- Mistral Vibe: cumulative prompt-plus-completion snapshots from local session records.
- ZCode: calendar-month and daily tokens from its exact local usage rows.
- Aider: optional aggregate tokens and recorded cost from an analytics log you already configured; AgentPeek never enables or configures Aider analytics.
- Hermes and OpenCode: monthly token and spend totals from their local session databases.
- Pi and Oh My Pi: monthly token and spend totals from their local logs and journals.
- GitHub Copilot CLI: monthly tokens, requests, and daily history from exact assistant-call rows in
~/.copilot/session-store.db; cache and reasoning stay non-additive breakdowns, and nano-AIU is never labeled as USD. - Antigravity: weekly quota, reset, model, account, token, branch, and context fields from its documented CLI status-line payload; no credentials are read, and a status line you configured yourself is never overwritten.
- Qoder, CodeBuddy, Gajae Code, Grok Build, and Factory Droid: no usage data AgentPeek can read yet, so their sessions appear without usage numbers.
The full per-agent detail, including exactly which fields each store exposes, lives on each agent's page under Supported agents.
Gauges and the Metrics page#
Each gauge reads like a battery, green through yellow to red as you near the limit. Turn on Count down to watch it drain from full instead. The usage surface has two pages: Active for the live windows, and Metrics for by-day bars over the last two weeks beside a donut splitting input, output, cache write, and cache read, with a per-model share underneath. A number shows -- when it's unavailable or stale, and Refresh usage pulls the latest any time.
Controls and alerts#
You control it per agent in Settings then Usage. The Shown where card picks the agents on each surface: Panel for the Active and Metrics pages, Header and Pill for up to four promoted to the expanded header and the collapsed pill, and Menu bar for the popover. Usage account picks which account to report when you have more than one, and Cursor adds a Monthly gauge (Weighted, Spend, Auto, or API) plus optional Auto and API bars.
Budget alerts in Settings then Notifications fire once when a usage window (5-hour, 7-day, or monthly) crosses a threshold you set, anywhere from 50 to 100 percent. You can also set daily token budgets, put monthly, weekly, or daily spend caps on Hermes and OpenCode, and get alerts for limit recovery, early limit pace, and available account handoffs. See Notifications for the full alert catalog.