claude--ralph-wiggum

Agent Plugin Marketplace

Cross-platform agent plugin sync pipeline. Pulls plugins from Codex, Claude Code, and Cursor upstream repos, converts them to VS Code / GitHub Copilot compatible format, and publishes a Git-hosted marketplace manifest.

Quick Start

bun install
bun run sync        # clone upstreams → convert → generate marketplace.json

Outputs:

Path	Purpose
plugins/	Generated VS Code plugin directories
marketplace.json	Marketplace manifest listing all plugins
data/sync-state.json	Incremental sync bookkeeping
.cache/sync/	Local upstream repo clones (gitignored)

---

Using Plugins in GitHub Copilot

Option A: Copilot CLI Marketplace (Recommended)

This repository publishes standard marketplace.json, .github/plugin/marketplace.json, and .claude-plugin/marketplace.json copies so both GitHub-style consumers and marketplace loaders can resolve the same catalog.

# Add this marketplace to Copilot CLI
copilot plugin marketplace add <owner>/agent-plugin-marketplace

# Or add from a local clone
copilot plugin marketplace add /path/to/agent-plugin-marketplace

# Browse available plugins in this marketplace
copilot plugin marketplace browse agent-plugin-marketplace

# Install a specific plugin from this marketplace
copilot plugin install <plugin-name>@agent-plugin-marketplace

# List installed plugins
copilot plugin list

# Update an installed plugin
copilot plugin update <name>

# Uninstall a plugin
copilot plugin uninstall <name>

Option B: Self-Hosted — Fork and Customize

Fork this repository, then run the sync pipeline yourself to maintain your own marketplace with customizations.

# 1. Fork and clone
git clone https://github.com/<you>/agent-plugin-marketplace.git
cd agent-plugin-marketplace

# 2. Install and sync
bun install
bun run sync

# 3. Review generated plugins, customize as needed
# 4. Push — your fork is now a live marketplace
git add -A && git commit -m "chore: sync upstream plugins" && git push

To override upstream repo URLs (e.g. private forks):

CODEX_REPO_URL=https://github.com/your-org/codex-plugins.git \
CLAUDE_CODE_REPO_URL=https://github.com/your-org/claude-plugins.git \
CURSOR_REPO_URL=https://github.com/your-org/cursor-plugins.git \
bun run sync

Option C: Manual Plugin Install

Copy any plugin directory straight into your project:

# Copy a single plugin into your workspace
cp -r plugins/claude--code-review/ .github/copilot/plugins/code-review/

# Or symlink for easy updates
ln -s "$(pwd)/plugins/claude--code-review" .github/copilot/plugins/code-review

Skills (.md files), agents, and instructions are immediately available to Copilot after reload.

Option D: VS Code Marketplace Source (Git URL)

Add this repository as a VS Code Agent Plugins marketplace source via chat.plugins.marketplaces:

{
    "chat.plugins.marketplaces": [
        "https://github.com/ilderaj/agent-plugin-marketplace.git"
    ]
}

This repository already includes the same value in workspace defaults at .vscode/settings.json.

---

How the Sync Pipeline Works

flowchart TD
    codex[Codex repo] --> codexAdapter[CodexAdapter]
    claude[Claude Code repo] --> claudeAdapter[ClaudeAdapter]
    cursor[Cursor repo] --> cursorAdapter[CursorAdapter]

    codexAdapter --> ir[Plugin IR<br/>unified intermediate representation]
    claudeAdapter --> ir
    cursorAdapter --> ir

    ir --> vscodeGen[VsCodePluginGenerator]
    ir --> marketplaceGen[MarketplaceGenerator]

    vscodeGen --> plugins[plugins/<name>/]
    marketplaceGen --> marketplace[marketplace.json]

    plugins --> state[SyncStateManager]
    marketplace --> state
    state --> syncState[data/sync-state.json]

Sync Steps

1. Clone / pull each upstream repo into .cache/sync/<platform>/
2. Discover plugins via platform-specific marker directories (.codex-plugin/, .claude-plugin/, .cursor-plugin/)
3. Check per-plugin commit SHA against sync-state.json — skip if unchanged
4. Parse each plugin into a unified PluginIR via its platform adapter
5. Generate VS Code plugin directory with converted files under plugins/
6. Build marketplace.json, .github/plugin/marketplace.json, and .claude-plugin/marketplace.json from all plugins/*/plugin.json + _meta.json pairs
7. Persist sync state for next incremental run

Incremental Sync

The pipeline tracks each plugin's latest commit SHA. On re-run, only plugins whose source files actually changed are re-generated. This keeps sync fast and diff-friendly for PR reviews.

---

Upstream Adapter Conversion