Pacman context-zone icon — Show a pacman-style glyph next to the zone label that reflects the current context zone, sharing the zone's traffic-light color. On by default; controlled by the new show_pacman toggle #98 PR number in statusline by default — Shows the current pull request number alongside the model name. Now enabled by default #95 Grouped statusline separators — Context usage, zone, and pacman icon are one visual group joined by unspaced · #101
Changelog relative paths — Corrected all relative paths (navigation, footer, favicon) in the changelog page #93 Logo path in changelog — Fixed the logo path references in the changelog navigation and footer #93 Changelog nav layout — Removed the search box and fixed the changelog navigation layout #101
Compare on GitHub →
Thinking level display — Show Claude Code thinking level next to the model name in the statusline #78, #80 Pull request indicator — Display the current PR number in the statusline via show_pr toggle #77, #79
Compare on GitHub →
tok/s throughput display — Optional tokens-per-second indicator showing real-time model generation speed as a smoothed, rolling average. Configurable via show_tps, tps_precision, tps_unit, tps_window #70, #71 tok/s trend graph — New context-stats graph --type tps renders an ASCII trend of per-turn throughput #72, #75
Tail-read tok/s history — Statusline now tail-reads only the last tps_window + 1 rows via bounded read_tail() instead of parsing the entire file #73, #74
Compare on GitHub →
Default to latest session — Session ID is now optional; the most recent session is auto-detected #60, #68 sessions subcommand — context-stats sessions lists recent sessions with project, model, token count, and last-activity time #60, #68
Stricter sessions argument validation — reject invalid --minutes values
Modernized prefix stripping to use removeprefix() (Python 3.9+)
Compare on GitHub →
Compaction event detection — Detect /compact events (>50% context drop) and annotate graphs with ▼ markers #62, #67 MI quality flagging at compaction — MI score captured and flagged if below warning threshold #65, #67 Actionable zone recommendations — Zone indicators now include brief recommendations #63, #66 Landing page — Static GitHub Pages landing page for ContextStats rebrand #66
Zone percentage thresholds corrected to match actual code
Landing page timeline arrows made visible
1M model zone thresholds recalibrated (300–400k tokens)
Brand identity — fresh logo for ContextStats rebrand
Compare on GitHub →
Mermaid charts — Added Mermaid-based charts to context-stats report for visual token analytics
Report period and session filtering corrected
Mermaid x-axis label overlap fixed
CI workflow cleanup — removed stale test reference
Report rewritten with full analytics: session summaries, token breakdowns, chart data
Python-only codebase finalised
Compare on GitHub →
Token usage analytics & reporting — Full token analytics with charts, summaries, and reporting #56, #57
Python-only migration complete — Removed shell script; single Python codebase #58, #59
Compare on GitHub →
cache-warm dispatch — Shell script now delegates cache-warm to Python CLI
Compare on GitHub →
Cache-warm subcommand — Keep a session's prompt cache alive via background daemon #49, #54 Cache graph type — --type cache visualizes cache creation and read activity #48 E2E install smoke tests — Pre-commit hook with clean install verification #51, #53
Action-based CLI — Redesigned to strict <session_id> <action> pattern #50, #52
Windows CI pytest-cov exit code, fork simulation tests, E2E test robustness
Compare on GitHub →
Auto-install Python package — Installer now bumps Python package alongside bash script #47 Version validation, circular dependency fix, error icon correction
Compare on GitHub →
Context report example and CLI coverage added
Export report structure refined: Generate block, Executive Snapshot, key takeaways
README reworked around context zones and next-action guidance
Compare on GitHub →
Export session stats as Markdown — context-stats export with --output support #45, #46
Compare on GitHub →
Example statusline.conf with full parameter reference #34, #35
UTF-8 encoding for config file I/O
Simplified config setup with bundled example
Autocompact default set to false
Compare on GitHub →
Configurable zone indicator thresholds — Override zone boundaries via config #27, #31 E2E CI tests — 4 new jobs across Ubuntu/macOS with multiple runtimes #30, #32
Compare on GitHub →
Unified colors — Context info and zone indicator now share the same traffic-light color #28
Compare on GitHub →
Per-property color support — Override colors for individual elements #23 5-state context zones — Plan/Code/Dump/ExDump/Dead with absolute thresholds #21
Statusline reordered — context info first, model name last
Full-word zone indicators (P/C/D → Plan/Code/Dump)
show_mi defaults to false
Compare on GitHub →
MI color thresholds adjusted (green ≥ 0.90, red ≤ 0.80)
Consistent | pipe separators everywhere
Delta repositioned after MI; model name without brackets
Autocompact (AC) indicator removed from statusline
Compare on GitHub →
MI redesign: pure utilization-based formula — MI(u) = max(0, 1 - u^beta) per-model profiles Michelangelo paper 3-decimal MI display (MI:0.995)
Color thresholds adjusted to simplified scale
ES (Efficiency Score) and PS (Productivity Score) removed from MI
Compare on GitHub →
Installation checker — check-install.sh verifies setup regardless of install methodMI monotonicity tests — 60 tests across Python, Node.js, Bash
Compare on GitHub →
Model Intelligence (MI) score — Heuristic quality score based on context utilization Michelangelo paper MI timeseries graph: context-stats --type mi
MI in session summary with sub-component breakdown (CPS, ES, PS)
Bash feature parity: custom colors, state rotation, MI display
Compare on GitHub →
Configurable colors — Custom themes via statusline.conf with 24-bit true color supportcontext-stats explain — Diagnostic dump of context and config
Compare on GitHub →
Delta calculation parity with Node.js
Duplicate-entry guard, state rotation, git timeout, exception handling
Delta parity tests (4 new bats tests)
Compare on GitHub →
Footer version drift and project name correction
Install version embedding from package.json
Compare on GitHub →
cli --version flag, state file rotation, session ID validation, git timeout51 core pipeline unit tests + cross-implementation parity test
Open-source files: CODE_OF_CONDUCT, CONTRIBUTING, SECURITY
NPM Package: cc-context-stats on npm
Compare on GitHub →
Context Zones — Smart/Dumb/Wrap Up with color-coded percentagesProject name display in header
Compare on GitHub →
BREAKING : Renamed from cc-statusline to cc-context-statsPivoted to real-time token monitoring and context tracking
Compare on GitHub →
Context showing negative values — using current_used_tokens
ANSI escape codes in watch mode
Compare on GitHub →
Comprehensive test suite (Bats, pytest, Jest) + GitHub Actions CI/CD
Code quality tools: ShellCheck, Ruff, ESLint, Prettier
Pre-commit hooks, EditorConfig, Dependabot, release automation
Full-featured statusline (bash, Python, Node.js)
Interactive installer, configuration, autocompact buffer
Git branch and uncommitted changes display
Compare on GitHub →