Docs/Intelligence Layer/Token Savings Dashboard

Token Savings Dashboard

Measuring ROI

Hivemind tracks how much value it provides through three metrics:

Conflicts Prevented

Every time a task overlap or file conflict is detected and warned about, that's a conflict that would have caused duplicated or overwritten work.

Context Injections

Every task.created event represents a session where the agent received smart context via hivemind_status() instead of having to manually search for it.

Estimated Tokens Saved

Hivemind estimates the tokens saved by:

  • Context injection: ~2,000 tokens per hit (average codebase scan avoided)
  • Conflict prevention: ~5,000 tokens per conflict (wasted work avoided)
  • Duplicate detection: ~1,000 tokens per duplicate (redundant query avoided)

Viewing Savings

The dashboard shows a weekly summary card with these metrics. You can also query them via the API:

curl "https://jovial-tern-168.convex.site/v1/intelligence/savings?days=30" \
  -H "Authorization: Bearer hm_live_xxx"

Returns daily breakdowns and totals for the specified period.

Daily Calculation

Savings are calculated by a daily cron job that analyzes the previous day's events. The metrics accumulate over time, giving you a clear picture of the cumulative value Hivemind provides.