# Discovering and Installing Plugins

> Find and install plugins from marketplaces to extend Claude Code with new commands, agents, and capabilities.

Plugins extend Claude Code with skills, agents, hooks, and MCP servers. Plugin marketplaces are catalogs that help you discover and install these extensions.

## How Marketplaces Work

Using a marketplace is a two-step process:

1. **Add the marketplace**: This registers the catalog with Claude Code so you can browse what's available.
2. **Install individual plugins**: Browse the catalog and install the plugins you want.

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.

To install a plugin:
```shell
/plugin install plugin-name@claude-plugins-official
```

### Code Intelligence Plugins

These plugins enable Claude Code's built-in LSP tool, giving Claude the ability to jump to definitions, find references, and see type errors immediately after edits.

| Language   | Plugin              | Binary required              |
| :--------- | :------------------ | :--------------------------- |
| C/C++      | `clangd-lsp`        | `clangd`                     |
| C#         | `csharp-lsp`        | `csharp-ls`                  |
| Go         | `gopls-lsp`         | `gopls`                      |
| Java       | `jdtls-lsp`         | `jdtls`                      |
| Kotlin     | `kotlin-lsp`        | `kotlin-language-server`     |
| 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` |

**What Claude gains from code intelligence plugins:**
- **Automatic diagnostics**: After every file edit, the language server reports errors and warnings back automatically. Claude sees type errors, missing imports, and syntax issues without needing to run a compiler.
- **Code navigation**: Claude can jump to definitions, find references, get type info on hover, list symbols, find implementations, and trace call hierarchies.

### External Integrations

Pre-configured MCP servers to connect Claude to external services:

- **Source control**: `github`, `gitlab`
- **Project management**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
- **Design**: `figma`
- **Infrastructure**: `vercel`, `firebase`, `supabase`
- **Communication**: `slack`
- **Monitoring**: `sentry`

### Development Workflows

- **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

- **explanatory-output-style**: Educational insights about implementation choices
- **learning-output-style**: Interactive learning mode for skill building

## Adding Marketplaces

### From GitHub
```shell
/plugin marketplace add anthropics/claude-code
```

### From Other Git Hosts
```shell
# HTTPS
/plugin marketplace add https://gitlab.com/company/plugins.git

# SSH
/plugin marketplace add git@gitlab.com:company/plugins.git

# Specific branch or tag
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
```

### From Local Paths
```shell
/plugin marketplace add ./my-marketplace
/plugin marketplace add ./path/to/marketplace.json
```

### From Remote URLs
```shell
/plugin marketplace add https://example.com/marketplace.json
```

## Installing Plugins

Install directly (to user scope by default):
```shell
/plugin install plugin-name@marketplace-name
```

Choose installation scope via the interactive UI (`/plugin` -> **Discover** tab):
- **User scope** (default): Install for yourself across all projects
- **Project scope**: Install for all collaborators on this repository
- **Local scope**: Install for yourself in this repository only

Install with scope flag:
```shell
claude plugin install formatter@your-org --scope project
```

## Managing Installed Plugins

Run `/plugin` and go to the **Installed** tab to view, enable, disable, or uninstall.

### CLI Commands

Disable a plugin:
```shell
/plugin disable plugin-name@marketplace-name
```

Re-enable:
```shell
/plugin enable plugin-name@marketplace-name
```

Remove:
```shell
/plugin uninstall plugin-name@marketplace-name
```

## Managing Marketplaces

### Interactive Interface
Run `/plugin` and go to the **Marketplaces** tab.

### CLI Commands
```shell
# List all marketplaces
/plugin marketplace list

# Update plugin listings
/plugin marketplace update marketplace-name

# Remove a marketplace (uninstalls all plugins from it)
/plugin marketplace remove marketplace-name
```

### Configure Auto-Updates

Toggle auto-update for individual marketplaces:
1. Run `/plugin`
2. Select **Marketplaces**
3. Choose a marketplace
4. Select **Enable auto-update** or **Disable auto-update**

To disable all automatic updates:
```shell
export DISABLE_AUTOUPDATER=true
```

To keep plugin auto-updates while disabling Claude Code auto-updates:
```shell
export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true
```

## Configure Team Marketplaces

Team admins can set up automatic marketplace installation by adding configuration to `.claude/settings.json`. When team members trust the repository folder, Claude Code prompts them to install these marketplaces and plugins.

## Troubleshooting

### /plugin Command Not Recognized
1. Check your version: `claude --version` (requires 1.0.33+)
2. Update Claude Code:
   - **Homebrew**: `brew upgrade claude-code`
   - **npm**: `npm update -g @anthropic-ai/claude-code`
   - **Native installer**: Re-run the install command
3. Restart Claude Code

### Common Issues
- **Marketplace not loading**: Verify URL is accessible and `.claude-plugin/marketplace.json` exists
- **Plugin installation failures**: Check that source URLs are accessible and repos are public
- **Files not found**: Plugins are copied to cache; paths outside plugin directory won't work
- **Skills not appearing**: Clear cache with `rm -rf ~/.claude/plugins/cache`, restart, reinstall

### Code Intelligence Issues
- **Language server not starting**: Verify binary is installed and in `$PATH`
- **High memory usage**: Disable the plugin with `/plugin disable <plugin-name>`
- **False positive diagnostics**: May occur in monorepos if workspace isn't configured correctly

## Grid Integration Opportunities

<!-- Placeholder for Grid-specific integration notes -->