Synopsis
Description
cost provides visibility into AI API spending. It reads usage data from the profClaw server, which tracks token consumption per task, model, and agent. Use it to monitor budgets, identify expensive operations, and spot cost anomalies.
Subcommands
cost summary
Shows total cost, total tokens, task count, and the last 7 days of daily usage.
boolean
Output as JSON.
cost budget
Displays current daily spend against the configured daily budget limit. The progress bar changes color at 50% (yellow) and 80% (red). Shows a warning when the budget is exceeded.
boolean
Output as JSON with raw budget config and usage data.
cost analytics
Provides breakdowns by model and by agent, plus a 7-day daily table. Use this to identify which models or agents are driving costs.
boolean
Output as JSON.
Examples
Example Output
Budget Configuration
Set daily and monthly cost limits inconfig/settings.yml or via environment variables:
Related
profclaw status- System overview including provider healthprofclaw summary- Browse agent work summariesprofclaw agent- Agent stats including task counts