diff --git a/docs/my-website/docs/tutorials/claude_code_plugin_marketplace.md b/docs/my-website/docs/tutorials/claude_code_plugin_marketplace.md new file mode 100644 index 00000000000..9b3530c3cb2 --- /dev/null +++ b/docs/my-website/docs/tutorials/claude_code_plugin_marketplace.md @@ -0,0 +1,323 @@ +import Image from '@theme/IdealImage'; +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Claude Code Plugin Marketplace + +Create a centralized plugin marketplace for your organization's Claude Code users. + +## Why Use a Plugin Marketplace? + +When running LiteLLM as your AI Gateway, you can provide a **central plugin marketplace** that enables: + +| Benefit | Description | +|---------|-------------| +| **Centralized Discovery** | Engineers across your company can browse and install approved plugins from a single source | +| **Governance & Control** | Admins control which plugins are available, ensuring security and compliance | +| **Easy Distribution** | Share internal tools, custom integrations, and approved third-party plugins organization-wide | +| **Version Management** | Track plugin versions and updates across your organization | +| **No Manual Setup** | Engineers install plugins with a single command instead of manually configuring each one | + +## How It Works + +``` +┌─────────────────────────────────────────────────────────────────────┐ +│ LiteLLM AI Gateway │ +│ │ +│ ┌─────────────────────────────────────────────────────────────┐ │ +│ │ Plugin Marketplace Registry │ │ +│ │ │ │ +│ │ /claude-code/marketplace.json │ │ +│ │ ├── internal-tools (GitHub: company/internal-tools) │ │ +│ │ ├── jira-integration (GitHub: company/jira-plugin) │ │ +│ │ └── code-review-helper (GitHub: company/review-plugin) │ │ +│ └─────────────────────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────────────────┘ + │ + │ Engineers install with: + │ claude plugin marketplace add + │ claude plugin install @litellm + ▼ +┌─────────────────────────────────────────────────────────────────────┐ +│ Engineer's Claude Code │ +│ │ +│ Installed Plugins: │ +│ ✓ internal-tools@litellm │ +│ ✓ jira-integration@litellm │ +│ ✓ code-review-helper@litellm │ +└─────────────────────────────────────────────────────────────────────┘ +``` + +LiteLLM stores plugin **metadata and git source references** in its database. When engineers install plugins, Claude Code clones directly from the git source (GitHub/GitLab/Bitbucket). + +## Prerequisites + +- LiteLLM Proxy running with database connected +- Admin access to LiteLLM UI +- Plugins hosted on GitHub, GitLab, or any git-accessible URL + +## Admin Guide: Managing the Marketplace + +### Step 1: Navigate to Claude Code Plugins + +In the LiteLLM Admin UI, click on **Claude Code Plugins** in the left navigation menu. + + + +### Step 2: View the Plugins List + +You'll see the list of all registered plugins. From here you can add, enable, disable, or delete plugins. + + + +### Step 3: Add a New Plugin + +Click **+ Add New Plugin** to register a plugin in your marketplace. + + + +### Step 4: Fill in Plugin Details + +Enter the plugin information: + +- **Name**: Plugin identifier (kebab-case, e.g., `my-plugin`) +- **Source Type**: Choose GitHub or URL +- **Repository/URL**: The git source (e.g., `org/repo` for GitHub) +- **Version**: Semantic version (optional) +- **Description**: What the plugin does +- **Category**: Plugin category for organization +- **Keywords**: Search terms + + + +### Step 5: Submit the Plugin + +After filling in the details, click **Add Plugin** to register it. + + + +### Step 6: Enable/Disable Plugins + +Toggle plugins on or off to control what appears in the public marketplace. Only **enabled** plugins are visible to engineers. + + + +## Engineer Guide: Installing Plugins + +### Step 1: Add the LiteLLM Marketplace + +Add your company's LiteLLM marketplace to Claude Code: + +```bash +claude plugin marketplace add http://your-litellm-proxy:4000/claude-code/marketplace.json +``` + + + +### Step 2: Browse Available Plugins + +List all available plugins from the marketplace: + +```bash +claude plugin search @litellm +``` + +### Step 3: Install a Plugin + +Install any plugin from the marketplace: + +```bash +claude plugin install my-plugin@litellm +``` + + + +### Step 4: Verify Installation + +The plugin is now installed and ready to use: + + + +## API Reference + +### Public Endpoint (No Auth Required) + +#### GET `/claude-code/marketplace.json` + +Returns the marketplace catalog for Claude Code discovery. + +```bash +curl http://localhost:4000/claude-code/marketplace.json +``` + +**Response:** +```json +{ + "name": "litellm", + "owner": { + "name": "LiteLLM", + "email": "support@litellm.ai" + }, + "plugins": [ + { + "name": "my-plugin", + "source": { + "source": "github", + "repo": "org/my-plugin" + }, + "version": "1.0.0", + "description": "My awesome plugin", + "category": "productivity", + "keywords": ["automation", "tools"] + } + ] +} +``` + +### Admin Endpoints (Auth Required) + +#### POST `/claude-code/plugins` + +Register a new plugin. + +```bash +curl -X POST http://localhost:4000/claude-code/plugins \ + -H "Authorization: Bearer sk-..." \ + -H "Content-Type: application/json" \ + -d '{ + "name": "my-plugin", + "source": {"source": "github", "repo": "org/my-plugin"}, + "version": "1.0.0", + "description": "My awesome plugin", + "category": "productivity", + "keywords": ["automation", "tools"] + }' +``` + +#### GET `/claude-code/plugins` + +List all registered plugins. + +```bash +curl http://localhost:4000/claude-code/plugins \ + -H "Authorization: Bearer sk-..." +``` + +#### POST `/claude-code/plugins/{name}/enable` + +Enable a plugin. + +```bash +curl -X POST http://localhost:4000/claude-code/plugins/my-plugin/enable \ + -H "Authorization: Bearer sk-..." +``` + +#### POST `/claude-code/plugins/{name}/disable` + +Disable a plugin. + +```bash +curl -X POST http://localhost:4000/claude-code/plugins/my-plugin/disable \ + -H "Authorization: Bearer sk-..." +``` + +#### DELETE `/claude-code/plugins/{name}` + +Delete a plugin. + +```bash +curl -X DELETE http://localhost:4000/claude-code/plugins/my-plugin \ + -H "Authorization: Bearer sk-..." +``` + +## Plugin Source Formats + + + + +```json +{ + "name": "my-plugin", + "source": { + "source": "github", + "repo": "organization/repository" + } +} +``` + + + + +```json +{ + "name": "my-plugin", + "source": { + "source": "url", + "url": "https://github.com/org/repo.git" + } +} +``` + +Use this format for GitLab, Bitbucket, or self-hosted git repositories. + + + + +## Example: Setting Up an Internal Plugin Marketplace + +### 1. Create Internal Plugins + +Structure your plugin repository: + +``` +my-company-plugin/ +├── plugin.json # Plugin manifest +├── SKILL.md # Main skill file +├── skills/ # Additional skills +│ └── helper.md +└── README.md +``` + +### 2. Register Plugins via API + +```bash +# Register your internal tools plugin +curl -X POST http://localhost:4000/claude-code/plugins \ + -H "Authorization: Bearer $LITELLM_MASTER_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "name": "internal-tools", + "source": {"source": "github", "repo": "mycompany/internal-tools"}, + "version": "1.0.0", + "description": "Internal development tools and utilities", + "author": {"name": "Platform Team", "email": "platform@mycompany.com"}, + "category": "internal", + "keywords": ["internal", "tools", "utilities"] + }' +``` + +### 3. Share with Your Team + +Send engineers the marketplace URL: + +```bash +# One-time setup for each engineer +claude plugin marketplace add http://litellm.internal.company.com/claude-code/marketplace.json + +# Install company plugins +claude plugin install internal-tools@litellm +``` + +## Troubleshooting + +**Plugin not appearing in marketplace:** +- Verify the plugin is **enabled** in the admin UI +- Check that the plugin has a valid `source` field + +**Installation fails:** +- Ensure the git repository is accessible from the engineer's machine +- For private repos, engineers need appropriate git credentials configured + +**Database errors:** +- Verify LiteLLM proxy is connected to the database +- Check proxy logs for detailed error messages diff --git a/docs/my-website/img/claude_code_marketplace/step10_plugin_added.jpeg b/docs/my-website/img/claude_code_marketplace/step10_plugin_added.jpeg new file mode 100644 index 00000000000..6b3daf1cb73 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step10_plugin_added.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step11_enable_plugin.jpeg b/docs/my-website/img/claude_code_marketplace/step11_enable_plugin.jpeg new file mode 100644 index 00000000000..8781fba8e66 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step11_enable_plugin.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step12_cli_marketplace.jpeg b/docs/my-website/img/claude_code_marketplace/step12_cli_marketplace.jpeg new file mode 100644 index 00000000000..091ef66e824 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step12_cli_marketplace.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step13_cli_add.jpeg b/docs/my-website/img/claude_code_marketplace/step13_cli_add.jpeg new file mode 100644 index 00000000000..fbd42e0cc27 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step13_cli_add.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step14_cli_enter.jpeg b/docs/my-website/img/claude_code_marketplace/step14_cli_enter.jpeg new file mode 100644 index 00000000000..e8d5ff2da86 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step14_cli_enter.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step15_cli_paste.jpeg b/docs/my-website/img/claude_code_marketplace/step15_cli_paste.jpeg new file mode 100644 index 00000000000..4a947ce7cc3 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step15_cli_paste.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step16_cli_complete.jpeg b/docs/my-website/img/claude_code_marketplace/step16_cli_complete.jpeg new file mode 100644 index 00000000000..ba96f03ee1b Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step16_cli_complete.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step1_navigate_plugins.jpeg b/docs/my-website/img/claude_code_marketplace/step1_navigate_plugins.jpeg new file mode 100644 index 00000000000..25c95e70f49 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step1_navigate_plugins.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step2_click_plugins.jpeg b/docs/my-website/img/claude_code_marketplace/step2_click_plugins.jpeg new file mode 100644 index 00000000000..a83ee10f34a Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step2_click_plugins.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step3_plugins_list.jpeg b/docs/my-website/img/claude_code_marketplace/step3_plugins_list.jpeg new file mode 100644 index 00000000000..26127a59a75 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step3_plugins_list.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step4_add_plugin.jpeg b/docs/my-website/img/claude_code_marketplace/step4_add_plugin.jpeg new file mode 100644 index 00000000000..e20f9edf69d Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step4_add_plugin.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step5_plugin_form.jpeg b/docs/my-website/img/claude_code_marketplace/step5_plugin_form.jpeg new file mode 100644 index 00000000000..eb60df653d3 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step5_plugin_form.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step6_fill_form.jpeg b/docs/my-website/img/claude_code_marketplace/step6_fill_form.jpeg new file mode 100644 index 00000000000..9401808d5f5 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step6_fill_form.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step7_form_details.jpeg b/docs/my-website/img/claude_code_marketplace/step7_form_details.jpeg new file mode 100644 index 00000000000..41cd46c938f Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step7_form_details.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step8_paste_repo.jpeg b/docs/my-website/img/claude_code_marketplace/step8_paste_repo.jpeg new file mode 100644 index 00000000000..b0fbb546100 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step8_paste_repo.jpeg differ diff --git a/docs/my-website/img/claude_code_marketplace/step9_submit.jpeg b/docs/my-website/img/claude_code_marketplace/step9_submit.jpeg new file mode 100644 index 00000000000..d2a73421eb9 Binary files /dev/null and b/docs/my-website/img/claude_code_marketplace/step9_submit.jpeg differ diff --git a/docs/my-website/sidebars.js b/docs/my-website/sidebars.js index 102e3dfe1c5..9f31cdcb367 100644 --- a/docs/my-website/sidebars.js +++ b/docs/my-website/sidebars.js @@ -125,6 +125,7 @@ const sidebars = { "tutorials/claude_code_websearch", "tutorials/claude_mcp", "tutorials/claude_non_anthropic_models", + "tutorials/claude_code_plugin_marketplace", ] }, "tutorials/cost_tracking_coding",