Localizando e instalando plug-ins para CLI do GitHub Copilot

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

Neste artigo

Introdução

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

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

Observação

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

Você pode instalar plug-ins de um marketplace registrado. Para obter informações sobre como registrar marketplaces adicionais, consulte Adicionando marketplaces de plug-in.

Para instalar um plug-in, insira:

Shell
copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

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

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

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

Copilot prompt
/plugin install PLUGIN-NAME@MARKETPLACE-NAME

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

Adicionando marketplaces de plugins

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

Shell
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
copilot plugin marketplace add anthropics/claude-code

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

Copilot prompt
/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
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
copilot plugin marketplace add https://gitlab.com/OWNER/REPO.git

Removendo marketplaces de plugins

Para remover um marketplace da CLI, insira:

Shell
copilot plugin marketplace remove MARKETPLACE-NAME

Ou, em uma sessão interativa:

Copilot prompt
/plugin marketplace remove MARKETPLACE-NAME

Observação

  • 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