# Finding and installing plugins for GitHub Copilot CLI

Extend Copilot's functionality by installing plugins created by the community or by your team.

## Introduction

Plugins are packages that extend the functionality of Copilot CLI. You can install a plugin from a marketplace that you have registered with the CLI.

For more information, see [About GitHub Copilot plugins](/en/copilot/concepts/agents/about-plugins).

> \[!NOTE]
> You can find help on using plugins by entering `copilot plugin [SUBCOMMAND] --help` in the terminal.

## Finding plugins

Plugins are collected together in marketplaces. A marketplace is a registry of plugins that you can browse and install from. You can add a marketplace to your CLI configuration, which allows you to use the CLI to browse and install plugins from that marketplace—see [Adding plugin marketplaces](#adding-plugin-marketplaces). Copilot comes with two marketplaces already registered by default: `copilot-plugins` and `awesome-copilot`.

To use the CLI to browse the plugins in one of your registered marketplaces:

1. **Check which marketplaces are currently registered.**

   In the terminal, list the available marketplaces by entering:

   ```shell copy
   copilot plugin marketplace list
   ```

   Alternatively, in an interactive session, enter:

   ```copilot copy
   /plugin marketplace list
   ```

2. **Browse the plugins in a registered marketplace.**

   From the list of registered marketplaces, copy the name of the marketplace you want to browse—for example, `awesome-copilot`—then enter the following command, replacing `MARKETPLACE-NAME`:

   ```shell copy
   copilot plugin marketplace browse MARKETPLACE-NAME

   ```

## Installing plugins

You can install plugins from a registered marketplace. For information on how to register additional marketplaces, see [Adding plugin marketplaces](#adding-plugin-marketplaces).

To install a plugin, enter:

```shell copy
copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME
```

For example, to install the `database-data-management` plugin from the `awesome-copilot` marketplace enter:

```shell copy
copilot plugin install database-data-management@awesome-copilot
```

Alternatively, in an interactive session, enter:

```copilot copy
/plugin install PLUGIN-NAME@MARKETPLACE-NAME
```

## Managing installed plugins

```bash
copilot plugin list                    # View installed plugins
copilot plugin update PLUGIN-NAME      # Update plugin to latest version
copilot plugin uninstall PLUGIN-NAME   # Remove plugin completely
```

## Adding plugin marketplaces

To add a marketplace to the list of registered marketplaces, enter the following command in the terminal:

```shell copy
copilot plugin marketplace add OWNER/REPO
```

Where OWNER/REPO identifies a repository on GitHub.com that has been configured as a CLI plugin marketplace.

For example to add the `claude-code-plugins` marketplace, hosted at <https://github.com/anthropics/claude-code>, enter:

```shell copy
copilot plugin marketplace add anthropics/claude-code
```

Alternatively, in an interactive session, enter:

```copilot copy
/plugin marketplace add OWNER/REPO
```

If a marketplace is located on the local file system, instead of on GitHub.com, use the path to the marketplace directory instead of OWNER/REPO. For example:

```shell copy
copilot plugin marketplace add /PATH/TO/MARKETPLACE-DIRECTORY
```

If a marketplace is located in a Git repository that is not hosted on GitHub.com, use the URL of the Git repository. For example:

```shell copy
copilot plugin marketplace add https://gitlab.com/OWNER/REPO.git
```

## Removing plugin marketplaces

To remove a marketplace from the CLI enter:

```shell copy
copilot plugin marketplace remove MARKETPLACE-NAME
```

Or, in an interactive session:

```copilot copy
/plugin marketplace remove MARKETPLACE-NAME
```

> \[!NOTE]
>
> * When adding a marketplace you reference the marketplace using the OWNER/REPO of the GitHub repository that has been configured as a marketplace. When removing a marketplace, however, you reference the name of the marketplace as it appears in your list of registered marketplaces.
> * If you attempt to remove a marketplace that has plugins installed, the command will fail with an error message that lists the plugins that are currently installed from that marketplace. Add the `--force` option to the command to remove the marketplace and uninstall all plugins that were installed from that marketplace.

## Further reading

* [Creating a plugin for GitHub Copilot CLI](/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating)
* [Creating a plugin marketplace for GitHub Copilot CLI](/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace)