TUI

Arbeite mit OpenCode in der Terminal-Oberflaeche.

OpenCode bietet eine interaktive Terminaloberflaeche (TUI), um mit einem LLM an deinen Projekten zu arbeiten.

Ohne weitere Argumente startet OpenCode die TUI im aktuellen Verzeichnis.

opencode

Oder du startest sie fuer ein bestimmtes Arbeitsverzeichnis.

opencode /path/to/project

In der TUI kannst du direkt mit einer Nachricht prompten.

Give me a quick summary of the codebase.

Datei-Referenzen

Mit @ kannst du Dateien in Nachrichten referenzieren. Dabei wird im aktuellen Verzeichnis eine unscharfe Dateisuche genutzt.

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

Der Dateiinhalt wird automatisch zur Unterhaltung hinzugefuegt.

Bash-Befehle

Beginne eine Nachricht mit !, um einen Shell-Befehl auszufuehren.

!ls -la

Die Ausgabe landet als Tool-Ergebnis in der Unterhaltung.

Befehle

In der OpenCode-TUI kannst du / plus Befehlsnamen eingeben, um Aktionen schnell auszufuehren. Zum Beispiel:

/help

Viele Befehle haben auch Tastenkombinationen mit ctrl+x als Leader-Key. Mehr dazu.

Hier sind alle verfuegbaren Slash-Commands:

connect

Fuegt einen Provider zu OpenCode hinzu. Erlaubt die Auswahl aus verfuegbaren Providern und das Hinzufuegen ihrer API-Keys.

/connect

thinking

Schaltet die Sichtbarkeit von Thinking/Reasoning-Bloecken in der Unterhaltung um. Wenn aktiviert, kannst du den Denkprozess des Modells sehen (bei Modellen, die das unterstuetzen).

/thinking

unshare

Hebt das Teilen der aktuellen Session auf. Mehr dazu.

/unshare

Editor-Einrichtung

Sowohl /editor als auch /export nutzen den in deiner EDITOR-Umgebungsvariable spezifizierten Editor.

# 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 es dauerhaft zu machen, fuege dies zu deinem Shell-Profil hinzu; ~/.bashrc, ~/.zshrc, etc.

set EDITOR=notepad

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

Um es dauerhaft zu machen, nutze Systemeigenschaften > Umgebungsvariablen.

$env:EDITOR = "notepad"

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

Um es dauerhaft zu machen, fuege dies zu deinem PowerShell-Profil hinzu.

Beliebte Editoren sind:

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

Einige Editoren benoetigen Befehlszeilenargumente, um im blockierenden Modus zu laufen. Das --wait-Flag sorgt dafuer, dass der Editor-Prozess blockiert, bis er geschlossen wird.

Konfiguration

Du kannst das Verhalten der TUI ueber die Datei tui.json (oder tui.jsonc) anpassen.

{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "opencode",
  "leader_timeout": 2000,
  "keybinds": {
    "leader": "ctrl+x",
    "command_list": "ctrl+p"
  },
  "scroll_speed": 3,
  "scroll_acceleration": {
    "enabled": false
  },
  "diff_style": "auto",
  "mouse": true,
  "attention": {
    "enabled": true,
    "notifications": true,
    "sound": true,
    "volume": 0.4,
    "sound_pack": "opencode.default",
    "sounds": {
      "error": "./sounds/error.mp3"
    }
  }
}

Dies ist getrennt von opencode.json, welche das Server-/Runtime-Verhalten konfiguriert.

keybinds wird mit den integrierten Standardwerten zusammengeführt, daher musst du nur die Tastenkombinationen konfigurieren, die du ändern möchtest.

Optionen

theme - Setzt dein UI-Theme. Mehr dazu.
keybinds - Passt Tastenkombinationen an. Mehr dazu.
leader_timeout - Steuert, wie lange OpenCode nach der leader key wartet. Standard ist 2000.
scroll_acceleration.enabled - Aktiviert Scroll-Beschleunigung im macOS-Stil fuer weiches, natuerliches Scrollen. Wenn aktiviert, erhoeht sich die Scroll-Geschwindigkeit bei schnellen Gesten und bleibt praezise bei langsamen Bewegungen. Diese Einstellung hat Vorrang vor scroll_speed und ueberschreibt es, wenn aktiviert.
scroll_speed - Steuert, wie schnell die TUI scrollt (Minimum: 0.001, unterstuetzt Dezimalwerte). Standard ist 3. Hinweis: Wird ignoriert, wenn scroll_acceleration.enabled auf true gesetzt ist.
diff_style - Steuert die Diff-Darstellung. "auto" passt sich der Terminalbreite an, "stacked" zeigt immer ein einspaltiges Layout.
mouse - Aktiviert oder deaktiviert die Mauserfassung im TUI (Standard: true). Wenn deaktiviert, bleibt das native Mausauswahl- und Scrollverhalten des Terminals erhalten.
attention - Konfiguriert Desktop-Benachrichtigungen und Sounds des TUI. Standardmäßig deaktiviert.

Verwende OPENCODE_TUI_CONFIG, um einen benutzerdefinierten TUI-Konfigurationspfad zu laden.

Attention lässt das TUI dich benachrichtigen, wenn OpenCode auf eine Antwort wartet, eine Berechtigung bestätigt werden muss, ein Sitzungsfehler aufgetreten ist oder eine Sitzung abgeschlossen wurde. Aktiviere es mit attention.enabled; integrierte Ereignisse spielen beim Auftreten einen Sound ab. Desktop-Benachrichtigungen werden nur gesendet, wenn das Terminalfenster nicht fokussiert ist, und nicht für subagent-Ereignisse verwendet.

enabled - Aktiviert alle Benachrichtigungen und Sounds von Attention. Standard ist false.
notifications - Erlaubt dem TUI bei aktiviertem Attention, Desktop-Benachrichtigungen über das Terminal zu senden. Standard ist true.
sound - Erlaubt bei aktiviertem Attention das Abspielen von Hinweistönen. Standard ist true.
volume - Standardlautstärke der Hinweistöne von 0 bis 1. Standard ist 0.4.
sound_pack - Zu verwendende sound pack ID. Standard ist opencode.default.
sounds - Legt eigene Sounddateien für default, question, permission, error, done oder subagent_done fest. Pfade können absolut, file:// URLs oder relativ zu tui.json sein.

Anpassung

Du kannst verschiedene Aspekte der TUI-Ansicht ueber die Befehlspalette (ctrl+x h oder /help) anpassen. Diese Einstellungen bleiben ueber Neustarts hinweg erhalten.

Benutzername-Anzeige

Schaltet um, ob dein Benutzername in Chat-Nachrichten erscheint. Zugriff hierueber:

Befehlspalette: Suche nach “username” oder “hide username”
Die Einstellung wird automatisch gespeichert und bleibt ueber TUI-Sessions hinweg erhalten.

TUI

Datei-Referenzen

Bash-Befehle

Befehle

connect

compact

details

editor

exit

export

help

init

models

new

redo

sessions

themes