plugin

Plugin

Manage Claude Code plugins from GitHub marketplaces. Install, update, remove, and list plugins — filling the gap until CC ships native /plugin commands.

Usage

/brana:plugin add <owner/repo>        — register a GitHub marketplace
/brana:plugin install <name>          — install a plugin from known marketplaces
/brana:plugin list                    — show installed + available plugins
/brana:plugin remove <name>           — uninstall a plugin
/brana:plugin update [name]           — update all or a specific plugin
/brana:plugin sync                    — sync dev plugin cache (--plugin-dir users)

File Locations

File	Purpose
~/.claude/plugins/known_marketplaces.json	Registered marketplace repos
~/.claude/plugins/installed_plugins.json	Installed plugin registry (version 2)
~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/	Cached plugin files
~/.claude/plugins/marketplaces/<marketplace>/	Cloned marketplace repos

Subcommands

add <owner/repo>

Register a GitHub repo as a plugin marketplace.

Steps:

1. Validate format: must be owner/repo (e.g., martineserios/thebrana).

2. Read ~/.claude/plugins/known_marketplaces.json. Create if missing:

   {}
   

3. Check if marketplace already registered. If yes, ask user:

   • question: "Marketplace already registered. Update it?"
   • options: ["Yes — re-clone", "No — skip"]

4. Clone/update the marketplace repo:

   git clone --depth 1 "https://github.com/<owner>/<repo>.git" \
       "$HOME/.claude/plugins/marketplaces/<repo-name>/" 2>/dev/null \
   || (cd "$HOME/.claude/plugins/marketplaces/<repo-name>/" && git pull --ff-only)
   

5. Verify .claude-plugin/marketplace.json exists in the cloned repo. If missing, abort with error.

6. Read the marketplace manifest to confirm it's valid JSON with a plugins array.

7. Add entry to known_marketplaces.json:

   {
     "<repo-name>": {
       "source": {
         "source": "github",
         "repo": "<owner>/<repo>"
       },
       "installLocation": "/home/<user>/.claude/plugins/marketplaces/<repo-name>",
       "lastUpdated": "<ISO timestamp>",
       "autoUpdate": true
     }
   }