CLICommands
meter
snug meter <COMMAND>Meter - Usage metering, quotas, and billing rollups.
Subcommands
| Command | What it does |
|---|---|
metrics | Manage metric definitions |
log | Record a usage event (shorthand: meter log tokens:500) |
batch-log | Record many usage events from a JSON file (array of event objects) |
usage | Query usage totals |
check | Preflight a quota or budget check |
reserve | Reserve budget for upcoming work |
commit | Commit actual usage against a reservation |
reports | List durable usage reports |
generate-report | Generate a durable usage report (admin or billing_admin) |
estimate | Estimate cost for a number of units using graduated pricing |
top | List top consumers |
forecast | Forecast end-of-period usage |
alarms | List quota alarms |
Run snug meter <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug meter metrics create --file ./llm-tokens.json
snug meter metrics list --page-size 10
snug meter metrics get --metric llm.tokens
snug meter log user_123 tokens:500 --metric llm.tokens --dimension model=gpt-5-mini
snug meter usage @me --metric llm.tokens --period day
snug meter check --metric llm.tokens --planned-units 1000
snug meter reserve --metric llm.tokens --units 2000
snug meter commit --metric llm.tokens --reservation-id rsv_abc --actual-units 1500
snug meter reports --metric llm.tokens
snug meter generate-report --metric llm.tokens --period day
snug meter estimate --metric llm.tokens --units 1500000
snug meter top --metric llm.tokens --dimension user_id --period today
snug meter forecast --metric llm.tokens --user-id user_123
snug meter alarms --metric llm.tokensNext
- meter guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.