TUI

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.

Tipp

Du kannst @ in Nachrichten fuer Datei-Referenzen verwenden.

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

Der Dateiinhalt wird automatisch zur Unterhaltung hinzugefuegt.

---

Bash commands

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

!ls -la

Die Ausgabe landet als Tool-Ergebnis in der Unterhaltung.

---

Commands

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

Add a provider to OpenCode. Allows you to select from available providers and add their API keys.

/connect

---

compact

Compact the current session. Alias: /summarize

/compact

Keybind: ctrl+x c

---

details

Toggle tool execution details.

/details

Keybind: ctrl+x d

---

editor

Open external editor for composing messages. Uses the editor set in your EDITOR environment variable. Learn more.

/editor

Keybind: ctrl+x e

---

exit

Exit OpenCode. Aliases: /quit, /q

/exit

Keybind: ctrl+x q

---

export

Export current conversation to Markdown and open in your default editor. Uses the editor set in your EDITOR environment variable. Learn more.

/export

Keybind: ctrl+x x

---

help

Show the help dialog.

/help

Keybind: ctrl+x h

---

init

Create or update AGENTS.md file. Learn more.

/init

Keybind: ctrl+x i

---

models

List available models.

/models

Keybind: ctrl+x m

---

new

Start a new session. Alias: /clear

/new

Keybind: ctrl+x n

---

redo

Redo a previously undone message. Only available after using /undo.

Tipp

Any file changes will also be restored.

Internally, this uses Git to manage the file changes. So your project needs to be a Git repository.

/redo

Keybind: ctrl+x r

---

sessions

List and switch between sessions. Aliases: /resume, /continue

/sessions

Keybind: ctrl+x l

---

share

Share current session. Learn more.

/share

Keybind: ctrl+x s

---

themes

List available themes.

/theme

Keybind: ctrl+x t

---

thinking

Toggle the visibility of thinking/reasoning blocks in the conversation. When enabled, you can see the model’s reasoning process for models that support extended thinking.

Hinweis

This command only controls whether thinking blocks are displayed - it does not enable or disable the model’s reasoning capabilities. To toggle actual reasoning capabilities, use ctrl+t to cycle through model variants.

/thinking

---

undo

Undo last message in the conversation. Removes the most recent user message, all subsequent responses, and any file changes.

Tipp

Any file changes made will also be reverted.

Internally, this uses Git to manage the file changes. So your project needs to be a Git repository.

/undo

Keybind: ctrl+x u

---

unshare

Unshare current session. Learn more.

/unshare

---

Editor setup

Both the /editor and /export commands use the editor specified in your EDITOR environment variable.

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"

To make it permanent, add this to your shell profile; ~/.bashrc, ~/.zshrc, etc.

Windows (CMD)

set EDITOR=notepad

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

To make it permanent, use System Properties > Environment Variables.

Windows (PowerShell)

$env:EDITOR = "notepad"

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

To make it permanent, add this to your PowerShell profile.

Popular editor options include:

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

Hinweis

Some editors like VS Code need to be started with the --wait flag.

Some editors need command-line arguments to run in blocking mode. The --wait flag makes the editor process block until closed.

---

Configure

You can customize TUI behavior through your OpenCode config file.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

Options

• scroll_acceleration - Enable macOS-style scroll acceleration for smooth, natural scrolling. When enabled, scroll speed increases with rapid scrolling gestures and stays precise for slower movements. This setting takes precedence over scroll_speed and overrides it when enabled.
• scroll_speed - Controls how fast the TUI scrolls when using scroll commands (minimum: 1). Defaults to 3. Note: This is ignored if scroll_acceleration.enabled is set to true.

---

Customization

You can customize various aspects of the TUI view using the command palette (ctrl+x h or /help). These settings persist across restarts.

---

Username display

Toggle whether your username appears in chat messages. Access this through:

• Command palette: Search for “username” or “hide username”
• The setting persists automatically and will be remembered across TUI sessions