opkg 0.6.1 → 0.7.0

package/specs/claude-plugins-marketplace.md

@@ -0,0 +1,363 @@
+# Discover and install prebuilt plugins through marketplaces
+
+> Find and install plugins from marketplaces to extend Claude Code with new commands, agents, and capabilities.
+
+Plugins extend Claude Code with custom commands, agents, hooks, and MCP servers. Plugin marketplaces are catalogs that help you discover and install these extensions without building them yourself.
+
+Looking to create and distribute your own marketplace? See [Create and distribute a plugin marketplace](/en/plugin-marketplaces).
+
+## How marketplaces work
+
+A marketplace is a catalog of plugins that someone else has created and shared. Using a marketplace is a two-step process:
+
+<Steps>
+  <Step title="Add the marketplace">
+    This registers the catalog with Claude Code so you can browse what's available. No plugins are installed yet.
+  </Step>
+
+  <Step title="Install individual plugins">
+    Browse the catalog and install the plugins you want.
+  </Step>
+</Steps>
+
+Think of it like adding an app store: adding the store gives you access to browse its collection, but you still choose which apps to download individually.
+
+## Official Anthropic marketplace
+
+The official Anthropic marketplace (`claude-plugins-official`) is automatically available when you start Claude Code. Run `/plugin` and go to the **Discover** tab to browse what's available.
+
+To install a plugin from the official marketplace:
+
+```shell  theme={null}
+/plugin install plugin-name@claude-plugins-official
+```
+
+<Note>
+  The official marketplace is maintained by Anthropic. To distribute your own plugins, [create your own marketplace](/en/plugin-marketplaces) and share it with users.
+</Note>
+
+The official marketplace includes several categories of plugins:
+
+### Code intelligence
+
+Code intelligence plugins help Claude understand your codebase more deeply. With these plugins installed, Claude can jump to definitions, find references, and see type errors immediately after edits. These plugins use the [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) (LSP), the same technology that powers VS Code's code intelligence.
+
+These plugins require the language server binary to be installed on your system. If you already have a language server installed, Claude may prompt you to install the corresponding plugin when you open a project.
+
+| Language   | Plugin              | Binary required              |
+| :--------- | :------------------ | :--------------------------- |
+| C/C++      | `clangd-lsp`        | `clangd`                     |
+| C#         | `csharp-lsp`        | `csharp-ls`                  |
+| Go         | `gopls-lsp`         | `gopls`                      |
+| Java       | `jdtls-lsp`         | `jdtls`                      |
+| Lua        | `lua-lsp`           | `lua-language-server`        |
+| PHP        | `php-lsp`           | `intelephense`               |
+| Python     | `pyright-lsp`       | `pyright-langserver`         |
+| Rust       | `rust-analyzer-lsp` | `rust-analyzer`              |
+| Swift      | `swift-lsp`         | `sourcekit-lsp`              |
+| TypeScript | `typescript-lsp`    | `typescript-language-server` |
+
+You can also [create your own LSP plugin](/en/plugins-reference#lsp-servers) for other languages.
+
+<Note>
+  If you see `Executable not found in $PATH` in the `/plugin` Errors tab after installing a plugin, install the required binary from the table above.
+</Note>
+
+### External integrations
+
+These plugins bundle pre-configured [MCP servers](/en/mcp) so you can connect Claude to external services without manual setup:
+
+* **Source control**: `github`, `gitlab`
+* **Project management**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
+* **Design**: `figma`
+* **Infrastructure**: `vercel`, `firebase`, `supabase`
+* **Communication**: `slack`
+* **Monitoring**: `sentry`
+
+### Development workflows
+
+Plugins that add commands and agents for common development tasks:
+
+* **commit-commands**: Git commit workflows including commit, push, and PR creation
+* **pr-review-toolkit**: Specialized agents for reviewing pull requests
+* **agent-sdk-dev**: Tools for building with the Claude Agent SDK
+* **plugin-dev**: Toolkit for creating your own plugins
+
+### Output styles
+
+Customize how Claude responds:
+
+* **explanatory-output-style**: Educational insights about implementation choices
+* **learning-output-style**: Interactive learning mode for skill building
+
+## Try it: add the demo marketplace
+
+Anthropic also maintains a [demo plugins marketplace](https://github.com/anthropics/claude-code/tree/main/plugins) (`claude-code-plugins`) with example plugins that show what's possible with the plugin system. Unlike the official marketplace, you need to add this one manually.
+
+<Steps>
+  <Step title="Add the marketplace">
+    From within Claude Code, run the `plugin marketplace add` command for the `anthropics/claude-code` marketplace:
+
+    ```shell  theme={null}
+    /plugin marketplace add anthropics/claude-code
+    ```
+
+    This downloads the marketplace catalog and makes its plugins available to you.
+  </Step>
+
+  <Step title="Browse available plugins">
+    Run `/plugin` to open the plugin manager. This opens a tabbed interface with four tabs you can cycle through using **Tab** (or **Shift+Tab** to go backward):
+
+    * **Discover**: browse available plugins from all your marketplaces
+    * **Installed**: view and manage your installed plugins
+    * **Marketplaces**: add, remove, or update your added marketplaces
+    * **Errors**: view any plugin loading errors
+
+    Go to the **Discover** tab to see plugins from the marketplace you just added.
+  </Step>
+
+  <Step title="Install a plugin">
+    Select a plugin to view its details, then choose an installation scope:
+
+    * **User scope**: install for yourself across all projects
+    * **Project scope**: install for all collaborators on this repository
+    * **Local scope**: install for yourself in this repository only
+
+    For example, select **commit-commands** (a plugin that adds git workflow commands) and install it to your user scope.
+
+    You can also install directly from the command line:
+
+    ```shell  theme={null}
+    /plugin install commit-commands@anthropics-claude-code
+    ```
+
+    See [Configuration scopes](/en/settings#configuration-scopes) to learn more about scopes.
+  </Step>
+
+  <Step title="Use your new plugin">
+    After installing, the plugin's commands are immediately available. Plugin commands are namespaced by the plugin name, so **commit-commands** provides commands like `/commit-commands:commit`.
+
+    Try it out by making a change to a file and running:
+
+    ```shell  theme={null}
+    /commit-commands:commit
+    ```
+
+    This stages your changes, generates a commit message, and creates the commit.
+
+    Each plugin works differently. Check the plugin's description in the **Discover** tab or its homepage to learn what commands and capabilities it provides.
+  </Step>
+</Steps>
+
+The rest of this guide covers all the ways you can add marketplaces, install plugins, and manage your configuration.
+
+## Add marketplaces
+
+Use the `/plugin marketplace add` command to add marketplaces from different sources.
+
+<Tip>
+  **Shortcuts**: You can use `/plugin market` instead of `/plugin marketplace`, and `rm` instead of `remove`.
+</Tip>
+
+* **GitHub repositories**: `owner/repo` format (for example, `anthropics/claude-code`)
+* **Git URLs**: any git repository URL (GitLab, Bitbucket, self-hosted)
+* **Local paths**: directories or direct paths to `marketplace.json` files
+* **Remote URLs**: direct URLs to hosted `marketplace.json` files
+
+### Add from GitHub
+
+Add a GitHub repository that contains a `.claude-plugin/marketplace.json` file using the `owner/repo` format—where `owner` is the GitHub username or organization and `repo` is the repository name.
+
+For example, `anthropics/claude-code` refers to the `claude-code` repository owned by `anthropics`:
+
+```shell  theme={null}
+/plugin marketplace add anthropics/claude-code
+```
+
+### Add from other Git hosts
+
+Add any git repository by providing the full URL. This works with any Git host, including GitLab, Bitbucket, and self-hosted servers:
+
+Using HTTPS:
+
+```shell  theme={null}
+/plugin marketplace add https://gitlab.com/company/plugins.git
+```
+
+Using SSH:
+
+```shell  theme={null}
+/plugin marketplace add git@gitlab.com:company/plugins.git
+```
+
+To add a specific branch or tag, append `#` followed by the ref:
+
+```shell  theme={null}
+/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
+```
+
+### Add from local paths
+
+Add a local directory that contains a `.claude-plugin/marketplace.json` file:
+
+```shell  theme={null}
+/plugin marketplace add ./my-marketplace
+```
+
+You can also add a direct path to a `marketplace.json` file:
+
+```shell  theme={null}
+/plugin marketplace add ./path/to/marketplace.json
+```
+
+Or add a remote `marketplace.json` file via URL:
+
+```shell  theme={null}
+/plugin marketplace add https://example.com/marketplace.json
+```
+
+## Install plugins
+
+Once you've added marketplaces, you can install plugins directly (installs to user scope by default):
+
+```shell  theme={null}
+/plugin install plugin-name@marketplace-name
+```
+
+To choose a different [installation scope](/en/settings#configuration-scopes), use the interactive UI: run `/plugin`, go to the **Discover** tab, and press **Enter** on a plugin. You'll see options for:
+
+* **User scope** (default): install for yourself across all projects
+* **Project scope**: install for all collaborators on this repository (adds to `.claude/settings.json`)
+* **Local scope**: install for yourself in this repository only (not shared with collaborators)
+
+You may also see plugins with **managed** scope—these are installed by enterprise administrators via [managed settings](/en/settings#enterprise-managed-policy-settings) and cannot be modified.
+
+Run `/plugin` and go to the **Installed** tab to see your plugins grouped by scope.
+
+<Warning>
+  Make sure you trust a plugin before installing it. Anthropic does not control what MCP servers, files, or other software are included in plugins and cannot verify that they work as intended. Check each plugin's homepage for more information.
+</Warning>
+
+## Manage installed plugins
+
+Run `/plugin` and go to the **Installed** tab to view, enable, disable, or uninstall your plugins.
+
+You can also manage plugins with direct commands.
+
+Disable a plugin without uninstalling:
+
+```shell  theme={null}
+/plugin disable plugin-name@marketplace-name
+```
+
+Re-enable a disabled plugin:
+
+```shell  theme={null}
+/plugin enable plugin-name@marketplace-name
+```
+
+Completely remove a plugin:
+
+```shell  theme={null}
+/plugin uninstall plugin-name@marketplace-name
+```
+
+The `--scope` option lets you target a specific scope with CLI commands:
+
+```shell  theme={null}
+claude plugin install formatter@your-org --scope project
+claude plugin uninstall formatter@your-org --scope project
+```
+
+## Manage marketplaces
+
+You can manage marketplaces through the interactive `/plugin` interface or with CLI commands.
+
+### Use the interactive interface
+
+Run `/plugin` and go to the **Marketplaces** tab to:
+
+* View all your added marketplaces with their sources and status
+* Add new marketplaces
+* Update marketplace listings to fetch the latest plugins
+* Remove marketplaces you no longer need
+
+### Use CLI commands
+
+You can also manage marketplaces with direct commands.
+
+List all configured marketplaces:
+
+```shell  theme={null}
+/plugin marketplace list
+```
+
+Refresh plugin listings from a marketplace:
+
+```shell  theme={null}
+/plugin marketplace update marketplace-name
+```
+
+Remove a marketplace:
+
+```shell  theme={null}
+/plugin marketplace remove marketplace-name
+```
+
+<Warning>
+  Removing a marketplace will uninstall any plugins you installed from it.
+</Warning>
+
+### Configure auto-updates
+
+Claude Code can automatically update marketplaces and their installed plugins at startup. When auto-update is enabled for a marketplace, Claude Code refreshes the marketplace data and updates installed plugins to their latest versions. If any plugins were updated, you'll see a notification suggesting you restart Claude Code.
+
+Toggle auto-update for individual marketplaces through the UI:
+
+1. Run `/plugin` to open the plugin manager
+2. Select **Marketplaces**
+3. Choose a marketplace from the list
+4. Select **Enable auto-update** or **Disable auto-update**
+
+Official Anthropic marketplaces have auto-update enabled by default. Third-party and local development marketplaces have auto-update disabled by default.
+
+To disable all automatic updates entirely for both Claude Code and all plugins, set the `DISABLE_AUTOUPDATER` environment variable. See [Auto updates](/en/setup#auto-updates) for details.
+
+## Configure team marketplaces
+
+Team admins can set up automatic marketplace installation for projects by adding marketplace configuration to `.claude/settings.json`. When team members trust the repository folder, Claude Code prompts them to install these marketplaces and plugins.
+
+For full configuration options including `extraKnownMarketplaces` and `enabledPlugins`, see [Plugin settings](/en/settings#plugin-settings).
+
+## Troubleshooting
+
+### /plugin command not recognized
+
+If you see "unknown command" or the `/plugin` command doesn't appear:
+
+1. **Check your version**: Run `claude --version`. Plugins require version 1.0.33 or later.
+2. **Update Claude Code**:
+   * **Homebrew**: `brew upgrade claude-code`
+   * **npm**: `npm update -g @anthropic-ai/claude-code`
+   * **Native installer**: Re-run the install command from [Setup](/en/setup)
+3. **Restart Claude Code**: After updating, restart your terminal and run `claude` again.
+
+### Common issues
+
+* **Marketplace not loading**: Verify the URL is accessible and that `.claude-plugin/marketplace.json` exists at the path
+* **Plugin installation failures**: Check that plugin source URLs are accessible and repositories are public (or you have access)
+* **Files not found after installation**: Plugins are copied to a cache, so paths referencing files outside the plugin directory won't work
+* **Plugin Skills not appearing**: Clear the cache with `rm -rf ~/.claude/plugins/cache`, restart Claude Code, and reinstall the plugin. See [Plugin Skills not appearing](/en/skills#plugin-skills-not-appearing-after-installation) for details.
+
+For detailed troubleshooting with solutions, see [Troubleshooting](/en/plugin-marketplaces#troubleshooting) in the marketplace guide. For debugging tools, see [Debugging and development tools](/en/plugins-reference#debugging-and-development-tools).
+
+## Next steps
+
+* **Build your own plugins**: See [Plugins](/en/plugins) to create custom commands, agents, and hooks
+* **Create a marketplace**: See [Create a plugin marketplace](/en/plugin-marketplaces) to distribute plugins to your team or community
+* **Technical reference**: See [Plugins reference](/en/plugins-reference) for complete specifications
+
+
+---
+
+> To find navigation and other pages in this documentation, fetch the llms.txt file at: https://code.claude.com/docs/llms.txt