CLI

Der CodeTutor CLI startet standardmäßig das TUI, wenn er ohne Argumente ausgeführt wird.

opencode

Es akzeptiert aber auch Befehle, wie auf dieser Seite dokumentiert. Dadurch können Sie programmgesteuert mit CodeTutor interagieren.

codetutor run "Explain how closures work in JavaScript"

---

tui

Starten Sie die Terminalbenutzeroberfläche CodeTutor.

opencode [project]

Optionen

Flag	Kurz	Beschreibung
--continue	-c	Setzen Sie die letzte Sitzung fort
--session	-s	Session-ID zum Fortfahren
--fork		Sitzung beim Fortsetzen verzweigen (mit --continue oder --session)
--prompt		Prompt zur Verwendung
--model	-m	Zu verwendendes Modell in der Form provider/model
--agent		Zu verwendender Agent
--port		Port zum Abhören
--hostname		Hostname zum Abhören

---

Befehle

Der CodeTutor CLI verfügt außerdem über die folgenden Befehle.

---

agent

Agenten für CodeTutor verwalten.

codetutor agent [command]

---

attach

Schließen Sie ein Terminal an einen bereits laufenden CodeTutor-Backend-Server an, der über die Befehle serve oder web gestartet wurde.

codetutor attach [url]

Dies ermöglicht die Verwendung von TUI mit einem Remote-Backend CodeTutor. Zum Beispiel:

# Start the backend server for web/mobile access
codetutor web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
codetutor attach http://10.20.30.40:4096

Optionen

Flag	Kurz	Beschreibung
--dir		Arbeitsverzeichnis zum Starten von TUI in
--continue	-c	Letzte Sitzung fortsetzen
--session	-s	Session-ID zum Fortfahren
--fork		Sitzung beim Fortsetzen abzweigen (mit --continue oder --session verwenden)
--password	-p	Basic-Auth-Passwort (standardmäßig CODETUTOR_SERVER_PASSWORD)
--username	-u	Basic-Auth-Benutzername (standardmäßig CODETUTOR_SERVER_USERNAME oder codetutor)

---

create

Erstellen Sie einen neuen Agenten mit benutzerdefinierter Konfiguration.

codetutor agent create

Dieser Befehl führt Sie durch die Erstellung eines neuen Agenten mit einer benutzerdefinierten Systemeingabeaufforderung und Toolkonfiguration.

---

list

Listen Sie alle verfügbaren Agenten auf.

codetutor agent list

---

auth

Befehl zum Verwalten von Anmeldeinformationen und Anmelden für Anbieter.

codetutor auth [command]

---

login

CodeTutor wird von der Anbieterliste bei Models.dev unterstützt, sodass Sie codetutor auth login verwenden können, um API-Schlüssel für jeden Anbieter zu konfigurieren, den Sie verwenden möchten. Dies wird in ~/.local/share/opencode/auth.json gespeichert.

codetutor auth login

Wenn CodeTutor startet, lädt es den Anbieter aus der Anmeldeinformationsdatei. Und ob in Ihren Umgebungen Schlüssel sind oder in Ihrem Projekt eine .env-Datei vorhanden ist.

---

list

Listet alle authentifizierten Anbieter auf, wie in der Anmeldeinformationsdatei gespeichert.

codetutor auth list

Oder die Kurzversion.

codetutor auth ls

---

logout

Melden Sie sich von einem Anbieter ab, indem Sie ihn aus der Anmeldeinformationsdatei löschen.

codetutor auth logout

---

github

Verwalten Sie den GitHub-Agenten für die Repository-Automatisierung.

codetutor github [command]

---

install

Installieren Sie den GitHub-Agenten in Ihrem Repository.

codetutor github install

Dadurch wird der erforderliche GitHub-Aktionsworkflow eingerichtet und Sie durch den Konfigurationsprozess geführt. Learn more.

---

run

Führen Sie den GitHub-Agenten aus. Dies wird normalerweise in GitHub-Aktionen verwendet.

codetutor github run

Optionen

Flag	Beschreibung
--event	GitHub Scheinereignis zum Ausführen des Agenten für
--token	GitHub persönliches Zugriffstoken

---

mcp

Verwalten Sie Model Context Protocol-Server.

codetutor mcp [command]

---

add

Fügen Sie Ihrer Konfiguration einen MCP-Server hinzu.

codetutor mcp add

Dieser Befehl führt Sie durch das Hinzufügen eines lokalen oder Remote-MCP-Servers.

---

list

Listen Sie alle konfigurierten MCP-Server und deren Verbindungsstatus auf.

codetutor mcp list

Oder nutzen Sie die Kurzversion.

codetutor mcp ls

---

auth

Authentifizieren Sie sich mit einem OAuth-fähigen MCP-Server.

codetutor mcp auth [name]

Wenn Sie keinen Servernamen angeben, werden Sie aufgefordert, einen der verfügbaren OAuth-fähigen Server auszuwählen.

Sie können auch OAuth-fähige Server und deren Authentifizierungsstatus auflisten.

codetutor mcp auth list

Oder nutzen Sie die Kurzversion.

codetutor mcp auth ls

---

logout

Entfernen Sie OAuth-Anmeldeinformationen für einen MCP-Server.

codetutor mcp logout [name]

---

debug

Beheben Sie OAuth-Verbindungsprobleme für einen MCP-Server.

codetutor mcp debug <name>

---

models

Listen Sie alle verfügbaren Modelle der konfigurierten Anbieter auf.

codetutor models [provider]

Dieser Befehl zeigt alle bei Ihren konfigurierten Anbietern verfügbaren Modelle im Format provider/model an.

Dies ist nützlich, um die genauen Modellnamen herauszufinden, die in Ihrer Konfiguration verwendet werden sollen.

Sie können optional eine Anbieter-ID übergeben, um Modelle nach diesem Anbieter zu filtern.

codetutor models anthropic

Optionen

Flag	Beschreibung
--refresh	Aktualisieren Sie den Modellcache von models.dev
--verbose	Verwenden Sie eine ausführlichere Modellausgabe (einschließlich Metadaten wie Kosten)

Verwenden Sie das Flag --refresh, um die zwischengespeicherte Modellliste zu aktualisieren. Dies ist nützlich, wenn einem Anbieter neue Modelle hinzugefügt wurden und Sie diese in CodeTutor sehen möchten.

codetutor models --refresh

---

run

Führen Sie CodeTutor im nicht interaktiven Modus aus, indem Sie direkt eine Eingabeaufforderung übergeben.

codetutor run [message..]

Dies ist nützlich für die Skripterstellung, die Automatisierung oder wenn Sie eine schnelle Antwort wünschen, ohne das vollständige TUI zu starten. Zum Beispiel:

codetutor run Explain the use of context in Go

Sie können auch eine Verbindung zu einer laufenden codetutor serve-Instanz herstellen, um bei jedem Lauf Kaltstartzeiten für den MCP-Server zu vermeiden:

# Start a headless server in one terminal
codetutor serve

# In another terminal, run commands that attach to it
codetutor run --attach http://localhost:4096 "Explain async/await in JavaScript"

Optionen

Flag	Kurz	Beschreibung
--command		Der auszuführende Befehl, Argumente als Nachricht verwenden
--continue	-c	Setzen Sie die letzte Sitzung fort
--session	-s	Session-ID zum Fortfahren
--fork		Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden)
--share		Teilen Sie die Sitzung
--model	-m	Zu verwendendes Modell in der Form provider/model
--agent		Zu verwendender Agent
--file	-f	Datei(en) zum Anhängen an die Nachricht
--format		Format: default (formatiert) oder json (rohe JSON-Ereignisse)
--title		Titel für die Sitzung (verwendet eine verkürzte Eingabeaufforderung, wenn kein Wert angegeben wird)
--attach		An einen laufenden CodeTutor-Server anschließen (z.B. http://localhost:4096)
--password	-p	Basic-Auth-Passwort (standardmäßig CODETUTOR_SERVER_PASSWORD)
--username	-u	Basic-Auth-Benutzername (standardmäßig CODETUTOR_SERVER_USERNAME oder codetutor)
--dir		Verzeichnis für die Ausführung, oder Pfad auf dem Remote-Server beim Anhängen
--variant		Modellvariante (anbieterspezifischer Reasoning-Aufwand)
--thinking		Denkblöcke anzeigen
--port		Port für den lokalen Server (standardmäßig zufälliger Port)

---

serve

Starten Sie einen Headless-CodeTutor-Server für den API-Zugriff. Sehen Sie sich die Server-Dokumentation für die vollständige HTTP-Schnittstelle an.

codetutor serve

Dadurch wird ein HTTP-Server gestartet, der API-Zugriff auf CodeTutor-Funktionalität ohne die TUI-Schnittstelle bietet. Legen Sie CODETUTOR_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig codetutor).

Optionen

Flag	Beschreibung
--port	Port zum Abhören
--hostname	Hostname zum Abhören
--mdns	mDNS-Discovery aktivieren
--cors	Zusätzliche Browser-Ursprünge für CORS zulassen

---

session

CodeTutor-Sitzungen verwalten.

codetutor session [command]

---

list

Listen Sie alle CodeTutor-Sitzungen auf.

codetutor session list

Optionen

Flag	Kurz	Beschreibung
--max-count	-n	Beschränken auf die N neuesten Sitzungen
--format		Ausgabeformat: table oder json (table)

---

stats

Zeigen Sie Token-Nutzungs- und Kostenstatistiken für Ihre CodeTutor-Sitzungen an.

codetutor stats

Optionen

Flag	Beschreibung
--days	Statistiken für die letzten N Tage anzeigen (alle Zeiten)
--tools	Anzahl der angebotenen Werkzeuge (alle)
--models	Aufschlüsselung der Modellnutzung anzeigen (standardmäßig ausgeblendet). Übergeben Sie eine Zahl, um die obersten N anzuzeigen
--project	Nach Projekt filtern (alle Projekte, leere Zeichenfolge: aktuelles Projekt)

---

export

Sitzungsdaten als JSON exportieren.

codetutor export [sessionID]

Wenn Sie keine Sitzungs-ID angeben, werden Sie aufgefordert, eine der verfügbaren Sitzungen auszuwählen.

---

import

Importieren Sie Sitzungsdaten aus einer JSON-Datei oder einer CodeTutor-Freigabe-URL.

codetutor import <file>

Sie können aus einer lokalen Datei oder einer CodeTutor-Freigabe-URL importieren.

codetutor import session.json
codetutor import https://opncd.ai/s/abc123

---

web

Starten Sie einen Headless-CodeTutor-Server mit einer Weboberfläche.

codetutor web

Dadurch wird ein HTTP-Server gestartet und ein Webbrowser geöffnet, um über eine Webschnittstelle auf CodeTutor zuzugreifen. Legen Sie CODETUTOR_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig codetutor).

Optionen

Flag	Beschreibung
--port	Port zum Abhören
--hostname	Hostname zum Abhören
--mdns	mDNS-Discovery aktivieren
--cors	Zusätzliche Browser-Ursprünge für CORS zulassen

---

acp

Starten Sie einen ACP (Agent Client Protocol) Server.

codetutor acp

Dieser Befehl startet einen ACP-Server, der über stdin/stdout unter Verwendung von nd-JSON kommuniziert.

Optionen

Flag	Beschreibung
--cwd	Arbeitsverzeichnis
--port	Port zum Abhören
--hostname	Hostname zum Abhören

---

uninstall

Deinstallieren Sie CodeTutor und entfernen Sie alle zugehörigen Dateien.

codetutor uninstall

Optionen

Flag	Kurz	Beschreibung
--keep-config	-c	Konfigurationsdateien behalten
--keep-data	-d	Sitzungsdaten und Snapshots aufbewahren
--dry-run		Zeigt, was entfernt werden würde, ohne zu entfernen
--force	-f	Bestätigungsaufforderungen überspringen

---

upgrade

Aktualisiert CodeTutor auf die neueste Version oder eine bestimmte Version.

codetutor upgrade [target]

Um auf die neueste Version zu aktualisieren:

codetutor upgrade

Um auf eine bestimmte Version zu aktualisieren.

codetutor upgrade v0.1.48

Optionen

Flag	Kurz	Beschreibung
--method	-m	Die zu verwendende Installationsmethode; curl, npm, pnpm, bun, brew

---

Globale Flags

Der CodeTutor CLI akzeptiert die folgenden globalen Flags.

Flag	Kurz	Beschreibung
--help	-h	Hilfe anzeigen
--version	-v	Versionsnummer drucken
--print-logs		Protokolle nach stderr drucken
--log-level		Protokollebene (DEBUG, INFO, WARN, ERROR)

---

Umgebungsvariablen

CodeTutor kann mithilfe von Umgebungsvariablen konfiguriert werden.

Variable	Typ	Beschreibung
CODETUTOR_AUTO_SHARE	boolescher Wert	Sitzungen automatisch teilen
CODETUTOR_GIT_BASH_PATH	Zeichenfolge	Pfad zur ausführbaren Git Bash-Datei unter Windows
CODETUTOR_CONFIG	Zeichenfolge	Pfad zur Konfigurationsdatei
CODETUTOR_CONFIG_DIR	Zeichenfolge	Pfad zum Konfigurationsverzeichnis
CODETUTOR_CONFIG_CONTENT	Zeichenfolge	Inline-JSON-Konfigurationsinhalt
CODETUTOR_DISABLE_AUTOUPDATE	boolescher Wert	Automatische Update-Prüfungen deaktivieren
CODETUTOR_DISABLE_PRUNE	boolescher Wert	Bereinigung alter Daten deaktivieren
CODETUTOR_DISABLE_TERMINAL_TITLE	boolescher Wert	Deaktivieren Sie die automatische Aktualisierung von Terminaltiteln
CODETUTOR_PERMISSION	Zeichenfolge	Inline-JSON-Berechtigungskonfiguration
CODETUTOR_DISABLE_DEFAULT_PLUGINS	boolescher Wert	Standard-Plugins deaktivieren
CODETUTOR_DISABLE_LSP_DOWNLOAD	boolescher Wert	Automatische LSP-Server-Downloads deaktivieren
CODETUTOR_ENABLE_EXPERIMENTAL_MODELS	boolescher Wert	Experimentelle Modelle aktivieren
CODETUTOR_DISABLE_AUTOCOMPACT	boolescher Wert	Automatische Kontextkomprimierung deaktivieren
CODETUTOR_DISABLE_CLAUDE_CODE	boolescher Wert	Deaktivieren Sie das Lesen von .claude (Prompt + Skills)
CODETUTOR_DISABLE_CLAUDE_CODE_PROMPT	boolescher Wert	Deaktivieren Sie das Lesen von ~/.claude/CLAUDE.md
CODETUTOR_DISABLE_CLAUDE_CODE_SKILLS	boolescher Wert	Deaktivieren Sie das Laden von .claude/skills
CODETUTOR_DISABLE_MODELS_FETCH	boolescher Wert	Deaktivieren Sie das Abrufen von Modellen aus Remote-Quellen
CODETUTOR_FAKE_VCS	Zeichenfolge	Gefälschter VCS-Anbieter zu Testzwecken
CODETUTOR_CLIENT	Zeichenfolge	Client-ID (standardmäßig cli)
CODETUTOR_ENABLE_EXA	boolescher Wert	Exa-Websuchtools aktivieren
CODETUTOR_SERVER_PASSWORD	Zeichenfolge	Aktivieren Sie die Basisauthentifizierung für serve/web
CODETUTOR_SERVER_USERNAME	Zeichenfolge	Benutzernamen für die Basisauthentifizierung überschreiben (Standard codetutor)
CODETUTOR_MODELS_URL	Zeichenfolge	Benutzerdefinierte URL zum Abrufen der Modellkonfiguration

---

Experimentell

Diese Umgebungsvariablen ermöglichen experimentelle Funktionen, die sich ändern oder entfernt werden können.

Variable	Typ	Beschreibung
CODETUTOR_EXPERIMENTAL	boolescher Wert	Experimentelle Funktionen unter dem Sammelflag aktivieren
CODETUTOR_EXPERIMENTAL_ICON_DISCOVERY	boolescher Wert	Symbolerkennung aktivieren
CODETUTOR_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	boolescher Wert	Kopieren bei Auswahl in TUI deaktivieren
CODETUTOR_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	Zahl	Standard-Timeout für Bash-Befehle in ms
CODETUTOR_EXPERIMENTAL_OUTPUT_TOKEN_MAX	Zahl	Maximale Ausgabetokens für LLM-Antworten
CODETUTOR_EXPERIMENTAL_FILEWATCHER	boolescher Wert	Dateiüberwachung für das gesamte Verzeichnis aktivieren
CODETUTOR_EXPERIMENTAL_OXFMT	boolescher Wert	Oxfmt-Formatierer aktivieren
CODETUTOR_EXPERIMENTAL_LSP_TOOL	boolescher Wert	Experimentelles LSP-Tool aktivieren
CODETUTOR_EXPERIMENTAL_DISABLE_FILEWATCHER	boolescher Wert	Dateiüberwachung deaktivieren
CODETUTOR_EXPERIMENTAL_EXA	boolescher Wert	Experimentelle Exa-Funktionen aktivieren
CODETUTOR_EXPERIMENTAL_LSP_TY	boolescher Wert	TY LSP für Python-Dateien aktivieren
CODETUTOR_EXPERIMENTAL_PLAN_MODE	boolescher Wert	Planmodus aktivieren
CODETUTOR_EXPERIMENTAL_BACKGROUND_SUBAGENTS	boolescher Wert	Hintergrundaufgaben für Subagenten aktivieren
CODETUTOR_EXPERIMENTAL_EVENT_SYSTEM	boolescher Wert	Experimentelles Ereignissystem aktivieren
CODETUTOR_EXPERIMENTAL_NATIVE_LLM	boolescher Wert	Nativen LLM-Anfragepfad aktivieren
CODETUTOR_EXPERIMENTAL_PARALLEL	boolescher Wert	Parallele Websuche aktivieren
CODETUTOR_EXPERIMENTAL_SCOUT	boolescher Wert	Scout-Subagent aktivieren
CODETUTOR_EXPERIMENTAL_WORKSPACES	boolescher Wert	Workspace-Unterstützung aktivieren