plum

README

🍑 Plum

A better way to discover Claude Code marketplace plugins.

Plum is a fast, fuzzy-search TUI that lets you discover and install plugins from 12 popular marketplaces - even ones you haven't installed yet. Browse 680+ plugins instantly, no setup required.

Popular Marketplaces

Plum works with any Claude Code marketplace. Here are some popular ones to get started:

Marketplace	Description
claude-code-plugins-plus	The largest collection with 282 plugins and 185 Agent Skills, focusing on production-ready automation tools across DevOps, security, testing, and AI/ML workflows.
claude-code-marketplace	Community-driven marketplace with 119 plugins featuring curated commands and agents with granular installation and auto-sync from a live database. Browse by category and install only what you need.
claude-code-plugins	Official Anthropic plugins with 13 plugins that extend Claude Code's core functionality. These plugins are maintained by the Claude Code team and ship with the tool.
mag-claude-plugins	Battle-tested workflows from top developers with 8 specialized plugins for frontend development, code analysis, Bun backend, and orchestration patterns.
dev-gom-plugins	Automation-focused collection with 14 plugins specializing in Unity game development, Blender 3D workflows, browser automation, and code quality monitoring.
feedmob-claude-plugins	Productivity and workflow tools with 7 specialized plugins for data processing (CSV parsing), testing, commit automation, presentation generation, and AI news aggregation.
claude-plugins-official	Official Anthropic marketplace with 48 plugins for Claude Code. High-quality, production-ready plugins maintained by the Anthropic team.
anthropic-agent-skills	Official Anthropic Agent Skills reference repository with 2 skills for document manipulation (PDF, DOCX, PPTX, XLSX) and production-quality skill implementation examples.
wshobson-agents	Comprehensive production system with 71 plugins, 91 specialized AI agents, 47 agent skills, and 15 multi-agent workflow orchestrators across 23 categories.
docker-plugins	Official Docker Inc. marketplace with 1 plugin for Docker Desktop MCP Toolkit integration for containerized MCP servers. Requires Docker Desktop 4.28+.
ccplugins-marketplace	Curated collection with 118 plugins organized across 13 categories including DevOps, Testing, Documentation, Marketing, Security, and more.
claude-mem	Persistent memory compression system for Claude Code with context preservation across sessions. Enables Claude to maintain project knowledge continuity through automatic tool observation capture and semantic summaries.

Have a marketplace? Submit a PR to add it to this list! We welcome all Claude Code plugin marketplaces.

Installation

macOS/Linux (Recommended)

brew install itsdevcoffee/plum/plum
plum

Windows or Manual Install

Download pre-built binaries from Releases

Available for:

• Windows (x64, ARM64)
• Linux (x64, ARM64)
• macOS (Intel, Apple Silicon)

Extract and run:

# Linux/macOS
tar -xzf plum_*.tar.gz
./plum

# Windows
# Extract ZIP and run plum.exe

Go Developers (All Platforms)

go install github.com/itsdevcoffee/plum/cmd/plum@latest
plum

Requirements: Go 1.24+

Troubleshooting: If plum command isn't found after go install, add $GOPATH/bin to your PATH:

export PATH="$PATH:$HOME/go/bin"  # Add to ~/.zshrc or ~/.bashrc

Key Features

• Discover 680+ plugins from 12 popular marketplaces - even ones you haven't installed yet
• Marketplace browser - View all marketplaces with GitHub stats (stars, forks, last updated)
• Auto-updating registry - notifies when new marketplaces are available
• Instant fuzzy search across all plugins (installed + discoverable)
• Smart filtering: All, Discover, Ready, or Installed
• Filter by marketplace - Use @marketplace-name syntax or press 'f' in marketplace details
• Multiple view modes: Card (detailed) or Slim (compact)
• One-click install - copy commands with c and y keys
• Manual refresh with Shift+U to fetch latest marketplaces
• Responsive design that adapts to your terminal size

Settings Safety

Plum preserves all fields in your settings.json files. Your custom configuration is safe:

• ✅ permissions.allow arrays (bash command permissions)
• ✅ hooks (SessionStart, UserPromptSubmit, PreToolUse, etc.)
• ✅ attribution (commit/PR attribution settings)
• ✅ model preferences
• ✅ includeCoAuthoredBy flags
• ✅ Any other custom fields

Automatic Backups

Before modifying settings for the first time, plum creates a backup:

~/.claude/settings.json.backup-plum   # User scope backup
.claude/settings.json.backup-plum     # Project scope backup

To restore from backup:

cp ~/.claude/settings.json.backup-plum ~/.claude/settings.json

What Plum Manages

Plum only modifies these two fields:

• enabledPlugins - Plugin enable/disable states
• extraKnownMarketplaces - Custom marketplace sources

Everything else in your settings.json remains untouched.

Keyboard Shortcuts

Key	Action
Type anything	Search plugins
↑↓ or Ctrl+j/k	Navigate
Enter	View details
Tab or →	Next filter (All/Discover/Ready/Installed)
Shift+Tab or ←	Previous filter
Shift+V	Toggle card/slim view
Shift+U	Refresh marketplace registry and cache
c	Copy install command (marketplace for discoverable)
y	Copy plugin command (for discoverable plugins)
Shift+M	Open marketplace browser
g	Open plugin on GitHub (in detail view)
o	Open local directory (installed plugins only)
p	Copy local path to clipboard (installed plugins only)
l	Copy GitHub link to clipboard (in detail view)
f	Filter plugins by marketplace (in marketplace detail)
?	Show help
Esc or q	Quit / Cancel refresh

Screenshots

Discover New Marketplaces

Browse plugins from 10 popular marketplaces - even ones you haven't installed yet. The Discover filter shows plugins from uninstalled marketplaces with [Discover] badges:

Two-Step Installation for New Marketplaces

When you find a plugin from an uninstalled marketplace, plum shows you exactly what to install. Press 'c' to copy the marketplace command, 'y' to copy the plugin command:

Example:

# Step 1: Install the marketplace
/plugin marketplace add feed-mob/claude-code-marketplace

# Step 2: Install the plugin
/plugin install csv-parser@feedmob-claude-plugins

Multiple View Modes

Switch between card and slim views with Ctrl+v:

Card View (Default)

Slim View (Compact)

Built-in Help

Press ? to see all keyboard shortcuts:

Building from Source

Requirements: Go 1.24+

git clone https://github.com/itsdevcoffee/plum.git
cd plum
go build -o plum ./cmd/plum
./plum

Development

Prerequisites:

• Go 1.24+ (download)
• golangci-lint (optional, for local linting)

Run tests:

go test ./...                    # Run all tests
go test -cover ./...             # With coverage
go test -v ./internal/ui         # Specific package

Format code:

gofmt -w .

Run linter (requires Go 1.24):

go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
golangci-lint run

Note: Ensure your golangci-lint is built with Go 1.24+ to match the project's Go version. If you see version mismatch errors, reinstall with: go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

Troubleshooting

"command not found: plum" after installing

The installation worked, but plum isn't in your PATH. Add Go's bin directory:

# Add to your shell config (~/.zshrc, ~/.bashrc, or ~/.bash_profile)
export PATH="$PATH:$HOME/go/bin"

# Reload shell
source ~/.zshrc  # or ~/.bashrc

# Now run plum
plum

Or run directly: ~/go/bin/plum

"Claude Code settings not found"

• Run claude-code at least once to initialize your configuration

"No plugins found"

• Make sure you have marketplaces configured
• Run /plugin in Claude Code to browse and add marketplaces
• Run /plugin marketplace update to sync

Custom config directory

• Set CLAUDE_CONFIG_DIR environment variable if you use a non-standard location

Contributing

Contributions are welcome! Whether it's:

• Adding your marketplace to the Popular Marketplaces list
• Reporting bugs or suggesting features
• Improving documentation
• Submitting code improvements

Feel free to open an issue or pull request.

🔐 Security

Plum treats marketplace and plugin metadata as untrusted input and does not execute plugins or forward plugin content to AI agents.

For details on our threat model, trust boundaries, and how to report vulnerabilities, see SECURITY.md.

License

MIT - see LICENSE for details.

---

Built with Bubble Tea • Styled with Lip Gloss