Skip to content

Releases: roeimichael/ContextAnalyzerTerminal

TUI Visual Overhaul & Project Rename

Choose a tag to compare

@roeimichael roeimichael released this 07 Apr 21:40

Project Rename

  • Renamed from context-pulse to context-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

Choose a tag to compare

@roeimichael roeimichael released this 05 Apr 17:50

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-raw endpoint for users with their own statusline scripts

Quality & UX

  • 21 pre-launch fixes (security, async correctness, privacy)
  • context-pulse uninstall command 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 dashboard

Full changelog: v0.1.0...v0.2.0

v0.1.0 — Initial Release

Choose a tag to compare

@roeimichael roeimichael released this 05 Apr 17:49

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