Поиск и установка плагинов для GitHub Copilot CLI

Расширьте функционал Copilot, установив плагины, созданные сообществом или вашей командой.

В этой статье

Введение

Плагины — это пакеты, расширяющие функциональность Интерфейс командной строки Copilot. Вы можете установить плагин с маркетплейса, зарегистрированного в CLI, из Git-репозитория или с локального пути.

Дополнительные сведения см. в разделе О плагинах для GitHub Copilot CLI.

Примечание.

Помощь по использованию плагинов можно найти copilot plugin [SUBCOMMAND] --help в терминале.

Поиск плагинов

Плагины собираются вместе на маркетплейсах. Маркетплейс — это реестр плагинов, из которых можно просматривать и устанавливать. Вы можете добавить маркетплейс в конфигурацию CLI, который позволит использовать CLI для просмотра и установки плагинов с этого маркетплейса — см. раздел Добавление маркетплейсов плагинов. Copilot поставляется с двумя уже зарегистрированными маркетплейсами по умолчанию: copilot-plugins и awesome-copilot.

В качестве альтернативы можно поискать маркетплейсы плагинов в интернете и добавить плагин прямо из репозитория.

Чтобы использовать CLI для просмотра плагинов на одном из зарегистрированных маркетплейсов:

  1.        **Проверьте, какие маркетплейсы сейчас зарегистрированы.**

    В терминале перечислите доступные рынки, введя следующие пункты:

    Shell
    copilot plugin marketplace list

    Альтернативно, в интерактивной сессии, введите:

    Copilot prompt
    /plugin marketplace list

  2.        **Просматривайте плагины на зарегистрированном маркетплейсе.**

    Из списка зарегистрированных маркетплейсов скопируйте название нужного маркетплейса — например, awesome-copilot— затем введите следующую команду, заменив MARKETPLACE-NAME:

    Shell
    copilot plugin marketplace browse MARKETPLACE-NAME

Установка плагинов

Обычно вы устанавливаете плагин с одного из зарегистрированных маркетплейсов. Однако вы также можете установить плагин напрямую из репозитория Git или с локального пути.

Для получения информации о том, как зарегистрировать дополнительные маркетплейсы, см. раздел Добавление и удаление маркетплейсов плагинов.

Установка с зарегистрированного маркетплейса

Shell
copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

Например, чтобы установить плагин database-data-management с awesome-copilot маркетплейса, введите:

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

Альтернативно, в интерактивной сессии, введите:

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

Установите напрямую из онлайн-репозитория Git

Вы можете установить плагин напрямую из репозитория, а не через зарегистрированный маркетплейс.

Чтобы установить плагин напрямую из репозитория на GitHub.com, введите:

Shell
copilot plugin install OWNER/REPO

Чтобы установить плагин из любого онлайн-репозитория Git, введите:

Shell
copilot plugin install URL-OF-GIT-REPO

Например: copilot plugin install https://gitlab.com/OWNER/REPO.git.

Внимание

Для работы этих команд репозиторий должен содержать plugin.json файл в каталоге .github/plugin или .claude-plugin в корне репозитория.

Чтобы установить плагин напрямую из репозитория GitHub.com, где plugin.json файл находится где-то отлично, или .github/plugin``.claude-pluginиз корня репозитория — например, если вы устанавливаете плагин непосредственно из репозитория маркетплейса, такого как anthropics/claude-code — введите:

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

Где PATH/TO/PLUGIN — путь от корня репозитория к каталогу, содержащему plugin.json, .github/plugin/plugin.json или .claude-plugin/plugin.json.

Например: copilot plugin install anthropics/claude-code:plugins/frontend-design

Установка с локального пути

Shell
copilot plugin install ./PATH/TO/PLUGIN

Управление установленными плагинами

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

Где хранятся плагины

Плагины, установленные на маркетплейсе, хранятся в: ~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME/. Плагины, установленные напрямую (например, с локального пути), хранятся по: ~/.copilot/installed-plugins/_direct/PLUGIN-NAME/.

Добавление маркетплейсов плагинов

Чтобы добавить маркетплейс в список зарегистрированных маркетплейсов, введите следующую команду в терминале:

Shell
copilot plugin marketplace add OWNER/REPO

Где OWNER/REPO идентифицирует репозиторий на GitHub.com, настроенный как маркетплейс плагинов CLI.

Например, чтобы добавить claude-code-plugins маркетплейс, размещённый по https://github.com/anthropics/claude-codeадресу , введите:

Shell
copilot plugin marketplace add anthropics/claude-code

Альтернативно, в интерактивной сессии, введите:

Copilot prompt
/plugin marketplace add OWNER/REPO

Если маркетплейс находится в локальной файловой системе, а не на GitHub.com, используйте путь к каталогу маркетплейса вместо OWNER/REPO. Рассмотрим пример.

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

Если маркетплейс находится в репозитории Git, который не размещён на GitHub.com, используйте URL репозитория Git. Рассмотрим пример.

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

Удаление маркетплейсов плагинов

Чтобы удалить маркетплейс из CLI, введите:

Shell
copilot plugin marketplace remove MARKETPLACE-NAME

Или, в интерактивной сессии:

Copilot prompt
/plugin marketplace remove MARKETPLACE-NAME

Примечание.

  • При добавлении маркетплейса вы ссылаетесь на маркетплейс с помощью OWNER/REPO репозитория GitHub, который настроен как маркетплейс. Однако при удалении маркетплейса вы ссылаетесь на его название в списке зарегистрированных маркетплейсов.
  • Если вы попытаетесь удалить маркетплейс, где установлены плагины, команда провалится, появится сообщение об ошибке, в котором перечисляются плагины, которые сейчас установлены на этом маркетплейсе. Добавьте --force в команду опцию удаления маркетплейса и удаления всех плагинов, установленных с этого маркетплейса.

Дополнительные материалы

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

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