{"meta":{"title":"GitHub Copilot CLI-Plug-In-Referenz","intro":"Hier finden Sie Befehle und Konfigurationsdetails für CLI-Plug-Ins.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/reference","title":"Verweis"},{"href":"/de/copilot/reference/copilot-cli-reference","title":"\n Copilot CLI Verweis"},{"href":"/de/copilot/reference/copilot-cli-reference/cli-plugin-reference","title":"CLI-Plug-In-Referenz"}],"documentType":"article"},"body":"# GitHub Copilot CLI-Plug-In-Referenz\n\nHier finden Sie Befehle und Konfigurationsdetails für CLI-Plug-Ins.\n\n> \\[!NOTE]\n> Hilfe zur Verwendung von Plugins finden Sie, indem Sie `copilot plugin [SUBCOMMAND] --help` im Terminal eingeben.\n\n## CLI-Befehle\n\nSie können die folgenden Befehle im Terminal verwenden, um Plug-Ins für Copilot CLI zu verwalten.\n\n| Befehl | Beschreibung |\n| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `copilot plugin install SPECIFICATION` | Installieren Sie ein Plug-In. Siehe [Plug-In-Spezifikation für `install` befehl](#plugin-specification-for-install-command) unten. |\n| `copilot plugin uninstall NAME` | Entfernen eines Plug-Ins |\n| `copilot plugin list` | Auflisten installierter Plugins |\n| `copilot plugin update NAME` | Aktualisieren eines Plug-Ins |\n| `copilot plugin marketplace add SPECIFICATION` | Registrieren eines Marketplace |\n| `copilot plugin marketplace list` | Auflisten registrierter Marktplätze |\n| `copilot plugin marketplace browse NAME` | Durchsuchen von Marketplace-Plug-Ins |\n| `copilot plugin marketplace remove NAME` | Aufheben der Registrierung eines Marketplace |\n\n### Plug-In-Spezifikation für `install` Befehl\n\n| Format | Beispiel | Beschreibung |\n| -------------- | ---------------------------- | ------------------------------------------- |\n| Marktplatz | `plugin@marketplace` | Plug-In von einem registrierten Marketplace |\n| GitHub | `OWNER/REPO` | Stamm eines GitHub Repositorys |\n| GitHub Subdir | `OWNER/REPO:PATH/TO/PLUGIN` | Unterverzeichnis in einem Repository |\n| Git-URL | `https://github.com/o/r.git` | Beliebige Git-URL |\n| Lokaler Pfad | | |\n\n```\n `./my-plugin` oder `/abs/path` | Lokales Verzeichnis |\n```\n\n## `plugin.json`\n\nAlle Plug-Ins bestehen aus einem Plug-In-Verzeichnis, das mindestens eine Manifestdatei mit dem Namen `plugin.json` enthält, die sich im Stammverzeichnis des Plug-In-Verzeichnisses befindet. Siehe [Erstellen eines Plug-Ins für GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).\n\n### Pflichtfeld\n\n| Feld | Typ | Beschreibung |\n| ------ | ------ | ----------------------------------------------------------------------------------------------- |\n| `name` | Schnur | Name des Kebab-Case-Plugins (nur Buchstaben, Zahlen und Bindestriche erlaubt). Max. 64 Zeichen. |\n\n### Optionale Metadatenfelder\n\n| Feld | Typ | Beschreibung |\n| ------------- | ------ | -------------------------------------- |\n| `description` | Schnur | Kurze Beschreibung. Max. 1024 Zeichen. |\n| `version` | Schnur | Semantische Version (z. B. `1.0.0`). |\n| `author` | Objekt | |\n\n```\n `name` (erforderlich), `email` (optional), `url` (optional). |\n```\n\n\\| `homepage` | Schnur | Url der Plug-In-Homepage. |\n\\| `repository` | Schnur | Quell-Repository-URL. |\n\\| `license` | Schnur | Lizenz-ID (z. B. `MIT`). |\n\\| `keywords` | string\\[] | Suchstichwörter. |\n\\| `category` | Schnur | Plug-In-Kategorie. |\n\\| `tags` | string\\[] | Zusätzliche Tags. |\n\n### Komponentenpfadfelder\n\nDiese teilen der CLI mit, wo sie die Komponenten Ihres Plug-Ins finden. Alle sind optional. Die CLI verwendet Standardkonventionen, wenn sie weggelassen werden.\n\n| Feld | Typ | Vorgabe | Beschreibung |\n| ------------ | ------------------------------- | --------- | ---------------------------------------------------------------------------------------- |\n| `agents` | Zeichenkette \\| Zeichenkette\\[] | `agents/` | Pfade zu Agentenverzeichnissen (`.agent.md`-Dateien). |\n| `skills` | Zeichenkette \\| Zeichenkette\\[] | `skills/` | Pfad(n) zu Qualifikationsverzeichnissen (`SKILL.md` Dateien). |\n| `commands` | Zeichenkette \\| Zeichenkette\\[] | — | Pfade zu Befehlsverzeichnissen. |\n| `hooks` | string-Objekt \\| | — | Pfad zu einer Hooks-Konfigurationsdatei oder einem Inline-Hooks-Objekt. |\n| `mcpServers` | string-Objekt \\| | — | Pfad zu einer MCP-Konfigurationsdatei (z. B. `.mcp.json`) oder Inlineserverdefinitionen. |\n| `lspServers` | string-Objekt \\| | — | Pfad zu einer LSP-Konfigurationsdatei oder Inlineserverdefinitionen. |\n\n### Beispieldatei für `plugin.json`\n\n```json copy\n{\n \"name\": \"my-dev-tools\",\n \"description\": \"React development utilities\",\n \"version\": \"1.2.0\",\n \"author\": {\n \"name\": \"Jane Doe\",\n \"email\": \"jane@example.com\"\n },\n \"license\": \"MIT\",\n \"keywords\": [\"react\", \"frontend\"],\n \"agents\": \"agents/\",\n \"skills\": [\"skills/\", \"extra-skills/\"],\n \"hooks\": \"hooks.json\",\n \"mcpServers\": \".mcp.json\"\n}\n```\n\n## `marketplace.json`\n\nSie können einen Plug-In-Marketplace erstellen , mit dem Benutzer Ihre Plug-Ins entdecken und installieren können, indem Sie eine `marketplace.json` Datei erstellen und im `.github/plugin/` Verzeichnis des Repositorys speichern. Sie können die `marketplace.json` Datei auch in Ihrem lokalen Dateisystem speichern. Speichern Sie die Datei beispielsweise als `/PATH/TO/my-marketplace/.github/plugin/marketplace.json`, um sie mit dem folgenden Befehl zur CLI hinzuzufügen:\n\n```shell\ncopilot plugin marketplace add /PATH/TO/my-marketplace\n```\n\n> \\[!NOTE]\n> Copilot CLI sucht auch nach der `marketplace.json` Datei im `.claude-plugin/` Verzeichnis.\n\nWeitere Informationen findest du unter [Erstellen eines Plugin-Marketplace für GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n### Beispieldatei für `marketplace.json`\n\n```json copy\n{\n \"name\": \"my-marketplace\",\n \"owner\": {\n \"name\": \"Your Organization\",\n \"email\": \"plugins@example.com\"\n },\n \"metadata\": {\n \"description\": \"Curated plugins for our team\",\n \"version\": \"1.0.0\"\n },\n \"plugins\": [\n {\n \"name\": \"frontend-design\",\n \"description\": \"Create a professional-looking GUI ...\",\n \"version\": \"2.1.0\",\n \"source\": \"./plugins/frontend-design\"\n },\n {\n \"name\": \"security-checks\",\n \"description\": \"Check for potential security vulnerabilities ...\",\n \"version\": \"1.3.0\",\n \"source\": \"./plugins/security-checks\"\n }\n ]\n}\n```\n\n> \\[!NOTE]\n> Der Wert des `source` Felds für jedes Plug-In ist der Pfad zum Verzeichnis des Plug-Ins relativ zum Stamm des Repositorys. Es ist nicht erforderlich, am Anfang des Pfads zu verwenden `./` . Beispiel: `\"./plugins/plugin-name\"` und `\"plugins/plugin-name\"` führen zum selben Verzeichnis.\n\n###\n\n```\n `marketplace.json` Felder\n```\n\n#### Felder auf oberster Ebene\n\n| Feld | Typ | Erforderlich | Beschreibung |\n| ------- | ------ | ------------ | ------------------------------------------------- |\n| `name` | Schnur | Ja | Name des Kebab-case Marketplace. Max. 64 Zeichen. |\n| `owner` | Objekt | Ja | |\n\n```\n `{ name, email? }` — Marketplace-Besitzerinformationen. |\n```\n\n\\| `plugins` | Array | Ja | Liste der Plug-In-Einträge (siehe tabelle unten). |\n\\| `metadata` | Objekt | No | `{ description?, version?, pluginRoot? }` |\n\n#### Plug-In-Eintragsfelder (Objekte innerhalb des `plugins` Arrays)\n\n| Feld | Typ | Erforderlich | Beschreibung |\n| ------------- | ------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | Schnur | Ja | Name des Kebab-Case-Plugins. Max. 64 Zeichen. |\n| `source` | string-Objekt \\| | Ja | Wo das Plug-In abgerufen werden soll (relativer Pfad, GitHuboder URL). |\n| `description` | Schnur | No | Plug-In-Beschreibung. Max. 1024 Zeichen. |\n| `version` | Schnur | No | Plugin-Version. |\n| `author` | Objekt | No | `{ name, email?, url? }` |\n| `homepage` | Schnur | No | Url der Plug-In-Homepage. |\n| `repository` | Schnur | No | Quell-Repository-URL. |\n| `license` | Schnur | No | Lizenzbezeichner. |\n| `keywords` | string\\[] | No | Suchstichwörter. |\n| `category` | Schnur | No | Plug-In-Kategorie. |\n| `tags` | string\\[] | No | Zusätzliche Tags. |\n| `commands` | Zeichenkette \\| Zeichenkette\\[] | No | Pfade zu Befehlsverzeichnissen. |\n| `agents` | Zeichenkette \\| Zeichenkette\\[] | No | Pfade zu Agentverzeichnissen. |\n| `skills` | Zeichenkette \\| Zeichenkette\\[] | No | Pfade zu Qualifikationsverzeichnissen. |\n| `hooks` | string-Objekt \\| | No | Pfad zur Hooks-Konfiguration oder zu einem Inline-Hooks-Objekt. |\n| `mcpServers` | string-Objekt \\| | No | Pfad zu MCP-Konfigurations- oder Inlineserverdefinitionen. |\n| `lspServers` | string-Objekt \\| | No | Pfad zu LSP-Konfigurations- oder Inlineserverdefinitionen. |\n| `strict` | boolean | No | Wenn `true` (standard) müssen Plug-Ins den vollständigen Schema- und Validierungsregeln entsprechen. Wenn `false`eine entspannte Validierung verwendet wird, ermöglicht dies mehr Flexibilität – insbesondere für direkte Installationen oder Legacy-Plug-Ins. |\n\n## Dateispeicherorte\n\n| Element | Pfad |\n| --------------------- | ---- |\n| Installierte Plug-Ins | |\n\n```\n `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` (über einen Marketplace installiert) und `~/.copilot/installed-plugins/_direct/SOURCE-ID/` (direkt installiert) |\n```\n\n\\| Marketplacecache | Plattformcacheverzeichnis: `~/.cache/copilot/marketplaces/` (Linux), `~/Library/Caches/copilot/marketplaces/` (macOS). Überschreibbar mit `COPILOT_CACHE_HOME`. |\n\\| Plugin-Manifest |\n`.plugin/plugin.json`, `plugin.json`, `.github/plugin/plugin.json`oder `.claude-plugin/plugin.json` (in dieser Reihenfolge eingecheckt) |\n\\| Marketplace-Manifest |\n`marketplace.json`, `.plugin/marketplace.json`, `.github/plugin/marketplace.json`oder `.claude-plugin/marketplace.json` (in dieser Reihenfolge eingecheckt) |\n\\| Agenten |\n`agents/` (Standard, im Manifest außer Kraft gesetzt) |\n\\| Fähigkeiten |\n`skills/` (Standard, im Manifest außer Kraft gesetzt) |\n\\| Hooks-Konfiguration |\n`hooks.json` oder `hooks/hooks.json` |\n\\| MCP-Konfiguration |\n`.mcp.json`, `.github/mcp.json` |\n\\| LSP-Konfiguration |\n`lsp.json` oder `.github/lsp.json` |\n\n## Ladereihenfolge und Priorität\n\nWenn Sie mehrere Plug-Ins installieren, ist es möglich, dass einige benutzerdefinierte Agents, Fähigkeiten, MCP-Server oder Tools, die über MCP-Server bereitgestellt werden, doppelte Namen haben. In diesem Fall bestimmt die CLI, welche Komponente basierend auf einer Rangfolge verwendet werden soll.\n\n* **Agenten und Skills** nutzen das Prinzip 'Wer zuerst kommt, mahlt zuerst'.\n\n Wenn Sie über einen benutzerdefinierten Agent auf Projektebene oder eine Fähigkeit mit demselben Namen oder derselben ID wie eines in einem Plug-In verfügen, das Sie installieren, wird der Agent oder die Fähigkeit im Plug-In im Hintergrund ignoriert. Das Plug-In kann keine Konfigurationen auf Projektebene oder persönliche Konfigurationen außer Kraft setzen. Benutzerdefinierte Agents werden mit ihrer ID dedupliziert, die von ihrem Dateinamen abgeleitet wird (z. B. wenn die Datei benannt `reviewer.agent.md`ist, die Agent-ID ist `reviewer`). Fähigkeiten werden durch ihr Namensfeld innerhalb der `SKILL.md`-Datei dedupliziert.\n\n* **MCP-Server** verwenden das Last-Wins-Prinzip.\n\n Wenn Sie ein Plug-In installieren, das einen MCP-Server mit demselben Servernamen wie einen bereits installierten MCP-Server definiert, hat die Definition des Plug-Ins Vorrang. Sie können die `--additional-mcp-config` Befehlszeilenoption verwenden, um eine MCP-Serverkonfiguration mit demselben Namen außer Kraft zu setzen, die mit einem Plug-In installiert wird.\n\n* **Integrierte Tools und Agents** sind immer vorhanden und können nicht von benutzerdefinierten Komponenten außer Kraft gesetzt werden.\n\nDas folgende Diagramm veranschaulicht die Ladereihenfolge und Rangfolgeregeln.\n\n```text\n┌──────────────────────────────────────────────────────────────────┐\n│ BUILT-IN - HARDCODED, ALWAYS PRESENT │\n│ • tools: bash, view, apply_patch, glob, rg, task, ... │\n│ • agents: explore, task, code-review, general-purpose, research │\n└────────────────────────┬─────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID) │\n │ 1. ~/.copilot/agents/ (user, .github convention) │\n │ 2. /.github/agents/ (project) │\n │ 3. /.github/agents/ (inherited, monorepo) │\n │ 4. ~/.claude/agents/ (user, .claude convention) │\n │ 5. /.claude/agents/ (project) │\n │ 6. /.claude/agents/ (inherited, monorepo) │\n │ 7. PLUGIN: agents/ dirs (plugin, by install order) │\n │ 8. Remote org/enterprise agents (remote, via API) │\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ AGENT SKILLS - FIRST LOADED IS USED (dedup by name) │\n │ 1. /.github/skills/ (project) │\n │ 2. /.agents/skills/ (project) │\n │ 3. /.claude/skills/ (project) │\n │ 4. /.github/skills/ etc. (inherited) │\n │ 5. ~/.copilot/skills/ (personal-copilot) │\n │ 6. ~/.agents/skills/ (personal-agents) │\n │ 7. ~/.claude/skills/ (personal-claude) │\n │ 8. PLUGIN: skills/ dirs (plugin) │\n │ 9. COPILOT_SKILLS_DIRS env + config (custom) │\n │ --- then commands (.claude/commands/), skills override commands ---│\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ MCP SERVERS - LAST LOADED IS USED (dedup by server name) │\n │ 1. ~/.copilot/mcp-config.json (lowest priority) │\n │ 2. PLUGIN: MCP configs (plugins) │\n │ 3. --additional-mcp-config flag (highest priority) │\n └─────────────────────────────────────────────────────────────────────┘\n```\n\n## Weiterführende Lektüre\n\n* [GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli)\n* [GitHub Copilot CLI-Befehlsreferenz](/de/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [Programmgesteuerte Referenz für die GitHub Copilot-CLI](/de/copilot/reference/copilot-cli-reference/cli-programmatic-reference)"}