Usage ledger

Every AgentHub command appends a row to .hub/usage.json. That file is project-local, gitignored by default, and never sent anywhere. /hub:ledger is a LIGHT command that reads and aggregates it locally.

Views

• /hub:ledger — default summary, last 7 days.
• /hub:ledger weekly — ISO-week totals by tier, top agents, top skills.
• /hub:ledger by-agent — aggregate spend by agent.
• /hub:ledger by-skill — aggregate spend by skill.
• /hub:ledger by-tier — observed tokens vs. declared tier.
• /hub:ledger roi — useful / wasted / partial ratios based on runs you tag.

Tagging ROI

After a command finishes, you can tag the run to feed ledger roi:

/hub:ledger tag last useful       # the output was directly useful
/hub:ledger tag last partial      # some use, needed rework
/hub:ledger tag last wasted       # output was discarded

Honesty contract

Every token number in AgentHub output is prefixed with ~. We never convert to dollars, and we never display a provider quota or reset-timestamp number unless you paste it in yourself.

Privacy

.hub/usage.json is gitignored. .hub/budget.json (optional project-local budget override) is also gitignored. .hub/instincts.yaml(team preferences) is git-tracked by default — it's meant to be shared.