# Localizando e instalando plug-ins para GitHub Copilot CLI

Estenda Copilota funcionalidade instalando plug-ins criados pela comunidade ou pela sua equipe.

## Introdução

Plug-ins são pacotes que estendem a funcionalidade de Copilot CLI. Você pode instalar um plug-in de um marketplace registrado na CLI.

Para saber mais, confira [Sobre plug-ins GitHub Copilot](/pt/copilot/concepts/agents/about-plugins).

> \[!NOTE]
> Você pode encontrar ajuda para usar plug-ins entrando `copilot plugin [SUBCOMMAND] --help` no terminal.

## Localizando plug-ins

Esses plug-ins são organizados em marketplaces. Um marketplace é um registro de plug-ins dos quais você pode navegar e instalar. É possível adicionar um marketplace à sua configuração da CLI, o que permite usar a CLI para navegar e instalar plugins desse marketplace—consulte [Adicionando marketplaces de plugins](#adding-plugin-marketplaces).
Copilot vem com dois marketplaces já registrados por padrão: `copilot-plugins` e `awesome-copilot`.

Para usar a CLI para navegar pelos plug-ins em um de seus marketplaces registrados:

1. **Verifique quais marketplaces estão registrados no momento.**

   No terminal, liste os marketplaces disponíveis inserindo:

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

   Como alternativa, em uma sessão interativa, insira:

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

2. **Navegue pelos plug-ins em um marketplace registrado.**

   Na lista de marketplaces registrados, copie o nome do marketplace que você deseja procurar, por exemplo, `awesome-copilot`insira o seguinte comando, substituindo `MARKETPLACE-NAME`:

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

   ```

## Instalando plug-ins

Você pode instalar plug-ins de um marketplace registrado. Para obter informações sobre como registrar marketplaces adicionais, consulte [Adicionando marketplaces de plug-in](#adding-plugin-marketplaces).

Para instalar um plug-in, insira:

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

Por exemplo, para instalar o `database-data-management` plug-in do `awesome-copilot` marketplace, insira:

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

Como alternativa, em uma sessão interativa, insira:

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

## Gerenciando plug-ins instalados

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

## Adicionando marketplaces de plugins

Para adicionar um marketplace à lista de marketplaces registrados, insira o seguinte comando no terminal:

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

O formato OWNER/REPO identifica um repositório em GitHub.com configurado como um marketplace de plug-ins para a CLI.

Por exemplo, para adicionar o `claude-code-plugins` marketplace, hospedado em <https://github.com/anthropics/claude-code>, insira:

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

Como alternativa, em uma sessão interativa, insira:

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

Se um marketplace estiver localizado no sistema de arquivos local, em vez de em GitHub.com, use o caminho para o diretório do marketplace ao invés de OWNER/REPO. Por exemplo:

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

Se um marketplace estiver localizado em um repositório Git que não está hospedado no GitHub.com, use a URL do repositório Git. Por exemplo:

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

## Removendo marketplaces de plugins

Para remover um marketplace da CLI, insira:

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

Ou, em uma sessão interativa:

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

> \[!NOTE]
>
> * Ao adicionar um marketplace, você faz referência ao marketplace usando o OWNER/REPO do GitHub repositório que foi configurado como um marketplace. Ao remover um marketplace, no entanto, você faz referência ao nome do marketplace como ele aparece em sua lista de marketplaces registrados.
> * Se você tentar remover um marketplace que tenha plug-ins instalados, o comando falhará com uma mensagem de erro que lista os plug-ins instalados no momento desse marketplace. Adicione a opção `--force` ao comando para remover o marketplace e desinstalar todos os plug-ins que foram instalados desse marketplace.

## Leitura adicional

* [Criando um plug-in para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating)
* [Criando um marketplace de plugin para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace)