GitHub Copilot CLI — Cheat Sheet

Der Spickzettel zum Seminar GitHub Copilot CLI Praxis — für alle, die agentisch im Terminal arbeiten und den einen Befehl suchen, der gerade fehlt. Maßgeblich ist die Originaldoku unter docs.github.com/copilot; Modellnamen und Befehlsbestand ändern sich dort schneller, als ein Blatt folgen kann. Was bleibt, sind die Entscheidungen: welcher Modus, wie viel Rechte, was in den Kontext gehört.

Installation und Anmeldung

npm install -g @github/copilot     # Node 22 oder neuer
brew install --cask copilot-cli    # Alternative: Homebrew
cd ~/projekte/mein-projekt         # immer im Projekt starten
copilot                            # interaktiv

Die Anmeldung läuft über /login in der laufenden Sitzung (Gerätecode im Browser, bei Organisationen zusätzlich SSO bestätigen). Für Skripte und CI stattdessen COPILOT_GITHUB_TOKEN setzen — nicht über die Shell-History.

Ohne aktives Copilot-Abo startet die CLI nicht, und jede Antwort kostet AI-Credits.

Modul: Einstieg & Setup

Die vier Interaktionsmodi

Shift+Tab wechselt im laufenden Betrieb zwischen Standard, Plan und Autopilot; die Statuszeile zeigt den aktiven Modus.

# Programmatic: eine Antwort, keine Sitzung
copilot -p "Schreibe eine Commit-Nachricht für die
  nicht eingecheckten Änderungen." > nachricht.txt

# Autopilot mit Leitplanken
copilot --autopilot --yolo \
  --max-autopilot-continues 10 \
  -p "Setze plan.md vollständig um."

--yolo (alias --allow-all) erteilt alle Rechte. Das Schrittlimit ist kein Zubehör: Ohne es verbrennt ein Irrlauf still das Kontingent, und geprüft wird am Ende über git diff, nicht über die Zusammenfassung des Agenten.

Modul: Interaktionsmodi & Befehle

Slash-Befehle im Alltag

Mit ! läuft ein Shell-Befehl, ohne die Sitzung zu verlassen. Die Modellliste ändert sich laufend — /model fragen statt Namen aus Tutorials übernehmen.

Modul: Interaktionsmodi & Befehle

Kontextfenster und Referenzen

/context zeigt diese Aufteilung samt Auslastung in Prozent.

> Wie robust ist @stations-api.js gegenüber
  Zeitüberschreitungen?
> Prüfe @tests auf Lücken bei der Filterlogik.
> Setze #142 um und halte dich an den Diff.

@ nimmt Dateien und Ordner (auch absolute Pfade), # holt Issues herein. Ohne Referenz sucht der Agent selbst — das kostet Werkzeugaufrufe und Zeit.

Modul: Arbeiten mit Kontext

Sessions fortsetzen und verdichten

Verdichtung läuft auch automatisch — /compact ist der Handbetrieb. Nach mehreren Verdichtungen fehlen Details; dann ist /new ehrlicher als Weiterreden.

Modul: Arbeiten mit Kontext

Eingebaute Agenten

Modul: Agenten & Skills

Agent oder Skill?

Beides schließt sich nicht aus — ein Agent darf Skills nutzen. Ablageorte: Agenten projektweit unter .github/agents/, persönlich unter ~/.copilot/agents/; Skills entsprechend unter .github/skills/ bzw. ~/.copilot/skills/.

---
name: a11y-reviewer
description: Prüft UI-Code auf Barrierefreiheit.
tools: [read, search]
---
Du bist Spezialist für barrierearme Oberflächen.
Prüfe Kontraste, Fokusreihenfolge und Labels.
Melde Funde nach Schweregrad, ohne Code zu ändern.

Die description ist die Fundstelle, nicht Deko: Sie entscheidet, ob ein Skill automatisch geladen wird. Ohne tools-Angabe darf der Spezialist alles, was die Sitzung darf.

Modul: Agenten & Skills

MCP-Server verwalten

/mcp search durchsucht die GitHub-MCP-Registry (experimentell), und copilot mcp add <name> -- <befehl> geht ganz ohne Sitzung.

{
  "mcpServers": {
    "ladenetz": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@firma/ladenetz-mcp"],
      "tools": ["stationen_suchen", "belegung_lesen"]
    }
  }
}

"tools": ["*"] gibt alles frei — eine Liste ist die schärfere Wahl. Liegt derselbe Server in Benutzer- und Projektdatei, gewinnt die Projektfassung still. Im Prompt den Server ausdrücklich nennen, sonst bleibt unklar, woher eine Antwort stammt; in der Ausgabe steht, welches Werkzeug wirklich lief.

Modul: Externe Datenquellen mit MCP

Typische Fallen

• Copilot außerhalb des Projektordners starten — dann fehlt der Kontext, den man eigentlich meint.
• Node älter als 22: die npm-Installation bricht ab oder startet nicht.
• Ohne Organisationsfreigabe (SSO) bleibt der Zugriff trotz Login verwehrt.
• Das teuerste Modell für einfache Aufgaben — auto nimmt das günstigste passende.
• Berechtigungsdialoge wegklicken: „Nicht mehr fragen” wirkt über den Moment hinaus.
• --yolo in fremden Repos ist kein Komfort, sondern ein Risiko.
• Autopilot ohne Erfolgskriterium und Schrittlimit läuft am Ziel vorbei und verbrennt still Credits.
• Im programmatischen Modus nachfassen wollen — Rückfragen werden nicht gestellt, sondern abgelehnt.
• Einen ganzen Ordner referenzieren, ohne hineingesehen zu haben.
• Alles in einer Session erledigen — der Verlauf wächst und trübt die Antworten.
• Jeder aktive MCP-Server belegt Kontext, bevor die erste Frage gestellt ist; ungenutzte abschalten.
• Zugangsdaten in die Projektdatei schreiben statt in Variablen.
• Von der CLI erzeugte Skills ungeprüft übernehmen — sie beschreiben Wunschzustände.

Module: Einstieg & Setup · Interaktionsmodi & Befehle · Arbeiten mit Kontext · Agenten & Skills · Externe Datenquellen mit MCP