Referencia del plugin CLI de GitHub Copilot

Para obtener información general sobre qué son los complementos y cómo funcionan en los Copilot clientes, consulte Información sobre GitHub Copilot complementos.

Comandos de la CLI

Puede usar los siguientes comandos en el terminal para administrar complementos para CLI de Copilot. copilot plugin y copilot plugins son intercambiables; usa el que mejor encaje en el subcomando.

De forma no interactiva, copilot plugins enable NAME --plugin, copilot plugins disable NAME --pluginy copilot plugins remove NAME --plugin proporcionan las mismas operaciones de habilitación, deshabilitación y desinstalación. --plugin es el tipo predeterminado y se puede omitir para estos tres comandos. Consulte Referencia de comandos de la CLI de GitHub Copilot para ver los tipos no interactivos --mcp y --skill, que amplían estos comandos a los servidores MCP y las habilidades.

Especificación para el comando del complemento install

copilot plugins install Opciones

Además de instalar un complemento desde una especificación, copilot plugins install puede instalar una aptitud individual desde un archivo, una dirección URL o un directorio con --skill. La instalación de una skill no es lo mismo que la instalación de un complemento y no se realiza a través de ningún marketplace; consulta Referencia de comandos de la CLI de GitHub Copilot para obtener más información sobre las propias skills.

La instalación de un directorio lo registra como un origen de aptitudes personalizado en lugar de copiarlo; al instalar un archivo o una dirección URL se copia el contenido de la aptitud en el directorio de aptitudes personales o de proyecto.

Los servidores MCP se instalan desde un registro configurado por directivas, lo que requiere autenticación e entrada secreta interactiva. Usa el /plugins panel de control (modo en línea) o el /mcp comando con barra para añadir servidores MCP en lugar de copilot plugins install.

copilot plugins update Opciones

copilot plugins marketplace subcomandos

Los marketplaces predeterminados integrados se incluyen con el entorno de ejecución y no se pueden quitar.

plugin.json

Todos los complementos constan de un directorio de complementos que contiene, como mínimo, un archivo de manifiesto denominado plugin.json ubicado en la raíz del directorio del complemento. Consulte Creación de un complemento para CLI de GitHub Copilot.

Campo obligatorio

Campos de metadatos opcionales

Campos de ruta de acceso de componente

Estos indican a la CLI dónde encontrar los componentes del complemento. Todos son opcionales. La CLI utiliza convenciones predeterminadas si se omiten ciertos parámetros.

Archivo plugin.json de ejemplo

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}

Configuración del servidor LSP

Para incluir servidores LSP (protocolo de servidor de idiomas) en un complemento, cree un archivo lsp-config/servers.json en el directorio del complemento, o especifique una ruta de acceso o un objeto en línea mediante el campo lspServers de plugin.json.

Ejemplo lsp-config/servers.json (o en línea mediante lspServers en plugin.json):

{
    "lspServers": {
        "my-lsp": {
            "command": "my-language-server",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}

Para la compatibilidad multiplataforma, use bash y powershell en lugar de command:

{
    "lspServers": {
        "my-lsp": {
            "bash": "${PLUGIN_ROOT}/scripts/start-lsp.sh",
            "powershell": "${PLUGIN_ROOT}/scripts/start-lsp.ps1",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}

(*) Se requiere al menos uno de command, basho powershell . Cuando se especifican bash y powershell, se selecciona automáticamente la adecuada para la plataforma (PowerShell en Windows, Bash en otro lugar).

Use ${PLUGIN_ROOT} para hacer referencia a rutas de acceso dentro del directorio del complemento.

marketplace.json

Puede crear un marketplace de complementos ,que los usuarios pueden usar para detectar e instalar los complementos, creando un marketplace.json archivo y guardándolo en el .github/plugin/ directorio del repositorio. También puede almacenar el marketplace.json archivo en el sistema de archivos local. Por ejemplo, guardar el archivo como /PATH/TO/my-marketplace/.github/plugin/marketplace.json le permite agregarlo a la CLI mediante el siguiente comando:

copilot plugin marketplace add /PATH/TO/my-marketplace

Para obtener más información, vea Creación de un marketplace de complementos para CLI de GitHub Copilot.

Archivo marketplace.json de ejemplo

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "[email protected]"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "[email protected]"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}

Campos marketplace.json

Campos de nivel superior

Campos de entrada del complemento (objetos dentro de la plugins matriz)

Tipos de origen del complemento

El campo source de una entrada de un complemento acepta una cadena con una ruta relativa o un objeto que describe un repositorio GitHub o un origen con una URL de Git:

{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "ref": "v1.0.0",
        "path": "plugins/my-plugin"
    }
}

Los tipos de origen github y url admiten un campo opcional sha para fijar las instalaciones a un commit exacto, además de (o en lugar de) ref:

{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "sha": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
        "path": "plugins/my-plugin"
    }
}

sha debe ser una confirmación completa de 40 caracteres SHA. Fijar a sha para realizar instalaciones reproducibles inmunes a los envíos forzados o a los cambios de etiqueta o rama.

Ubicaciones de archivos

Orden de carga y prioridad

Si instala varios complementos, es posible que algunos agentes personalizados, aptitudes, servidores MCP o herramientas proporcionados a través de servidores MCP tengan nombres duplicados. En esta situación, la CLI determina qué componente usar en función de un orden de precedencia.

• Los agentes y las aptitudes utilizan la prioridad de "primero en encontrar, primero en ganar."

  Si tiene un agente personalizado de nivel de proyecto o una aptitud con el mismo nombre o identificador que uno en un complemento que instale, el agente o la aptitud del complemento se omiten silenciosamente. El complemento no puede invalidar configuraciones personales o de nivel de proyecto. Los agentes personalizados se desduplican mediante su identificador, que se deriva de su nombre de archivo (por ejemplo, si el archivo se denomina reviewer.agent.md, el identificador del agente es reviewer). Las aptitudes se desduplican por su campo de nombre dentro del archivo SKILL.md.

• Los servidores MCP usan precedencia de última instancia.

  Si instala un complemento que define un servidor MCP con el mismo nombre de servidor que un servidor MCP que ya ha instalado, la definición del complemento tiene prioridad. Puede usar la --additional-mcp-config opción de línea de comandos para invalidar una configuración del servidor MCP con el mismo nombre, instalada mediante un complemento. Si dos o más complementos declaran un servidor MCP con el mismo nombre, la CLI usa la versión del complemento que cargó por última vez y muestra una advertencia que asigna un nombre a cada complemento anterior que lo definió.

• Las herramientas y agentes integrados siempre están presentes y no se pueden invalidar mediante componentes definidos por el usuario.

En el diagrama siguiente se muestran las reglas de orden de carga y precedencia.

┌──────────────────────────────────────────────────────────────────┐
│  BUILT-IN - HARDCODED, ALWAYS PRESENT                            │
│  • tools: bash, view, apply_patch, glob, rg, task, ...           │
│  • agents: explore, task, code-review, general-purpose, research │
└────────────────────────┬─────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID)                 │
  │  1. ~/.copilot/agents/           (user, .github convention)         │
  │  2. <project>/.github/agents/    (project)                          │
  │  3. <parents>/.github/agents/    (inherited, monorepo)              │
  │  4. <project>/.claude/agents/    (project)                          │
  │  5. <parents>/.claude/agents/    (inherited, monorepo)              │
  │  6. PLUGIN: agents/ dirs         (plugin, by install order)         │
  │  7. Remote org/enterprise agents (remote, via API)                  │
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  AGENT SKILLS - FIRST LOADED IS USED (dedup by name)                │
  │  1. <project>/.github/skills/        (project)                      │
  │  2. <project>/.agents/skills/        (project)                      │
  │  3. <project>/.claude/skills/        (project)                      │
  │  4. <parents>/.github/skills/ etc.   (inherited)                    │
  │  5. ~/.copilot/skills/               (personal-copilot)             │
  │  6. ~/.agents/skills/                (personal-agents)              │
  │  7. PLUGIN: skills/ dirs             (plugin)                       │
  │  8. COPILOT_SKILLS_DIRS env + config (custom)                       │
  │  --- then commands (.claude/commands/), skills override commands ---│
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  MCP SERVERS - LAST LOADED IS USED (dedup by server name)           │
  │  1. ~/.copilot/mcp-config.json       (lowest priority)              │
  │  2. PLUGIN: MCP configs              (plugins)                      │
  │  3. --additional-mcp-config flag     (highest priority)             │
  └─────────────────────────────────────────────────────────────────────┘

Lectura adicional

• Acerca de los estándares de complementos administrados por la empresa
• CLI de GitHub Copilot
• Referencia de comandos de la CLI de GitHub Copilot
• Referencia programática de la CLI de GitHub Copilot