Deutsch
Dokumentation
TUI

TUI

Verwendung der OpenCode Terminal-Benutzeroberfläche.

OpenCode bietet eine interaktive Terminal-Oberfläche oder TUI für die Arbeit an Ihren Projekten mit einem LLM.

Das Ausführen von OpenCode startet die TUI für das aktuelle Verzeichnis.

opencode

Oder Sie können sie für ein bestimmtes Arbeitsverzeichnis starten.

opencode /path/to/project

Sobald Sie in der TUI sind, können Sie eine Nachricht eingeben.

Give me a quick summary of the codebase.

Dateireferenzen

Sie können Dateien in Ihren Nachrichten mit @ referenzieren. Dies führt eine Fuzzy-Dateisuche im aktuellen Arbeitsverzeichnis durch.

Tipp: Sie können auch @ verwenden, um Dateien in Ihren Nachrichten zu referenzieren.

How is auth handled in @packages/functions/src/api/index.ts?

Der Inhalt der Datei wird automatisch zur Konversation hinzugefügt.


Bash-Befehle

Beginnen Sie eine Nachricht mit !, um einen Shell-Befehl auszuführen.

!ls -la

Die Ausgabe des Befehls wird als Tool-Ergebnis zur Konversation hinzugefügt.


Befehle

Bei der Verwendung der OpenCode TUI können Sie / gefolgt von einem Befehlsnamen eingeben, um Aktionen schnell auszuführen. Zum Beispiel:

/help

Die meisten Befehle haben auch Tastenkürzel mit ctrl+x als Leader-Taste, wobei ctrl+x die Standard-Leader-Taste ist. Mehr erfahren.

Hier sind alle verfügbaren Slash-Befehle:


connect

Fügen Sie einen Anbieter zu OpenCode hinzu. Ermöglicht die Auswahl aus verfügbaren Anbietern und das Hinzufügen ihrer API-Schlüssel.

/connect

compact

Komprimiert die aktuelle Sitzung. Alias: /summarize

/compact

Tastenkürzel: ctrl+x c


details

Schaltet die Anzeige von Tool-Ausführungsdetails um.

/details

Tastenkürzel: ctrl+x d


editor

Öffnet einen externen Editor zum Verfassen von Nachrichten. Verwendet den in Ihrer EDITOR-Umgebungsvariable festgelegten Editor. Mehr erfahren.

/editor

Tastenkürzel: ctrl+x e


exit

Beendet OpenCode. Aliase: /quit, /q

/exit

Tastenkürzel: ctrl+x q


export

Exportiert die aktuelle Konversation nach Markdown und öffnet sie in Ihrem Standard-Editor. Verwendet den in Ihrer EDITOR-Umgebungsvariable festgelegten Editor. Mehr erfahren.

/export

Tastenkürzel: ctrl+x x


help

Zeigt den Hilfe-Dialog an.

/help

Tastenkürzel: ctrl+x h


init

Erstellt oder aktualisiert die AGENTS.md-Datei. Mehr erfahren.

/init

Tastenkürzel: ctrl+x i


models

Listet verfügbare Modelle auf.

/models

Tastenkürzel: ctrl+x m


new

Startet eine neue Sitzung. Alias: /clear

/new

Tastenkürzel: ctrl+x n


redo

Stellt eine zuvor rückgängig gemachte Nachricht wieder her. Nur verfügbar nach Verwendung von /undo.

Tipp: Alle Dateiänderungen werden ebenfalls wiederhergestellt.

Intern wird Git verwendet, um die Dateiänderungen zu verwalten. Daher muss Ihr Projekt ein Git-Repository sein.

/redo

Tastenkürzel: ctrl+x r


sessions

Listet Sitzungen auf und wechselt zwischen ihnen. Aliase: /resume, /continue

/sessions

Tastenkürzel: ctrl+x l


share

Teilt die aktuelle Sitzung. Mehr erfahren.

/share

Tastenkürzel: ctrl+x s


themes

Listet verfügbare Themes auf.

/themes

Tastenkürzel: ctrl+x t


thinking

Schaltet die Sichtbarkeit von Denk-/Reasoning-Blöcken in der Konversation um. Wenn aktiviert, können Sie den Reasoning-Prozess für Modelle sehen, die erweitertes Denken unterstützen.

Hinweis: Dieser Befehl steuert nur, ob Denk-Blöcke angezeigt werden - er aktiviert oder deaktiviert nicht die Reasoning-Fähigkeiten des Modells. Um die tatsächlichen Reasoning-Fähigkeiten umzuschalten, verwenden Sie ctrl+t, um durch Modellvarianten zu wechseln.

/thinking

undo

Macht die letzte Nachricht in der Konversation rückgängig. Entfernt die neueste Benutzernachricht, alle nachfolgenden Antworten und alle Dateiänderungen.

Tipp: Alle vorgenommenen Dateiänderungen werden ebenfalls rückgängig gemacht.

Intern wird Git verwendet, um die Dateiänderungen zu verwalten. Daher muss Ihr Projekt ein Git-Repository sein.

/undo

Tastenkürzel: ctrl+x u


unshare

Hebt die Freigabe der aktuellen Sitzung auf. Mehr erfahren.

/unshare

Editor-Einrichtung

Sowohl der /editor- als auch der /export-Befehl verwenden den in Ihrer EDITOR-Umgebungsvariable angegebenen Editor.

Linux/macOS

# Example for nano or vim
export EDITOR=nano
export EDITOR=vim
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

Um dies dauerhaft zu machen, fügen Sie es zu Ihrem Shell-Profil hinzu; ~/.bashrc, ~/.zshrc, etc.

Windows (CMD)

set EDITOR=notepad
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --wait

Um dies dauerhaft zu machen, verwenden Sie Systemeigenschaften > Umgebungsvariablen.

Windows (PowerShell)

$env:EDITOR = "notepad"
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"

Um dies dauerhaft zu machen, fügen Sie es zu Ihrem PowerShell-Profil hinzu.

Beliebte Editor-Optionen

Beliebte Editor-Optionen sind:

  • code - Visual Studio Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Neovim-Editor
  • vim - Vim-Editor
  • nano - Nano-Editor
  • notepad - Windows Notepad
  • subl - Sublime Text

Hinweis: Einige Editoren wie VS Code müssen mit dem --wait-Flag gestartet werden.

Einige Editoren benötigen Kommandozeilenargumente, um im Blocking-Modus zu laufen. Das --wait-Flag lässt den Editor-Prozess blockieren, bis er geschlossen wird.


Konfiguration

Sie können das TUI-Verhalten über Ihre OpenCode-Konfigurationsdatei anpassen.

opencode.json

Optionen

  • scroll_acceleration - Aktiviert macOS-ähnliche Scroll-Beschleunigung für flüssiges, natürliches Scrollen. Wenn aktiviert, erhöht sich die Scroll-Geschwindigkeit bei schnellen Scroll-Gesten und bleibt präzise bei langsameren Bewegungen. Diese Einstellung hat Vorrang vor scroll_speed und überschreibt sie, wenn aktiviert.
  • scroll_speed - Steuert, wie schnell die TUI scrollt, wenn Scroll-Befehle verwendet werden (Minimum: 1). Standard ist 3. Hinweis: Dies wird ignoriert, wenn scroll_acceleration.enabled auf true gesetzt ist.

Anpassung

Sie können verschiedene Aspekte der TUI-Ansicht über die Befehlspalette (ctrl+x h oder /help) anpassen. Diese Einstellungen bleiben über Neustarts hinweg erhalten.


Benutzernamen-Anzeige

Schalten Sie um, ob Ihr Benutzername in Chat-Nachrichten erscheint. Zugriff über:

  • Befehlspalette: Suchen Sie nach "username" oder "hide username"
  • Die Einstellung wird automatisch gespeichert und über TUI-Sitzungen hinweg beibehalten