cc-compact

How often does Claude Code hit the context limit? Shows compaction frequency, pre-compaction token counts, and trigger type breakdown.

cc-compact — Claude Code context compaction stats

  Total sessions:       755
  Sessions compacted:   137 (18.1% of sessions)
  Total compactions:    912
  Avg per compacted:    6.7 compactions/session
  Trigger:              883 auto  /  29 manual

  Pre-compaction context size:
    Min:    71.1K tokens
    Avg:    163.9K tokens
    Median: 167.3K tokens
    Max:    190.3K tokens

────────────────────────────────────────────────────────
  Context size at compaction

  <100K       ░░░░░░░░░░░░░░░░░░░░░░░░     9  (1.0%)
  100–150K    ░░░░░░░░░░░░░░░░░░░░░░░░     9  (1.0%)
  150–175K    ████████████████████████   870  (95.4%)
  175K+       █░░░░░░░░░░░░░░░░░░░░░░░    24  (2.6%)

Usage

npx cc-compact          # Compaction frequency and token stats
npx cc-compact --json   # JSON output

What it shows

• Compaction rate — percentage of sessions that hit the context limit
• Total compactions — how many times Claude Code auto-compacted
• Trigger breakdown — auto (limit hit) vs manual (/compact command)
• Pre-compaction size — context size at the moment of compaction
• Size distribution — where in the token range compactions happen
• Monthly trend — compaction frequency over time
• By project — which projects burn through context fastest

What compaction means

When Claude Code's context window fills up, it automatically compacts (summarizes) the conversation to free up space. This is called an "auto" compaction.

• Auto compaction (96.8% of cases): hit the limit, context summarized automatically
• Manual compaction (3.2% of cases): user typed /compact before hitting the limit

95.4% of auto-compactions happen between 150K–175K tokens — just below the typical 200K context limit.

Privacy

Reads session files looking for compaction event markers. No content is transmitted. Everything runs locally.

Browser version

Drop your ~/.claude folder into cc-compact on the web — no install required.

Part of cc-toolkit — 87 free tools for Claude Code