Claude Code Plugin Sync

Sync Claude Code plugins from Supabase to your local .claude/ directories.

Installation

npm install -g @claude-code/plugin-sync

Or run directly with npx:

npx @claude-code/plugin-sync

Setup

Create a .env file in your project root:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key-here

Or if you're using Next.js (the tool supports both formats):

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here

You can also set environment variables:

export SUPABASE_URL=https://your-project.supabase.co
export SUPABASE_ANON_KEY=your-anon-key-here

Tip: If you're using the Plugin Manager UI, you can copy the .env.local file directly from the plugin-manager-ui directory!

Usage

Run from any project directory where you want to sync plugins:

plugin-sync

This will:

• Fetch all plugins from Supabase
• Write agents to .claude/agents/
• Write commands to .claude/commands/
• Write skills to .claude/skills/
• Update MCP servers in ~/.config/claude/claude_desktop_config.json
• Update hooks in .claude/settings.json

What Gets Synced

Agents

Created as .claude/agents/{name}.md files with:

• Agent description
• Agent prompt
• Configuration

Commands

Created as .claude/commands/{name}.md files with:

• Command description (as frontmatter)
• Command prompt

Skills

Created as .claude/skills/{name}.md files with:

• Skill description (as frontmatter)
• Skill prompt

MCP Servers

Added to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@server/package"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}

Hooks

Added to .claude/settings.json:

{
  "hooks": {
    "user_prompt_submit": [
      {
        "name": "hook-name",
        "command": "echo 'Hook command'"
      }
    ]
  }
}

Development

Clone the repository and install dependencies:

npm install

Test locally:

node index.js

License

ISC