- name
- greenclaw-usage
- description
- Token usage analytics and budget alerting for the GreenClaw inference proxy. Query spending, set budget alerts, and track savings.
GreenClaw Usage Analytics
You have access to the greenclaw CLI tool for querying token usage, cost analytics, and managing budget alerts. Run it via npx greenclaw (requires pnpm install and pnpm build first). All commands output JSON.
Available Commands
Usage Queries
Daily summary:
npx greenclaw usage summary --period dayWeekly or monthly summary:
npx greenclaw usage summary --period week
npx greenclaw usage summary --period monthBreakdown by model, tier, or provider:
npx greenclaw usage breakdown --by model --period day
npx greenclaw usage breakdown --by tier --period week
npx greenclaw usage breakdown --by provider --period monthTrends over time:
npx greenclaw usage trends --period day --last 7
npx greenclaw usage trends --period week --last 4Budget Alerts
List alert rules:
npx greenclaw alerts listSet a daily cost budget:
npx greenclaw alerts set --name "daily budget" --metric daily_cost --threshold 50 --unit usd --period daySet a weekly token limit:
npx greenclaw alerts set --name "weekly tokens" --metric weekly_cost --threshold 100 --unit usd --period weekSet a per-model cost cap:
npx greenclaw alerts set --name "gpt-4 cap" --metric per_model_cost --threshold 30 --unit usd --period day --model gpt-4Check alerts now:
npx greenclaw alerts checkView alert history:
npx greenclaw alerts history --last 10Remove an alert rule:
npx greenclaw alerts remove <rule-id>Raw Traces
Aggregated stats:
npx greenclaw traces --statsFilter by tier or model:
npx greenclaw traces --tier HEARTBEAT
npx greenclaw traces --model gpt-4o-miniHow to Present Results
- Parse the JSON output and present it in a clear, readable format
- For summaries: show total tokens, cost, savings, and request count
- For breakdowns: show a table with group key, tokens, cost, savings
- For alerts: explain which rules triggered and current metric values
- Round dollar amounts to 2 decimal places
- Use natural language to explain savings (e.g., "You saved $8.91 today by routing 412 requests through cheaper models")
Environment
The greenclaw CLI uses the GREENCLAW_TELEMETRY_DB environment variable for the SQLite database path (defaults to data/telemetry.db).