Releases: roeimichael/ContextAnalyzerTerminal
Releases · roeimichael/ContextAnalyzerTerminal
Release list
TUI Visual Overhaul & Project Rename
Project Rename
- Renamed from
context-pulsetocontext-analyzer-tool-- package, module, CLI entry point, and all internal references updated
TUI Visual Overhaul
- New color theme -- vibrant bright_* color palette with centralized theme constants
- Distinct panel frames -- HEAVY header, ROUNDED sessions/anomalies, DOUBLE tasks
- Alternating row highlights -- zebra-striping on all tables
- Unicode panel icons -- decorative icons in panel titles and header bar
- Header bar redesign -- stats separated by dividers with icons
- Sleeping cat animation -- 20-frame ASCII cat in the bottom-left nap zone with drifting z's, ear twitches, and a brief wake-up frame
- Double-bordered nap zone -- outer DOUBLE frame with inner ROUNDED border
- Faster refresh -- default refresh rate increased from 2s to 1s for smoother animations
v0.2.0 — Smart Warnings & Cache Awareness
What's New
Smart Warnings
- Context warnings suggest /compact and /clear — actionable advice at 60%, 70%, and 90% context thresholds
- Large tool output alerting — warns when a single tool response exceeds 5K tokens
- Overhead ratio in statusline — shows "cost: 3.2x fresh" when per-message cost is high
Cache Awareness
- Cache miss detection — detects when the 5-minute prompt cache expires and warns about rebuild cost
- Cache efficiency % in dashboard — new column showing cache hit ratio per session
Burn Rate & Compaction
- Burn rate projection — "fills in ~X turns" column in dashboard using linear regression
- PreCompact/PostCompact hooks — track compaction events with tokens saved
- Custom statusline compatibility — new
/hook/statusline-rawendpoint for users with their own statusline scripts
Quality & UX
- 21 pre-launch fixes (security, async correctness, privacy)
context-pulse uninstallcommand for clean hook removal- Fixed task timeline showing gibberish for inactive sessions
- 113 tests, strict type checking, full lint coverage
Getting Started
git clone https://github.com/roeimichael/ContextAnalyzerTerminal.git
cd ContextAnalyzerTerminal
uv sync
context-pulse install
context-pulse serve
context-pulse dashboardFull changelog: v0.1.0...v0.2.0
v0.1.0 — Initial Release
CAT (Context Analyzer Terminal) — Initial Release
Per-tool-call context window analyzer for Claude Code.
Features
- Per-tool-call token tracking via Claude Code hooks (PostToolUse, SubagentStop, Stop, UserPromptSubmit, SessionStart, Statusline)
- Token delta engine that correlates statusline snapshots with tool-use events to compute per-call costs
- Rolling baselines using Welford's online algorithm (O(1) memory, 20-sample window per task type)
- Anomaly detection with configurable Z-score thresholds and cooldown periods
- LLM root-cause classification via Haiku — explains why a tool call was expensive
- Multi-channel notifications: system alerts (macOS/Linux), webhooks (Slack/Discord), statusline badges, in-session alerts
- Rich TUI dashboard with live session tracking, anomaly history, and baseline stats
- Multi-session support — tracks concurrent Claude Code sessions by session ID
- SQLite persistence with async I/O, schema migrations, and data retention policies
- TOML configuration with environment variable overrides
- Full CLI via Typer:
serve,dashboard,status,anomalies,health,install,prune
Getting Started
git clone https://github.com/roeimichael/ContextAnalyzerTerminal.git
cd ContextAnalyzerTerminal
uv sync
context-pulse install
context-pulse serve