2026-01-07 11:42:41 +01:00
|
|
|
|
---
|
|
|
|
|
|
summary: "Usage tracking surfaces and credential requirements"
|
|
|
|
|
|
read_when:
|
|
|
|
|
|
- You are wiring provider usage/quota surfaces
|
|
|
|
|
|
- You need to explain usage tracking behavior or auth requirements
|
|
|
|
|
|
---
|
|
|
|
|
|
# Usage tracking
|
|
|
|
|
|
|
|
|
|
|
|
## What it is
|
|
|
|
|
|
- Pulls provider usage/quota directly from their usage endpoints.
|
|
|
|
|
|
- No estimated costs; only the provider-reported windows.
|
|
|
|
|
|
|
|
|
|
|
|
## Where it shows up
|
2026-01-09 03:14:39 +00:00
|
|
|
|
- `/status` in chats: emoji‑rich status card with session tokens + estimated cost (API key only) and provider quota windows when available.
|
2026-01-09 02:21:17 +00:00
|
|
|
|
- `/cost on|off` in chats: toggles per‑response usage lines (OAuth shows tokens only).
|
2026-01-07 11:42:41 +01:00
|
|
|
|
- CLI: `clawdbot status --usage` prints a full per-provider breakdown.
|
2026-01-08 02:49:29 +01:00
|
|
|
|
- CLI: `clawdbot providers list` prints the same usage snapshot alongside provider config (use `--no-usage` to skip).
|
2026-01-07 11:42:41 +01:00
|
|
|
|
- macOS menu bar: “Usage” section under Context (only if available).
|
|
|
|
|
|
|
|
|
|
|
|
## Providers + credentials
|
|
|
|
|
|
- **Anthropic (Claude)**: OAuth tokens in auth profiles.
|
|
|
|
|
|
- **GitHub Copilot**: OAuth tokens in auth profiles.
|
|
|
|
|
|
- **Gemini CLI**: OAuth tokens in auth profiles.
|
|
|
|
|
|
- **Antigravity**: OAuth tokens in auth profiles.
|
|
|
|
|
|
- **OpenAI Codex**: OAuth tokens in auth profiles (accountId used when present).
|
|
|
|
|
|
- **z.ai**: API key via env/config/auth store.
|
|
|
|
|
|
|
|
|
|
|
|
Usage is hidden if no matching OAuth/API credentials exist.
|
