Problem
CAT has a full compaction_events table and a /api/compactions endpoint, but no CLI command to view compactions and no dashboard panel showing them. Compactions are critical events where the context window is reset — users need visibility into how often this happens and how many tokens are recovered.
What to do
Add a compactions CLI command to src/context_analyzer_tool/cli.py that:
- Hits the existing
/api/compactions endpoint
- Renders a Rich table with columns: Time, Session, Trigger, Tokens Before, Tokens After, Tokens Saved
Files to look at
src/context_analyzer_tool/collector/routes.py — the /api/compactions endpoint already existssrc/context_analyzer_tool/cli.py — follow the pattern of anomalies commandsrc/context_analyzer_tool/db/compaction.py — DB layer (already done)
Why this is a good first issue
The backend is 100% done. This is purely a presentation task — call an existing API and format the response. Great for learning the CLI → API pattern.
Problem
CAT has a full
compaction_eventstable and a/api/compactionsendpoint, but no CLI command to view compactions and no dashboard panel showing them. Compactions are critical events where the context window is reset — users need visibility into how often this happens and how many tokens are recovered.What to do
Add a
compactionsCLI command tosrc/context_analyzer_tool/cli.pythat:/api/compactionsendpointFiles to look at
src/context_analyzer_tool/collector/routes.py— the/api/compactionsendpoint already existssrc/context_analyzer_tool/cli.py— follow the pattern ofanomaliescommandsrc/context_analyzer_tool/db/compaction.py— DB layer (already done)Why this is a good first issue
The backend is 100% done. This is purely a presentation task — call an existing API and format the response. Great for learning the CLI → API pattern.