{"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":"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\nEine Übersicht darüber, was Plug-Ins sind und wie sie über Copilot Clients hinweg funktionieren, finden Sie unter [Informationen zu GitHub Copilot Plug-Ins](/de/copilot/concepts/agents/about-plugins).\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 sie ein benanntes Plug-In. Verwenden Sie `--all`, um alle installierten Plug-Ins auf einmal zu aktualisieren. |\n| `copilot plugin enable NAME` | Aktivieren eines zuvor deaktivierten Plug-Ins |\n| `copilot plugin disable NAME` | Deaktivieren eines Plug-Ins ohne Deinstallation |\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| `./my-plugin` oder `/abs/path` | Lokales Verzeichnis | |\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| `name` (erforderlich), `email` (optional), `url` (optional). | | |\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| `extensions` | string \\| string\\[] \\| object | — | Pfad(n) zu Erweiterungsverzeichnissen. Verwenden Sie `{ paths: [...], exclusive: true }`, um integrierte Erweiterungen zu unterdrücken. |\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### LSP-Serverkonfiguration\n\nUm LSP-Server (Language Server Protocol) in ein Plugin einzubinden, erstellen Sie eine `lsp-config/servers.json`-Datei im Plugin-Verzeichnis oder geben Sie über das Feld `lspServers` in `plugin.json` einen Pfad oder ein Inline-Objekt an.\n\nBeispiel `lsp-config/servers.json` (oder inline über `lspServers` in `plugin.json`):\n\n```json\n{\n \"lspServers\": {\n \"my-lsp\": {\n \"command\": \"my-language-server\",\n \"fileExtensions\": { \".myext\": \"mylang\" }\n }\n }\n}\n```\n\nFür plattformübergreifende Unterstützung verwenden Sie `bash` und `powershell` anstelle von `command`:\n\n```json\n{\n \"lspServers\": {\n \"my-lsp\": {\n \"bash\": \"${PLUGIN_ROOT}/scripts/start-lsp.sh\",\n \"powershell\": \"${PLUGIN_ROOT}/scripts/start-lsp.ps1\",\n \"fileExtensions\": { \".myext\": \"mylang\" }\n }\n }\n}\n```\n\n| Feld | Typ | Erforderlich | Beschreibung |\n| ----------------------- | --------- | ------------ | ----------------------------------------------------------------------------------------------- |\n| `command` | Schnur | \\* | Ausführbare Datei zum Starten des Sprachservers. |\n| `bash` | Schnur | \\* | Bash-Skript zum Starten des Servers (Linux/macOS); ausgeführt über `bash -c SCRIPT`. |\n| `powershell` | Schnur | \\* | PowerShell-Skript zum Starten des Servers (Windows); ausgeführt über `pwsh -c SCRIPT`. |\n| `cwd` | Schnur | No | Arbeitsverzeichnis. Absolut oder relativ zur Konfigurationsdatei. Unterstützt `${PLUGIN_ROOT}`. |\n| `args` | string\\[] | No | Argumente, die an `command` übergeben werden (ignoriert für `bash` und `powershell`). |\n| `env` | Objekt | No | Umgebungsvariablen, die beim Spawning des Servers festgelegt werden sollen. |\n| `fileExtensions` | Objekt | Ja | Zuordnung von Dateierweiterungen zu Sprach-IDs (z. B. `{ \".ts\": \"typescript\" }`). |\n| `rootUri` | Schnur | No | Projektwurzelverzeichnis relativ zum Git-Stammverzeichnis (Standard: `.`). |\n| `initializationOptions` | beliebig | No | Optionen, die an den Server in der LSP-Anforderung `initialize` gesendet werden. |\n\n(\\*) Mindestens einer von `command`, `bash`oder `powershell` ist erforderlich. Wenn sowohl `bash` als auch `powershell` angegeben werden, wird die plattformgerechte Option automatisch ausgewählt (PowerShell auf Windows, Bash an anderer Stelle).\n\nVerwenden Sie `${PLUGIN_ROOT}`, um auf Pfade innerhalb des Plugin-Verzeichnisses zu verweisen.\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### `marketplace.json` Felder\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| `{ name, email? }` — Marketplace-Besitzerinformationen. | | | |\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| `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` (über einen Marketplace installiert) und `~/.copilot/installed-plugins/_direct/SOURCE-ID/` (direkt installiert) | |\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| Plug-In-Daten | |\n| `${COPILOT_PLUGIN_DATA}` (auch verfügbar als `${CLAUDE_PLUGIN_DATA}`). Verweist auf ein dauerhaftes, schreibbares Verzeichnis, das für jedes installierte Plug-In eindeutig ist. Verwenden Sie dies für Plug-In-spezifische Laufzeitdaten anstelle von Pfaden innerhalb des Cacheverzeichnisses installierter Plug-Ins. | |\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/ (project) │\n │ 5. /.claude/agents/ (inherited, monorepo) │\n │ 6. PLUGIN: agents/ dirs (plugin, by install order) │\n │ 7. 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. PLUGIN: skills/ dirs (plugin) │\n │ 8. 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* [Informationen zu unternehmensverwalteten Plug-In-Standards](/de/copilot/concepts/agents/about-enterprise-plugin-standards)\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)"}