context-window-manager

Claude Code Context Window Manager

A comprehensive plugin for monitoring, analyzing, and optimizing your Claude Code context window usage. Stay in control of your context and maximize productivity with real-time tracking, intelligent alerts, and actionable insights.

🎯 Features

📊 Real-Time Monitoring

• Live Context Tracking: Automatic monitoring of token usage throughout your session
• Usage Alerts: Configurable thresholds warn you before hitting limits
• Session Metrics: Track tool calls, files accessed, and token consumption patterns

🔍 Deep Analysis

• Slash Commands: Quick status checks and detailed usage reports
• AI-Powered Skills: Sophisticated analysis using specialized AI capabilities
• Historical Tracking: Compare current session against your usage history

⚡ Smart Optimization

• Actionable Recommendations: Get specific steps to reduce context bloat
• Impact Estimation: See exactly how many tokens each optimization will save
• Automated Logging: Hooks track usage automatically without manual intervention

📈 Comprehensive Reporting

• Multiple Formats: Export data as JSON, CSV, or Markdown
• Visual Indicators: Progress bars, health status, and trend charts
• Session Archives: Complete history of all your Claude Code sessions

⚡ NEW: Advanced Features

🤖 Agent-Powered Analysis (10x Faster!)

• Context Analyzer Agent: Complete analysis in <2 minutes (vs 10-15 min manual)
• Context Pruner Agent: Intelligent pruning in <90 seconds
• Parallel Processing: Multiple analyses run simultaneously for maximum speed

🔪 Auto-Pruning System

• Smart Detection: Automatically identifies unused files, old logs, and temporary content
• Safe Removal: Only removes low-risk items with zero chance of data loss
• Configurable Rules: Set patterns for always-prune, always-keep files
• Token Savings: Average 40,000-70,000 tokens saved per comprehensive prune

🗺️ Context Knowledge Mapping

• Real-Time Tracking: Maintains live database of everything in context
• Access Heatmaps: Visual representation of file usage patterns
• Dependency Graphs: See relationships between files and tools
• Predictive Analysis: Estimates future usage and time to limits

💰 Token Savings Tracker

• Lifetime Statistics: Track cumulative token savings across all sessions
• ROI Calculator: See return on optimization investment
• Gamification: Milestones, leaderboards, and achievement tracking
• Scenario Simulator: Preview savings from different optimization strategies

📖 See FEATURES.md for complete details on advanced features

🚀 Quick Start

Installation

1. Clone or download this plugin:

   git clone <repository-url> context-window-manager
   cd context-window-manager
   

2. Test locally with Claude Code:

   claude --plugin-dir ./
   

3. Install permanently (optional):

   # Copy to Claude Code plugins directory
   mkdir -p ~/.claude/plugins
   cp -r . ~/.claude/plugins/context-window-manager
   

First Use

Once loaded, try these commands in your Claude Code session:

# Quick status check
/context-window-manager:status

# Detailed analysis (agent-powered, fast!)
/context-window-manager:analyze

# Auto-prune unused context (NEW!)
/context-window-manager:prune

# View context knowledge map (NEW!)
/context-window-manager:context-map

# Track token savings (NEW!)
/context-window-manager:savings

# Get optimization recommendations
/context-window-manager:optimize

# Generate full report
/context-window-manager:report

📘 New to the plugin? Read QUICKSTART.md for a 5-minute guided tour!

📖 Documentation

Slash Commands

The plugin provides six powerful slash commands:

/context-window-manager:status

Quick at-a-glance status check with visual indicator.

Use when: You want a fast check without detailed analysis.

Output:

┌─────────────────────────────────────────────────┐
│ CONTEXT WINDOW STATUS                           │
├─────────────────────────────────────────────────┤
│ Capacity:   200K tokens                         │
│ Used:       72,000 tokens (36%)                 │
│ Available:  128,000 tokens (64%)                │
│ Status:     🟢 Healthy                          │
│                                                 │
│ Progress: [███████░░░░░░░░░] 36%               │
└─────────────────────────────────────────────────┘

/context-window-manager:analyze

Deep analysis of current context usage with optimization recommendations.

Use when: You want to understand what's consuming your context.

Output includes:

• Current usage breakdown by component
• Top context consumers
• Token burn rate and time projections
• Health status and recommendations