Búsqueda e instalación de complementos para CLI de GitHub Copilot

Amplíe la funcionalidad de Copilot mediante la instalación de complementos creados por la comunidad o por su equipo.

En este artículo

Introducción

Plugins son paquetes que amplían la funcionalidad de CLI de Copilot. Puede instalar un complemento desde un marketplace que haya registrado con la CLI, desde un repositorio de Git o desde una ruta de acceso local.

Para más información, consulta Acerca de los complementos para CLI de GitHub Copilot.

Nota:

Puede encontrar ayuda sobre el uso de complementos escribiendo copilot plugin [SUBCOMMAND] --help en el terminal.

Búsqueda de complementos

Los complementos se recopilan juntos en marketplaces. Un mercado es un registro de complementos donde puede explorar e instalar. Puede agregar un marketplace a la configuración de la CLI, lo que le permite usar la CLI para examinar e instalar complementos desde ese marketplace; consulte Adición de marketplaces de complementos. Copilot viene con dos marketplaces ya registrados de forma predeterminada: copilot-plugins y awesome-copilot.

Como alternativa, puede buscar marketplaces de complementos en línea y, a continuación, agregar un complemento directamente desde un repositorio.

Para usar la CLI para examinar los complementos en uno de los marketplaces registrados:

  1.        **Compruebe qué marketplaces están registrados actualmente.**

    En el terminal, enumere los marketplaces disponibles ingresando:

    Shell
    copilot plugin marketplace list

    Como alternativa, en una sesión interactiva, escriba:

    Copilot prompt
    /plugin marketplace list

  2.        **Examine los complementos en un marketplace registrado.**

    En la lista de marketplaces registrados, copie el nombre del marketplace que desea examinar(por ejemplo, ) y escriba awesome-copilotel siguiente comando, reemplazando MARKETPLACE-NAME:

    Shell
    copilot plugin marketplace browse MARKETPLACE-NAME

Instalación de complementos

Normalmente, instalarás un complemento desde uno de los marketplaces que hayas registrado. Sin embargo, también puede instalar un complemento directamente desde un repositorio de Git o desde una ruta de acceso local.

Para obtener información sobre cómo registrar marketplaces adicionales, consulte Adición y eliminación de marketplaces de complementos.

Instalación desde un marketplace registrado

Shell
copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

Por ejemplo, para instalar el database-data-management complemento desde awesome-copilot Marketplace, escriba:

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

Como alternativa, en una sesión interactiva, escriba:

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

Instalación directamente desde un repositorio git en línea

Puede instalar un complemento directamente desde un repositorio, en lugar de hacerlo mediante un marketplace registrado.

Para instalar un complemento directamente desde un repositorio en GitHub.com, escriba:

Shell
copilot plugin install OWNER/REPO

Para instalar un complemento desde cualquier repositorio git en línea, escriba:

Shell
copilot plugin install URL-OF-GIT-REPO

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

Importante

Para que estos comandos funcionen, el repositorio debe contener un plugin.json archivo en un .github/plugin directorio o .claude-plugin o en la raíz del repositorio.

Para instalar un complemento directamente desde un repositorio en GitHub.com donde el archivo plugin.json se encuentra en un lugar distinto de .github/plugin, .claude-plugin o de la raíz del repositorio, por ejemplo, si desea instalar un complemento directamente desde un repositorio de un mercado como antropics/claude-code, escriba:

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

Donde PATH/TO/PLUGIN es la ruta de acceso de la raíz del repositorio a un directorio que contiene plugin.json, .github/plugin/plugin.json o .claude-plugin/plugin.json.

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

Instalación desde una ruta de acceso local

Shell
copilot plugin install ./PATH/TO/PLUGIN

Administración de complementos 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

Dónde se almacenan los complementos

Los complementos instalados desde marketplace se almacenan en: ~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME/. Los complementos instalados directamente (por ejemplo, desde una ruta de acceso local) se almacenan en: ~/.copilot/installed-plugins/_direct/PLUGIN-NAME/.

Adición de marketplaces de complementos

Para agregar un marketplace a la lista de marketplace registrados, escriba el siguiente comando en el terminal:

Shell
copilot plugin marketplace add OWNER/REPO

Donde OWNER/REPO identifica un repositorio en GitHub.com que se ha configurado como marketplace de complementos para la CLI.

Por ejemplo, para agregar marketplace claude-code-plugins , hospedado en https://github.com/anthropics/claude-code, escriba:

Shell
copilot plugin marketplace add anthropics/claude-code

Como alternativa, en una sesión interactiva, escriba:

Copilot prompt
/plugin marketplace add OWNER/REPO

Si un marketplace se encuentra en el sistema de archivos local, en lugar de en GitHub.com, use la ruta al directorio del marketplace en lugar de OWNER/REPO. Por ejemplo:

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

Si un marketplace se encuentra en un repositorio de Git que no está hospedado en GitHub.com, use la dirección URL del repositorio de Git. Por ejemplo:

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

Eliminación de marketplaces de complementos

Para quitar un marketplace de la CLI, escriba:

Shell
copilot plugin marketplace remove MARKETPLACE-NAME

O bien, en una sesión interactiva:

Copilot prompt
/plugin marketplace remove MARKETPLACE-NAME

Nota:

  • Al agregar un marketplace, se hace referencia al marketplace mediante OWNER/REPO del repositorio GitHub que se ha configurado como marketplace. Sin embargo, al eliminar un marketplace, se hace referencia al nombre del marketplace tal como aparece en su lista de marketplaces registrados.
  • Si intenta quitar un marketplace que tiene complementos instalados, se producirá un error en el comando que muestra los complementos que están instalados actualmente desde ese marketplace. Agregue la --force opción al comando para quitar Marketplace y desinstalar todos los complementos que se instalaron desde ese marketplace.

Lectura adicional

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

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