Skip to main content

Local web dashboard for your installed Claude Code configuration — plugins, agents, skills, commands, hooks, MCP servers, and rules, with usage analytics.

Project description

claude-config-dashboard

CI PyPI Python License: MIT

A local web dashboard for everything installed in your ~/.claude — plugins, agents, skills, commands, hooks, MCP servers, and rules — with usage analytics pulled from your session history, and a project-only view that diffs your current project's .claude against your home config. Ships as a standalone CLI (PyPI) and as a Claude Code plugin.

Unlike config managers, this is a deliberately read-only, zero-dependency analyzer (Python stdlib, no Node/React/build step): it tells you what your config costs. The Context Tax shows the number of tokens measured from your own session transcripts that every session starts with before you type anything — not a chars ÷ 4 estimate, so it already includes the system prompt and MCP tool schemas. Alongside it, a home banner surfaces the gap /context can't: how many of your installed agents, skills, and MCP servers you've actually used (e.g. "77 installed, 4 used"). For anything unused for 30+ days, it can generate a plain shell script that archives it (mv, never rm) for you to review and run yourself. The dashboard never touches your filesystem on its own.

Claude Config Dashboard demo: tab tour, Context Tax token estimate, and cleanup script download

Install & run

No install, always latest (uv):

uvx claude-config-dashboard

pip:

pip install claude-config-dashboard
claude-config-dashboard

Claude Code plugin (adds the /claude-config-dashboard:show slash command):

/plugin marketplace add AshtonYoon/claude-config-dashboard
/plugin install claude-config-dashboard
/reload-plugins

then run /claude-config-dashboard:show inside Claude Code.

All three open the dashboard at http://localhost:9876. Pass --port to use a different one, or --no-open to skip launching a browser.

Features

Tab Contents
Plugins Installed plugins with version, GitHub link, install date
Agents Agents grouped by category — click name to open file
Skills Custom and plugin-provided skills
Commands Slash commands with descriptions — click to open file
Hooks Hook scripts by trigger type — click to open script
MCP Servers Configured MCP servers from settings.json and ~/.claude.json
Rules Rule files by category — click to open file
Context Tax Estimated tokens your config adds to every session, per item, plus a downloadable cleanup script (archive-only, review before running) for unused items
Cleanup Agents, skills, and MCP servers unused for 30+ days
Project-only config MCP servers, skills, commands, hooks, and rules that exist only in the current project's .claude

Clicking any file name opens it in the OS default app (editor, Finder, etc.). Usage counts and "last used" come from parsing your local session transcripts — nothing leaves your machine.

Security

The dashboard binds to localhost only. Opening a file (/open) or stopping the server (/stop) requires a per-run token embedded in the page and only accepts paths the dashboard itself is already showing you — a malicious web page open in another tab cannot trigger either endpoint. See CHANGELOG.md (v1.6.1) for the fix history.

Update

/plugin update claude-config-dashboard
/reload-plugins

If /plugin update shows a "browse plugins" prompt instead of updating directly, the local marketplace cache is stale. Run this once to refresh it:

cd ~/.claude/plugins/marketplaces/claude-config-dashboard && git pull

Then retry /plugin update claude-config-dashboard.

pip/uvx installs pick up new releases automatically the next time you run them (uvx always fetches latest; pip install -U claude-config-dashboard to upgrade an existing install).

Development

git clone https://github.com/AshtonYoon/claude-config-dashboard
cd claude-config-dashboard
uv venv .venv && uv pip install -p .venv pytest pytest-cov ruff

.venv/bin/pytest --cov            # 67 tests, coverage gate at 80%
.venv/bin/ruff check .
.venv/bin/ruff format .

The app lives in claude_config_dashboard/ (collectors → usage → enrich → render → server); dashboard.py at the repo root is a thin backward-compatible launcher for the plugin command. Design notes: docs/DESIGN.md.

Requirements

  • Python ≥ 3.9, standard library only at runtime (no dependencies to install)
  • macOS or Linux (uses open/xdg-open to launch default apps)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_config_dashboard-1.10.0.tar.gz (3.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_config_dashboard-1.10.0-py3-none-any.whl (34.4 kB view details)

Uploaded Python 3

File details

Details for the file claude_config_dashboard-1.10.0.tar.gz.

File metadata

  • Download URL: claude_config_dashboard-1.10.0.tar.gz
  • Upload date:
  • Size: 3.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for claude_config_dashboard-1.10.0.tar.gz
Algorithm Hash digest
SHA256 4985ad3e3324eef6dfbf24f209f398bbf37c85dbfb4f8a3a1017383c3ff2159b
MD5 22a2ac146b2bb163d7ebbe250d202370
BLAKE2b-256 014d9ccd099d8b3edb9c915364907c7fb8d4f9a45b46071253fd4a8e206a9fe0

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_config_dashboard-1.10.0.tar.gz:

Publisher: release.yml on AshtonYoon/claude-config-dashboard

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file claude_config_dashboard-1.10.0-py3-none-any.whl.

File metadata

File hashes

Hashes for claude_config_dashboard-1.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9b4f3f314bc3a413518cccceaa742dbf073465630680f53515c5d78516f2bd36
MD5 5a980d23d4207f4da1d62a39dd71864a
BLAKE2b-256 5f4b1822f02408f26e6dbfab4fa4243400bad089c4dd095cd6c45bd173f27e51

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_config_dashboard-1.10.0-py3-none-any.whl:

Publisher: release.yml on AshtonYoon/claude-config-dashboard

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page