Référence du plug-in CLI GitHub Copilot

Pour obtenir une vue d’ensemble des plug-ins et de leur fonctionnement sur les Copilot clients, consultez À propos des GitHub Copilot plug-ins.

Commandes CLI

Vous pouvez utiliser les commandes suivantes dans le terminal pour gérer les plug-ins pour Copilot CLI. copilot plugins (au pluriel) est un ancien alias de copilot plugin — les deux renvoient à la même commande.

Avant que copilot plugin ne soit scindé en commandes distinctes selon la ressource, copilot plugins permettait également d’inspecter et d’activer ou de désactiver des serveurs MCP, des compétences, des instructions et des serveurs de langage à l’aide des indicateurs --kind, --scope, --mcp et --skill. Ces drapeaux de type croisé ont été supprimés. Utilisez plutôt les commandes dédiées copilot lsp, copilot instruction, copilot skill et copilot mcp. copilot plugin list --json émet désormais un tableau plat de plug-ins au lieu de l’objet précédent { plugins, errors } .

Spécification du module externe pour la commande install

Options copilot plugin list

Chaque --json ligne a la forme { name, marketplace?, version?, enabled, source, installedFrom? }.

copilot plugin enable/disable options

Options copilot plugin install

Pour installer une compétence au lieu d’un plug-in, utilisez copilot skill add plutôt : il ne s’agit pas d’une installation de plug-in et ne passe pas par une place de marché.

Les serveurs MCP s’installent à partir d’un registre configuré par une stratégie, ce qui nécessite une authentification et une entrée secrète interactive. Utilisez l’affichage en ligne du /mcp tableau de bord ou la copilot mcp add commande pour ajouter des serveurs MCP au lieu de copilot plugin install.

Options copilot plugin update

Les plug-ins propriétaires — ceux installés à partir des places de marché intégrées copilot-plugins et awesome-copilot — sont automatiquement mis à jour au début de chaque session dans un répertoire de travail de confiance. Désactivez ce comportement avec le autoUpdate paramètre (défini sur false) ou la variable d’environnement COPILOT_AUTO_UPDATE=false . La mise à jour automatique est également ignorée par défaut dans CI. Consultez « GitHub Copilot le répertoire de configuration du CLI ».

Une place de marché que vous avez ajoutée vous-même peut activer la même mise à jour automatique au démarrage de la session en définissant autoUpdate: true sur son entrée extraKnownMarketplaces dans vos paramètres utilisateur. Ce choix d’activation s’applique uniquement aux sessions interactives et -p — les sessions SDK et les sessions serveur ne se mettent pas à jour automatiquement. Il est respecté à partir de vos propres paramètres utilisateur ou des paramètres gérés (GPM/serveur), mais un paramètre au niveau autoUpdate du référentiel est accepté et ignoré. Il ne peut pas activer ou rediriger la mise à jour automatique pour une place de marché. En cas de collision de noms, une place de marché propriétaire intégrée prévaut, puis une entrée gérée (qui remplace l’intégralité de l’entrée utilisateur du même nom ; ainsi, une entrée gérée sans "autoUpdate": true supprime le consentement de l’utilisateur), puis l’entrée propre à l’utilisateur. Consultez les paramètres du référentiel.

En mode interactif, /plugin signale un plug-in installé ou une place de marché lorsqu’une version plus récente est disponible en amont et offre une action de mise à jour à partir du tableau de bord pour l’extraire.

copilot plugin marketplace (alias marketplaces) sous-commandes

Les places de marché par défaut intégrées sont fournies avec le runtime et ne peuvent pas être supprimées.

En mode interactif, exécutez /plugin marketplace refresh (alias /plugin marketplace update [NAME]), ou appuyez sur R dans la vue Marketplace du tableau de bord /plugin, pour mettre à jour le catalogue de chaque marketplace enregistré.

plugin.json

Tous les plug-ins se composent d’un répertoire de plug-ins contenant un fichier manifeste nommé plugin.json. Agent Plugins 1.0 requiert le fichier manifeste à la racine du plug-in. Les plug-ins hérités prennent en charge les emplacements alternatifs répertoriés dans Emplacements des fichiers. Consultez « Création d’un plug-in pour GitHub Copilot CLI ».

Copilot CLI prend en charge à la fois l’ancien manifeste de module d’extension et le manifeste d’Agent Plugins 1.0. La valeur exacte https://agent-plugins.org/schemas/1.0.0/plugin.schema.json``$schema active pour un plugin la sémantique Agent Plugins 1.0. Un manifeste sans cette valeur utilise le format hérité et se charge comme avant.

Champs du manifeste Agent Plugins 1.0

Agent Plugins 1.0 définit un schéma de manifeste fermé. Pour connaître les exigences de format complètes, consultez la spécification Agent Plugins 1.0.

Les champs suivants sont autorisés :

Les champs de niveau supérieur inconnus sont signalés et ignorés. Les champs de chemin d’accès du composant tels que agents, , skills``hooks, mcpServerset lspServers ne sont pas des champs manifeste d’Agent Plugins 1.0.

Contraintes de nom

Un nom Agent Plugins 1.0 doit :

• Contiennent entre 1 et 64 caractères.
• Contiennent uniquement des lettres ASCII minuscules, des chiffres, des traits d’union et des points.
• Début et fin avec un caractère alphanumérique.
• Ne pas contenir -- ou ...

Composants

Agent Plugins 1.0 définit deux types de composants portables :

• Compétences dans les sous-répertoires immédiats de skills/ qui contiennent un fichier SKILL.md.
• Serveurs MCP à la racine du plug-in mcp.json.

Ces emplacements sont fixes et ne peuvent pas être configurés dans plugin.json. La racine mcp.json doit déclarer https://agent-plugins.org/schemas/1.0.0/mcp.schema.json dans son $schema champ. L’interface CLI accepte stdio, streamable-httpet sse les noms de transport MCP.

Pour les serveurs stdio, la CLI fournit PLUGIN_ROOT et PLUGIN_DATA dans l’environnement du sous-processus. Développe ${PLUGIN_DATA} et ${PLUGIN_ROOT} dans les valeurs env, cwd et args du serveur. PLUGIN_DATA pointe vers un répertoire persistant accessible en écriture pour le plug-in installé.

Agent Plugins 1.0 ne définit pas d’agents portables, de hooks, de commandes, de règles ou de serveurs LSP. Celles-ci restent spécifiques au client. Les données de manifeste propres au client doivent figurer dans extensions, indexées à l’aide d’un espace de noms de domaine inversé. Les fichiers spécifiques au client appartiennent à un répertoire de niveau supérieur avec le même espace de noms. Les clients ignorent les espaces de noms qu’ils ne prennent pas en charge.

Copilot CLI lit ses composants spécifiques au client à partir du com.github.copilot répertoire :

Ces emplacements s’appliquent uniquement aux plug-ins Agent Plugins 1.0. Les anciens plug-ins continuent d’utiliser leurs propres emplacements de composants et champs de chemin d’accès au manifeste.

Fichier exemple Plugins d’agent 1.0 plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"]
}

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"]
}

Anciens champs du manifeste

Champ obligatoire

Champs de métadonnées facultatifs

Champs de chemin d’accès du composant

Celles-ci indiquent à l’interface CLI où trouver les composants de votre plug-in. Tous sont facultatifs. Le CLI utilise des conventions par défaut si elles sont omises.

Configuration du serveur LSP

Pour inclure des serveurs LSP (Language Server Protocol) dans un plug-in, créez un lsp-config/servers.json fichier dans le répertoire du plug-in ou spécifiez un chemin d’accès ou un objet inline à l’aide du lspServers champ dans plugin.json.

Exemple lsp-config/servers.json (ou en ligne via lspServers dans plugin.json):

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

Pour la prise en charge multiplateforme, utilisez bash et powershell à la place de command :

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

(*) Au moins un de command, bashou powershell est requis. Lorsque les deux bash et powershell sont spécifiés, la plateforme appropriée est sélectionnée automatiquement (PowerShell sur Windows, Bash ailleurs).

Permet ${PLUGIN_ROOT} de référencer des chemins d’accès dans le répertoire du plug-in.

marketplace.json

Vous pouvez créer une place de marché de plug-ins, que les utilisateurs peuvent utiliser pour découvrir et installer vos plug-ins, en créant un marketplace.json fichier et en l’enregistrant dans le .github/plugin/ répertoire du référentiel. Vous pouvez également stocker le marketplace.json fichier dans votre système de fichiers local. Par exemple, l’enregistrement du fichier tel qu’il /PATH/TO/my-marketplace/.github/plugin/marketplace.json vous permet de l’ajouter à l’interface CLI à l’aide de la commande suivante :

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

Pour plus d’informations, consultez « Création d’une place de marché de plug-ins pour GitHub Copilot CLI ».

Exemple de fichier marketplace.json

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "plugins@example.com"
  },
  "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": "plugins@example.com"
  },
  "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"
    }
  ]
}

Champs marketplace.json

Champs de niveau supérieur

Champs d’entrée de plug-in (objets dans le plugins tableau)

Types de sources de plug-in

Le source champ d’une entrée de plug-in accepte une chaîne de chemin d’accès relatif, ou un objet décrivant un référentiel ou une GitHub source d’URL Git :

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

Les types de source github et url acceptent tous deux un champ facultatif sha pour fixer les installations à un commit exact, en plus de ref (ou à la place de celui-ci) :

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

sha doit être un SHA de commit complet à 40 caractères. Fixez à un(e) sha pour des installations reproductibles à l’abri des poussées forcées ou des déplacements de balises/branches.

Emplacements des fichiers

Ordre de chargement et priorité

Si vous installez plusieurs plug-ins, il est possible que certains agents, compétences, serveurs MCP ou outils fournis via des serveurs MCP aient des noms en double. Dans ce cas, l’interface CLI détermine le composant à utiliser en fonction d’un ordre de priorité.

• Les agents et les compétences utilisent la précédence first-found-wins.

  Si vous disposez d’un agent personnalisé ou d’une compétence au niveau du projet portant le même nom ou id que celui d’un plug-in que vous installez, l’agent ou la compétence du plug-in est ignoré en mode silencieux. Le plug-in ne peut pas remplacer les configurations au niveau du projet ou personnelles. Les agents personnalisés sont dédupliqués à l’aide de leur ID, qui est dérivé de son nom de fichier (par exemple, si le fichier est nommé reviewer.agent.md, l’ID de l’agent est reviewer). Les compétences sont dédupliquées par leur champ de nom à l’intérieur du fichier SKILL.md.

• Les serveurs MCP utilisent la priorité "last-wins".

  Si vous installez un plug-in qui définit un serveur MCP portant le même nom de serveur qu’un serveur MCP que vous avez déjà installé, la définition du plug-in est prioritaire. Vous pouvez utiliser l’option --additional-mcp-config de ligne de commande pour remplacer une configuration de serveur MCP avec le même nom, installée à l’aide d’un plug-in. Si deux plug-ins ou plus déclarent un serveur MCP portant le même nom, l’interface CLI utilise la version du plug-in qui a chargé en dernier et affiche un avertissement nommant chaque plug-in précédent qui l’a défini.

• Les outils et agents intégrés sont toujours présents et ne peuvent pas être substitués par les composants définis par l’utilisateur.

Le diagramme suivant illustre les règles d’ordre de chargement et de priorité.

┌──────────────────────────────────────────────────────────────────┐
│  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)             │
  └─────────────────────────────────────────────────────────────────────┘

Lectures complémentaires

• À propos des normes de plug-in gérés par l’entreprise
• GitHub Copilot CLI
• Référence de commande CLI pour GitHub Copilot
• référence programmatique du CLI GitHub Copilot