claude-panel
v2.1.1
Published
Local dashboard and control panel for Claude Code configuration
Maintainers
Readme
Manage configuration, plugins, commands, MCP servers, skill providers, and multiple Claude Code instances from a single UI.
Features
- Dashboard -- token breakdown, top consumers, optimization recommendations
- Settings -- environment variables, hooks, behavioral toggles
- Plugin Manager -- list, enable/disable, and inspect installed plugins with token estimates
- MCP Servers -- add, remove, and toggle Model Context Protocol servers
- Reliability -- MCP Doctor diagnostics, MCP health snapshots, CLAUDE.md drift feed, provider provenance lock view
- CLAUDE.md Editor -- recursive tree scanner with live editing for global and per-project files
- Custom Commands -- full CRUD for slash commands with namespace grouping
- Skill Providers -- add git-based providers, discover and install skills
- Config Bundles -- export, validate, and dry-run apply configuration-as-code bundles
- Skill Catalog -- unified view of installable skills across all providers
- Marketplace -- browse and install plugins from marketplaces
- Claude Code Router -- view provider status, models, routing rules
- Multi-Instance -- switch between multiple
~/.claude*configuration profiles - Visibility -- overview of commands, agents, and memory files
Platform Support
| Platform | Status | |----------|--------| | Linux | Supported | | macOS | Supported | | Windows | Supported |
Prerequisites
Install
npm install -g claude-panelOr run without installing globally:
npx claude-panelUsage
claude-panelBy default, Claude Panel tries port 8787. If that port is busy, it automatically selects a free port and prints the URL.
CLI Options
| Flag | Description |
|------|-------------|
| --port <number> | Use a specific port (fails if busy) |
| --no-open | Don't open the browser automatically |
| --help | Show usage information |
Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| CLAUDE_PANEL_PORT | Override the default port | 8787 |
| CLAUDE_PANEL_SCAN_ROOTS | Comma-separated scan roots for CLAUDE.md discovery | Home directory |
Troubleshooting
uv not found
Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
Python not found
Ensure python3 (or python) 3.12+ is installed and on your PATH.
Port already in use
Either let Claude Panel auto-select a free port, use --port <number> with a different port, or set CLAUDE_PANEL_PORT to change the default.
First run is slow
On first launch, uv creates a Python virtual environment and installs backend dependencies. Subsequent starts are fast.
Local Development
Build frontend assets into the backend static directory:
npm run build:frontendRun the packaged launcher locally:
npm startStart both backend and frontend dev servers (hot-reload):
bash scripts/dev.shSee CONTRIBUTING.md for full development setup and contribution guidelines.
Publishing
The prepack lifecycle script automatically runs npm ci in the frontend directory and builds static assets, so npm publish produces a ready-to-run package.
License
Disclaimer
Claude Panel is an independent open-source project and is not affiliated with, endorsed by, or officially connected to Anthropic, PBC. "Claude" is a trademark of Anthropic.
