About The Project

Ever wondered why Claude seems to forget things or runs slower than expected? It might be context bloat!

Claude Context Doctor helps you see exactly what's eating up your context window - skills, plugins, MCP servers - and gives you actionable recommendations to slim things down.

What it does:

• Shows all your installed skills and their sizes
• Lists plugins with enabled/disabled status
• Checks MCP server health
• Calculates total context usage (tokens)
• Gives specific recommendations to reduce bloat
• Lets you toggle plugins on/off directly from the TUI

Built With

• Rust
• Ratatui - Terminal UI framework
• Crossterm - Cross-platform terminal manipulation

Installation

Quick Run (no install)

Just want to try it? Run this one-liner - it downloads, runs, and cleans up automatically:

curl -fsSL https://raw.githubusercontent.com/Demwunz/claude-context-doctor/main/install.sh | sh

Homebrew (macOS/Linux)

brew install Demwunz/tap/claude-context-doctor

Shell Install Script

curl -fsSL https://raw.githubusercontent.com/Demwunz/claude-context-doctor/main/install.sh | sh -s -- --install

Download Binary

Download from the Releases page (macOS, Linux, Windows).

From Source

cargo install --git https://github.com/Demwunz/claude-context-doctor.git

Usage

Interactive TUI mode:

claude-context-doctor

Navigate with:

• Tab or 1-5 to switch panels
• j/k or arrows to navigate lists
• Enter to toggle plugins on/off
• ? for help
• q, Esc, or Ctrl+C to quit

Report mode (non-interactive):

claude-context-doctor --report-only

JSON output:

claude-context-doctor --report-only --format json

Example Output

## Context Usage
  Skills:      18.7K tokens
  Plugins:     19.2K tokens
  MCP:         0 tokens
  Base System: 5.0K tokens
  TOTAL:       42.9K / 200.0K tokens (21%)

## Recommendations
  [*] Disable 'pr-review-toolkit' to save ~11K tokens
      This plugin uses 44.8KB of context. Press Enter in Plugins panel to toggle.

Roadmap

• Skills inspection with size calculation
• Plugin management with toggle support
• MCP server health checks
• Context usage estimation
• Actionable recommendations
• Skill content preview
• Backup/restore configuration
• Compare context usage over time

Contributing

Contributions make the open source community amazing. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgments

• Anthropic for Claude
• Ratatui for the excellent TUI framework
• Best-README-Template for the README structure