@laststance/claude-plugin-dashboard
v0.2.0
Published
Interactive CLI dashboard to manage Claude Code plugins
Maintainers
Readme
Claude Code Plugin Dashboard
An interactive CLI dashboard to browse, install, and manage Claude Code plugins. Built with Ink (React for CLI).
Features
- 🔍 Discover - Browse 100+ plugins from multiple marketplaces
- 📦 Install/Uninstall - Install and uninstall plugins directly from the dashboard
- ✅ Enable/Disable - Toggle plugins on/off with a single key
- 🏪 Marketplaces - Explore plugin sources
- ⚠️ Errors - Debug plugin issues
- ⌨️ Keyboard-driven - Full keyboard navigation with Emacs-style shortcuts
- 🎨 Beautiful TUI - Terminal UI that matches Claude Code's design
Prerequisites
- Node.js 20 or later
- Claude Code installed (
~/.claudedirectory must exist)
Installation
npm install -g @laststance/claude-plugin-dashboardUsage
Interactive Mode
claude-plugin-dashboardThis opens the interactive TUI dashboard.
Keyboard Shortcuts:
| Key | Action |
| --------- | ------------------------------------------- |
| ← → | Switch tabs |
| ↑ ↓ | Navigate list |
| ^P ^N | Navigate list (Emacs-style) |
| i | Install selected plugin |
| u | Uninstall selected plugin (with confirm) |
| Space | Toggle plugin enable/disable |
| Enter | View details / Toggle |
| / | Search plugins |
| s | Cycle sort options (Installs → Name → Date) |
| S | Toggle sort order (Asc/Desc) |
| Tab | Next tab |
| Esc | Clear search / Cancel |
| q | Quit |
Command Line Mode
# Show summary statistics
claude-plugin-dashboard status
# List all plugins
claude-plugin-dashboard list
# List installed plugins only
claude-plugin-dashboard list --installed
# List plugins from specific marketplace
claude-plugin-dashboard list --marketplace claude-plugins-official
# Show plugin details
claude-plugin-dashboard info context7@claude-plugins-official
# Enable a plugin
claude-plugin-dashboard enable context7@claude-plugins-official
# Disable a plugin
claude-plugin-dashboard disable context7@claude-plugins-official
# Toggle plugin state
claude-plugin-dashboard toggle context7@claude-plugins-official
# Show help
claude-plugin-dashboard helpDashboard Tabs
Discover
Browse all available plugins from all configured marketplaces:
- Search by name, description, or tags
- Sort by install count, name, or date
- Install plugins with
ikey - View plugin details including install count and description
Installed
Manage your installed plugins:
- See enabled (●) and disabled (◐) status at a glance
- Toggle plugins on/off with
Space - Uninstall plugins with
u(with Y/N confirmation) - View installation details
Marketplaces
Explore plugin sources:
- View all configured marketplaces
- See plugin counts per marketplace
- Check last update times
Errors
Debug plugin issues:
- View plugin-related errors
- Check error details and timestamps
How It Works
This tool reads and modifies Claude Code's configuration files:
| File | Purpose |
| --------------------------------------------- | --------------------------- |
| ~/.claude/settings.json | Plugin enable/disable state |
| ~/.claude/plugins/installed_plugins.json | Installation metadata |
| ~/.claude/plugins/known_marketplaces.json | Marketplace sources |
| ~/.claude/plugins/install-counts-cache.json | Global install statistics |
| ~/.claude/plugins/marketplaces/ | Plugin catalogs |
Note: The dashboard executes claude plugin install/uninstall commands internally via subprocess.
Status Icons
| Icon | Meaning | | ---------- | -------------------- | | ● (green) | Installed & Enabled | | ◐ (yellow) | Installed & Disabled | | ○ (gray) | Not Installed |
Troubleshooting
"Claude Code not found"
Make sure Claude Code is installed and ~/.claude directory exists.
ls -la ~/.claude/settings.json"Permission denied"
Check that you have read/write access to ~/.claude/settings.json.
chmod 644 ~/.claude/settings.jsonPlugins not showing up
Run the status command to check data:
claude-plugin-dashboard statusIf counts are zero, ensure Claude Code has been used at least once to initialize the plugin directory.
Cross-Platform Support
This tool works on:
- ✅ macOS
- ✅ Linux
- ✅ Windows (with Node.js 20+)
The tool uses os.homedir() and path.join() for cross-platform path handling.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Local Development
git clone https://github.com/laststance/claude-code-plugin-dashboard.git
cd claude-code-plugin-dashboard
pnpm install
pnpm build
pnpm startTech Stack
- Ink v5 - React for CLI
- React 18 - UI components
- TypeScript 5 - Type safety
- ESM modules
License
MIT © Laststance.io
Related Projects
- Claude Code - AI-powered coding assistant by Anthropic
- Ink - React for interactive command-line apps
- SuperClaude - Claude Code enhancement framework
Changelog
v0.1.0
- Initial release
- Interactive dashboard with 4 tabs (Discover, Installed, Marketplaces, Errors)
- Plugin install/uninstall functionality (
i/ukeys) - Plugin enable/disable functionality (
Spacekey) - Emacs-style navigation (
Ctrl+P/Ctrl+N) - CLI commands for non-interactive use
- Search, sort, and filter support
