GitHub Copilot

GitHub Copilot ist der Provider, mit dem OAR startet: Er ist immer verfügbar und nutzt die Copilot CLI, die auf dem Relay-Host angemeldet ist. Das Relay führt ihn auf einer von zwei Engines aus. Die SDK-Engine ist der Standard und bietet dir Nachsteuern, eine Task-Leiste für Hintergrund-Tasks und Fragen mit Mehrfachauswahl. Die Extension-Engine führt die echte Copilot CLI in einem Terminal aus, dem du zusehen kannst.

OpenAI mit deinem eigenen Key läuft auf denselben zwei Engines, daher gelten die Engine-Abschnitte dieser Seite auch dafür. Key und Modelle stehen auf der Seite OpenAI.

Was du brauchst #

• Die Copilot CLI, angemeldet, auf dem Relay-Host. Installiere sie mit npm install -g @github/copilot, führ einmal copilot aus und melde dich an. Dein GitHub-Konto braucht einen Copilot-Plan, der Copilot CLI enthält.
• Einen Neustart des Relays nach Installation oder Upgrade der CLI. Das Relay sucht die Runtime der CLI beim Start und sieht eine spätere Installation nicht.
• Die GitHub CLI (gh), angemeldet, für oar copilot, Sessions der Extension-Engine unter Windows und die Copilot-Karte in Check Usage (Verbrauch prüfen).
• tmux (optional, Linux und macOS), wenn du das Terminal einer Session mit 🖥️ Inspect tmux console (tmux-Konsole ansehen) beobachten willst.

Das Relay installiert oder aktualisiert die Copilot CLI nicht. In Settings → Providers → Copilot (Einstellungen → Provider → Copilot) meldet die Zeile GitHub Copilot CLI oben nur ihren Zustand.

Wie OAR die CLI findet #

Die SDK-Engine steuert die Runtime, die mit der Copilot CLI kommt. Beim Start sucht das Relay im Paket-Cache der CLI und nimmt die neueste Version dort:

Unter Linux folgen die beiden Ordner XDG_CACHE_HOME und XDG_DATA_HOME, wenn du sie setzt. Setz COPILOT_PKG_DIR, um einen Ordner zur Suche hinzuzufügen, oder COPILOT_SDK_PATH, um das copilot-sdk-Verzeichnis der Runtime direkt anzugeben. Wird nichts gefunden, ist die SDK-Engine nicht verfügbar (siehe Die Engine wählen).

oar copilot verwenden #

oar copilot startet das Relay im Hintergrund, wenn auf seinem Port keines antwortet, und öffnet dann die Copilot CLI (gh copilot) in deiner Shell. Ein Relay, das es gestartet hat, stoppt wieder, wenn die Session endet. Argumente nach -- gehen an gh copilot.

oar copilot
oar copilot --port 3400 -- --help

Jeder Lauf schreibt oder erneuert außerdem einen kleinen Wrapper in ~/.copilot/extensions/web-relay/, eine benutzerweite Extension, die die Extension von OAR in die Copilot CLI lädt. oar copilot --install-extension tut nur das und beendet sich (es braucht kein gh); --no-install-extension überspringt es für einen Lauf. Fehlt gh, sagt oar copilot das und stoppt; installiere die GitHub CLI oder starte nur das Relay mit oar start.

Die zwei Engines #

Beide Engines zeigen denselben Verlauf, dieselben Rückfrage-Karten, Plan-Boards, dieselbe Modellliste und Verbrauchszeile pro Antwort. Siehe Turns und die Queue für Steer, Queue (Einreihen) und die Fenster für hängende Turns, Relay-Modi und Kompaktieren für diese Zeilen sowie ask_user für Rückfrage-Karten.

Auf der SDK-Engine beendet Stop nur die Antwort. Hintergrund-Agents, die der Turn gestartet hat, laufen unter ihrem eigenen Stop in der Task-Leiste weiter.

Die Engine wählen #

Die Wahl ist eine Einstellung für das ganze Relay: Settings → Providers → Copilot → Copilot engine (Einstellungen → Provider → Copilot → Copilot-Engine), mit den Optionen Extension (Erweiterung) und SDK — default (SDK — Standard). Drück Save Copilot settings (Copilot-Einstellungen speichern), nachdem du sie geändert hast.

• Sie gilt für Konversationen, deren Worker danach startet. Eine bereits laufende Session behält ihre Engine, bis ihr Worker neu startet.
• Hat niemand eine Wahl gespeichert, nutzt das Relay SDK, wann immer es kann, und Extension, wenn nicht. Eine gespeicherte Wahl gewinnt immer. Das gilt auch für ein gespeichertes SDK: Findet ein späterer Neustart die CLI nicht mehr, wechselt das Relay nicht von selbst zurück, und der Worker einer neuen Konversation kann nicht starten, bis die CLI wieder gefunden wird oder du Extension speicherst.
• Die Einstellungsseite sagt, welche Engine eingestellt ist: New Copilot conversations run on the headless SDK worker. No tmux inspector for these sessions. oder New Copilot conversations run on the Copilot CLI with the web-relay extension.

Welche Engine eine laufende Konversation nutzt, erkennst du an ihrem Eingabebereich und ihrer tmux-Konsole. Während eines Turns heißt der Senden-Button auf der SDK-Engine Steer (dort heißt er Queue, solange eine Rückfrage-Karte oder Freigabe offen ist, der Turn kompaktiert oder ein Tool-Aufruf läuft) und auf der Extension-Engine immer Queue. Die tmux-Konsole zeigt nur auf der Extension-Engine einen Copilot-Bildschirm. Die Konversation selbst trägt keine Engine-Bezeichnung.

Wenn das Speichern von SDK abgelehnt wird #

Das Relay lehnt das Speichern von SDK ab, wenn es SDK nicht ausführen konnte, und zeigt den Grund anstelle der Engine-Beschreibung. Die gespeicherte Einstellung ändert sich nicht, und die Auswahl springt auf die Engine zurück, die das Relay tatsächlich ausführt.

Einstellungen #

Unter Settings → Providers → Copilot:

Andere Einstellungen, die Copilot-Sessions betreffen, liegen anderswo:

Modelle #

Das Relay liest die Modellliste aus der installierten Runtime der Copilot CLI wenige Sekunden nach dem Start. Jedes Modell zeigt die Reasoning-Efforts und das Kontextfenster, die die Runtime meldet. Die Liste beginnt mit auto und gruppiert die Modelle dann nach Hersteller (OpenAI, Anthropic, Google, xAI, Microsoft, Azure OpenAI, Moonshot AI, dann andere alphabetisch), neueste Version zuerst.

Bis zur ersten Erkennung bietet ein neues Relay gpt-5.4, gpt-5.4-mini (der Standard), gpt-5.3-codex, claude-sonnet-4.6 und claude-haiku-4.5 an.

Mit 🤗 Select Models → Copilot (Modelle auswählen → Copilot) im ⋯-Menü einer Konversation wählst du, welche Modelle im Eingabebereich erscheinen, dann 💾 Save enabled models (Aktivierte Modelle speichern). Refresh (Aktualisieren) liest die Liste erneut. Wirkt die Liste veraltet, drück Refresh.

Verbrauch #

• Unter einer Antwort zeigt ein Copilot-Turn, was er verbraucht hat: +N für die Credits, mit dem Anteil an deinem Monatsplan in Klammern, und month N% left. Ein stale-Tag heißt, dass die Zahlen für diesen Turn nicht aktualisiert werden konnten. Nur Copilot-Turns bekommen diese Zeile; andere Provider, OpenAI eingeschlossen, verbrauchen keine Copilot-Credits.
• Im Header summiert eine Session-Zeile die Konversation, zum Beispiel Session: 1.25 AIC used.
• In Check Usage: Öffne 📊 Check Usage im ⋯-Menü und wähl den Copilot-Tab für das Live-Kontingent (AI-Credits oder Premium-Requests, Chat und Plan). Auf der SDK-Engine kommt Last SDK worker turn hinzu: die Credits, die dieser Turn tatsächlich verbraucht hat, seine Tokens und Modellaufrufe. Das sind die Zahlen eines Turns, keine laufende Summe, und der Abschnitt verschwindet nach sieben Tagen.

Die Copilot-Karte liest dein Konto über gh. Wenn du gh nicht nutzt, setz GH_TOKEN oder GITHUB_TOKEN in der Umgebung des Relays.

Vorhandene Sessions importieren #

Beim Start importiert das Relay die auf dem Host gespeicherten Copilot-Sessions, sodass sie mit ihrem Verlauf in deiner Liste erscheinen. Es liest sie über die installierte Copilot-Runtime. Ist die Runtime nicht verfügbar, wird der Import als fehlgeschlagen gemeldet. Das Relay rät nicht anhand der Dateien.

Eine solche Session zu löschen blendet sie nur aus: Die eigene Session der Copilot CLI bleibt, weil das Relay sie nie ausgeführt hat.

Umgebungsvariablen #

Setz diese in der Umgebung des Relay-Prozesses und starte das Relay dann neu.

Grenzen #

• Das Relay braucht einen Neustart, um eine Copilot CLI zu bemerken, die nach seinem Start installiert oder aktualisiert wurde.
• Auf der SDK-Engine gibt es kein Terminal zum Anhängen.
• Nachrichten während eines Turns werden auf der Extension-Engine eingereiht; man kann mit ihnen nicht nachsteuern.
• Auf der SDK-Engine gibt das Relay einem Turn 2 Minuten Stille, wenn nichts läuft, 5 Minuten während einer Modellanfrage und 30 Minuten, während ein Tool läuft, bevor es den Turn fehlschlagen lässt. Ein Turn, der auf eine Rückfrage-Karte wartet, gilt nie als hängend. Die Fenster stehen in Turns und die Queue.
• Eine OpenAI-Konversation mit deinem eigenen Key nutzt diese Engines ebenfalls, verbraucht aber deinen Key, daher tragen ihre Turns keine Copilot-Verbrauchszeile.

Wenn es nicht funktioniert #

Agent-Sessions, Relay-Modi und anderes Verhalten, das nicht von der Engine abhängt, funktionieren wie auf den Seiten zu Sessions und Agents im Zusammenspiel beschrieben.