manavgup/context-analyzer

Context Analyzer

Context window usage analyzer for Claude Code. Tracks how context is consumed across tools, compaction, skills, and user interactions — then visualizes it so you can optimize your sessions.

What it does

• Hooks into Claude Code via ~/.claude/settings.json to capture tool calls, compaction events, session lifecycle, and subagent activity
• Parses transcripts for exact API token usage (input, output, cache_read, cache_creation)
• SQLite persistence stores session data (9 tables, 2,900+ rows per session) for fast queries and cross-session analysis
• Dashboard at / for single-session visualization: context growth, cache churn, composition, message inspector
• Cross-session analytics at /sessions for comparing patterns across sessions: cost/call vs context size, insights, trends

Prerequisites

• Python 3.11+
• uv — fast Python package manager
• make
• git

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

Quick Start

git clone https://github.com/manavgup/context-analyzer.git
cd context-analyzer
make install-dev       # create venv and install with uv
make hook-install      # install Claude Code hooks (optional — dashboard works without hooks)
make dev               # start dashboard on localhost:8080

Then open:

• http://localhost:8080/ — single-session dashboard (picks most recent session)
• http://localhost:8080/sessions — cross-session analytics

Upgrading

After upgrading context-tracker, re-run the installer to refresh the Claude Code hooks in ~/.claude/settings.json:

make hook-install      # or: context-tracker install

Older versions installed a hook command that could fail to import context_tracker (and broke on interpreter paths containing spaces). Reinstalling rewrites context-tracker's hook entries with the correct