Bb Plugin Usage

bb-plugin-usage

Track coding-agent token usage and estimated API cost across every machine enrolled in BB.


Features

• Collect usage from Codex, Claude Code, FX, Grok Agent, OpenCode, Pi, Prime Agent, and Antigravity.
• Separate the coding agent from the underlying model provider.
• Group charts and cost summaries by agent or model provider.
• Break usage down by model, project, or day.
• Filter by machine, agent, model provider, and the last 7, 30, or 90 days.
• Show exact, alias-matched, agent-reported, and unknown pricing in the breakdown table.
• Show OpenCode Go plan windows (rolling 5-hour, weekly, and monthly) in the usage-limits section.
• Resolve model prices from models.dev, refreshed daily at runtime with the bundled snapshot as fallback, without inventing prices for ambiguous models.
• Sync automatically every 15 minutes or manually from the dashboard.

Supported data sources

• Codex: ~/.codex/sessions/**/rollout-*.jsonl
• Claude Code: ~/.claude/projects/**/*.jsonl
• FX: ~/.fx/usage.jsonl
• Grok Agent: ~/.grok/logs/unified.jsonl
• Pi: ~/.pi/agent/sessions/**/*.jsonl, plus optional extra roots in plugin settings
• Prime Agent: root sessions in ~/.prime/agent/sessions/*.jsonl and recursive-agent sessions under ~/.prime/agent/session-artifacts/**/*.jsonl, plus optional custom session directories in plugin settings
• OpenCode: assistant-message usage from the last 90 days, recorded by opencode db
• Antigravity: ~/.antigravity-acp/usage.jsonl, written by the bb-plugin-antigravity-acp provider bridge (the agy CLI has no session log of its own in a stable, parseable shape, so the bridge is the source of truth, one line per turn it runs)
• OpenCode Go limits: plan windows from https://opencode.ai/zen/go/v1/usage, authenticated with the opencode-go credential in ~/.local/share/opencode/auth.json on each mac