Reports and Visuals

TokenPilot provides built-in reporting and a visual inspector so you can see exactly what it's doing.

The Report Command

The report command shows a summary of token usage, cache efficiency, and cost savings for the current session:

# Standalone CLI
lightmem2 report

# Per-host
lightmem2 openclaw report
lightmem2 codex report
lightmem2 claude-code report

# Inside OpenClaw
/lightmem2 report

What Each Metric Means

Metric	Description
Input tokens	Total tokens sent to the model (lower is better)
Cache read	Tokens served from the model API cache (higher is better)
Cache miss	Tokens that had to be recomputed (lower is better)
Output tokens	Tokens generated by the model
Cost	Estimated API cost in USD
Cache hit rate	Percentage of input tokens served from cache

Visual Inspector

The visual inspector is a browser-based dashboard showing real-time TokenPilot behavior:

lightmem2 visual

This opens your default browser with three views: stabilizer, reduction, and eviction.

Next

• Benchmarks — evaluation results
• Troubleshooting — common problems
• CLI Reference — all commands