Stats
Actions
Available In
Tags
Plugin
interstat
Token efficiency benchmarking, session analytics, and API-equivalent cost analysis for agent workflows
What's Inside
Skills4
interstat-analyze
/analyze
Parse conversation JSONL files and backfill token counts into SQLite
interstat-cost
/cost
Show API-equivalent cost analysis with model-specific pricing and subscription leverage
interstat-report
/report
Show token efficiency analysis and decision gate verdict
interstat-status
/status
Show collection progress and pending parse status
README
interstat
Token efficiency benchmarking for Claude Code.
What this does
interstat answers the question "am I actually using tokens efficiently or just burning through context?" It captures tool usage events in real-time via a PostToolUse:Task hook, backfills token data from JSONL transcripts at session end, and produces reports with percentiles and a decision gate.
The two-phase data collection is deliberate: real-time hooks capture the event structure (which tools, what order, how many subagents) while the JSONL backfill captures the actual token counts (not available during the session). Together they give you a complete picture of where tokens are going.
Installation
First, add the interagency marketplace (one-time setup):
/plugin marketplace add mistakeknot/interagency-marketplace
Then install the plugin:
/plugin install interstat
Usage
Generate a token efficiency report:
/interstat:interstat-report
Check current session metrics:
/interstat:interstat-status
Deep analysis of usage patterns:
/interstat:interstat-analyze
Architecture
hooks/
post-tool-use.sh PostToolUse:Task: real-time event capture to SQLite
session-end.sh SessionEnd: JSONL parsing for token backfill
skills/
report/ Percentile analysis with decision gate
status/ Current session snapshot
analyze/ Deep pattern analysis
Data lives in ~/.claude/interstat/metrics.db (SQLite, WAL mode for concurrent hook writes).
Stats
Version0.3.1
LanguageShell
Stars1
MaintenanceExcellent
LicenseMIT
Last Commit
Added
Available In
Safety Signals
Critical
Matches all tools
Hooks run on every tool call, not just specific ones
Tags
Categories
'%20stop-opacity%3D'0.16'%2F%3E%3Cstop%20offset%3D'1'%20stop-color%3D'rgb(200%2C90%2C60)'%20stop-opacity%3D'0.03'%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D'320'%20height%3D'200'%20fill%3D'url(%23g)'%2F%3E%3Ccircle%20cx%3D'250'%20cy%3D'56'%20r%3D'92'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.06'%2F%3E%3Ccircle%20cx%3D'64'%20cy%3D'172'%20r%3D'58'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.05'%2F%3E%3C%2Fsvg%3E)
