Encontrar e instalar plugins para CLI do GitHub Copilot

Introdução

Plug-ins são pacotes que estendem a funcionalidade de CLI do Copilot. Você pode instalar um plugin de um marketplace ao qual você se registrou com a CLI, de um repositório Git ou de um caminho local.

Para saber mais, confira Sobre plug-ins para CLI do GitHub Copilot.

Localizando plug-ins

Os plug-ins são coletados juntos 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. Copilot vem com dois marketplaces já registrados por padrão: copilot-plugins e awesome-copilot.

Como alternativa, você pode pesquisar por marketplaces de plug-in online e, em seguida, adicionar um plug-in diretamente de um repositório.

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

   copilot plugin marketplace list
   

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

   Copilot prompt

   /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-copilotinsira o seguinte comando, substituindo MARKETPLACE-NAME:

   Shell

   copilot plugin marketplace browse MARKETPLACE-NAME
   
   

Instalando plug-ins

Normalmente, você instalará um plug-in de um de seus marketplaces registrados. No entanto, você também pode instalar um plug-in diretamente de um repositório Git ou de um caminho local.

Para obter informações sobre como registrar marketplaces adicionais, consulte Adicionar e remover marketplaces de plug-in.

Instalar de um marketplace registrado

copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

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

copilot plugin install database-data-management@awesome-copilot

copilot plugin install database-data-management@awesome-copilot

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

/plugin install PLUGIN-NAME@MARKETPLACE-NAME

/plugin install PLUGIN-NAME@MARKETPLACE-NAME

Instalar diretamente de um repositório Git online

Você pode instalar um plug-in diretamente de um repositório, em vez de fazer isso usando um marketplace registrado.

Para instalar um plug-in diretamente de um repositório no GitHub.com, insira:

copilot plugin install OWNER/REPO

copilot plugin install OWNER/REPO

Para instalar um plug-in de qualquer repositório Git online, insira:

copilot plugin install URL-OF-GIT-REPO

copilot plugin install URL-OF-GIT-REPO

Por exemplo, copilot plugin install https://gitlab.com/OWNER/REPO.git.

Para instalar um plug-in diretamente de um repositório no GitHub.com em que o arquivo plugin.json está localizado em uma localização diferente de .github/plugin, .claude-plugin, ou a raiz do repositório—por exemplo, se você estiver instalando um plug-in diretamente de um repositório do marketplace, como anthropics/claude-code—insira:

copilot plugin install OWNER/REPO:PATH/TO/PLUGIN

copilot plugin install OWNER/REPO:PATH/TO/PLUGIN

Onde PATH/TO/PLUGIN está o caminho da raiz do repositório para um diretório que contém plugin.json, .github/plugin/plugin.json ou .claude-plugin/plugin.json.

Por exemplo, copilot plugin install anthropics/claude-code:plugins/frontend-design

Instalar a partir de um caminho local

copilot plugin install ./PATH/TO/PLUGIN

copilot plugin install ./PATH/TO/PLUGIN

Gerenciando plug-ins instalados

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

Onde os plug-ins são armazenados

Os plug-ins instalados de um marketplace são armazenados em: ~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME/. Os plug-ins instalados diretamente (por exemplo, de um caminho local) são armazenados em: ~/.copilot/installed-plugins/_direct/PLUGIN-NAME/.

Adicionando marketplaces de plugins

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

copilot plugin marketplace add OWNER/REPO

copilot plugin marketplace add OWNER/REPO

Onde OWNER/REPO identifica um repositório no GitHub.com que foi configurado como um marketplace de plugins da CLI.

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

copilot plugin marketplace add anthropics/claude-code

copilot plugin marketplace add anthropics/claude-code

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

/plugin marketplace add OWNER/REPO

/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 em vez de OWNER/REPO. Por exemplo:

copilot plugin marketplace add /PATH/TO/MARKETPLACE-DIRECTORY

copilot plugin marketplace add /PATH/TO/MARKETPLACE-DIRECTORY

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

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

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

Removendo marketplaces de plugins

Para remover um marketplace da CLI, insira:

copilot plugin marketplace remove MARKETPLACE-NAME

copilot plugin marketplace remove MARKETPLACE-NAME

Ou, em uma sessão interativa:

/plugin marketplace remove MARKETPLACE-NAME

/plugin marketplace remove MARKETPLACE-NAME

Leitura adicional

•         [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating)
  

•         [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace)