Claude Code Manager
See all your MCP servers, skills, commands, rules, and CLAUDE.md files in one place — TUI for Claude Code
Ask AI about Claude Code Manager
Powered by Claude · Grounded in docs
I know everything about Claude Code Manager. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Claude Code Manager
See all your MCP servers, skills, commands, rules, and CLAUDE.md files in one place — across every project on your machine
Quick Start | Features | Usage | Configuration | Contributing
Quick Start
Option 1: pip (simplest)
pip install ccmanager
ccmanager ~/Projects
Option 2: uv tool (fastest, isolated)
uv tool install ccmanager
ccmanager ~/Projects
Don't have uv? Install it: curl -LsSf https://astral.sh/uv/install.sh | sh
Option 3: From Source
git clone https://github.com/simonstrumse/claude-code-manager.git
cd claude-code-manager
pip install -e .
ccmanager ~/Projects
"command not found"?
On macOS, pip installs to ~/Library/Python/3.x/bin/ which may not be in PATH. Fix:
echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Or use uv tool above — it handles PATH automatically.
Features
- Multi-Project Scanning — Scan an entire folder of projects and see all configurations at a glance
- 6 Configuration Tabs — Projects, MCP Servers, Skills, Commands, Rules, CLAUDE.md
- Content Preview — Press Enter to view full content of any skill, command, rule, or CLAUDE.md
- Cross-Navigation — Jump between projects and their MCP servers with
gandskeys - Project Discovery — Find Claude Code projects scattered across your system
- Usage Analytics — See which MCP servers are used most across your projects
- Privacy Mode — Toggle
pto redact project names for screenshots
Usage
Launch the TUI
ccmanager ~/Projects # Scan a projects folder
ccmanager # Scan current directory
Keyboard Navigation
| Key | Action |
|---|---|
1-6 | Switch tabs (1=Projects, 2=MCP, 3=Skills, 4=Commands, 5=Rules, 6=CLAUDE.md) |
↑↓ | Navigate list items |
Tab | Move focus: list → detail panel |
Enter | Preview full content |
g | Go to project's MCP servers |
s | Show server's projects |
o | Open in Finder (macOS) |
d | Discover projects across system |
p | Toggle privacy mode |
r | Refresh scan |
? | Show help |
q | Quit |
Tabs Overview
| Tab | What it shows |
|---|---|
| Projects | All scanned projects with config counts |
| MCP | All MCP servers ranked by usage |
| Skills | User and project skills |
| Commands | Slash commands (/commit, etc.) |
| Rules | Always-on instruction files |
| CLAUDE.md | Project documentation files |
What It Scans
The tool understands Claude Code's configuration precedence:
| Level | Location | Priority |
|---|---|---|
| Enterprise | /Library/Application Support/ClaudeCode/ | Highest |
| Local | ~/.claude.json → projects[path] | 2nd |
| Project | .mcp.json | 3rd |
| User | ~/.claude.json → mcpServers | Lowest |
Scanned Locations
- MCP Servers: Enterprise, User, Project, Local levels
- Skills:
~/.claude/skills/*/SKILL.mdand.claude/skills/*/SKILL.md - Commands:
~/.claude/commands/*.mdand.claude/commands/*.md - Rules:
~/.claude/rules/**/*.mdand.claude/rules/**/*.md - CLAUDE.md: Root,
.claude/, subdirectories, local variants
Project Structure
claude-code-manager/
├── mcp_tui.py # Main TUI application (Textual)
├── mcp_scanner.py # Configuration scanning logic
├── mcp_data.py # Data models and classes
├── mcp_config.py # User settings management
├── mcp_operations.py # Project move/consolidate operations
├── requirements.txt # Python dependencies
└── CHANGELOG.md # Development history
Contributing
Contributions welcome! This is a learning project, so please be patient and constructive.
Development Setup
git clone https://github.com/YOUR_USERNAME/claude-code-manager.git
cd claude-code-manager
python3 -m venv venv && source venv/activate
pip install -e .
Guidelines
- Test your changes — Make sure the TUI runs without crashing
- Follow existing patterns — Look at how similar features are implemented
- Document changes — Update CHANGELOG.md for significant changes
- Keep it simple — Prefer readable code over clever code
Troubleshooting
"No projects found"
- Make sure you're pointing to a directory that contains Claude Code projects
- Projects need
.git,.mcp.json, or.claude/folder to be detected
Not finding my MCP servers or skills
Run with --debug to see what paths are being checked:
ccmanager --debug ~/Projects
The scanner looks for:
- MCP servers:
~/.claude.json→mcpServerskey (camelCase!) - Skills:
~/.claude/skills/*/SKILL.md(each skill needs its own folder) - Project MCP:
.mcp.json→mcpServerskey in each project
Common issues:
- Wrong key name (
mcp_serversvsmcpServers) - Skills missing
SKILL.mdfile inside the folder
TUI looks broken
- Make sure your terminal supports Unicode
- Try a different terminal (iTerm2, Alacritty, Windows Terminal)
- Ensure terminal is at least 100 columns wide
Preview not opening
- Tab to focus the detail panel first
- Then press Enter
- Press Escape or 'q' to close the preview
License
MIT License — see LICENSE file.
Acknowledgments
- Built with Textual — the amazing Python TUI framework
- Inspired by the need to understand Claude Code's configuration system
- Thanks to Anthropic for creating Claude Code
Safe Computing Reminder: Always review code from the internet before running it. This tool only reads your configuration files — it doesn't modify anything without your explicit action.