Przejdź do treści
Dokumentacja V1
Referencje plików

TUI

opencode zapewnia interaktywny interfejs terminala lub TUI do pracy nad projektami za pomocą LLM.

Uruchomienie opencode uruchamia TUI dla bieżącego katalogu.

Terminal
opencode

Możesz też uruchomić go dla określonego katalogu roboczego.

Terminal
opencode /path/to/project

Gdy znajdziesz się w TUI, możesz wyświetlić monit za pomocą komunikatu.

Give me a quick summary of the codebase.

Możesz odwoływać się do plików w swoich wiadomościach, używając @. Spowoduje to rozmyte wyszukiwanie plików w bieżącym katalogu roboczym.

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

Zawartość pliku jest automatycznie dodawana do rozmowy.


Rozpocznij wiadomość od !, aby uruchomić polecenie shell.

Terminal
!ls -la

Dane wyjściowe polecenia są dodawane do konwersacji jako wynik narzędzia.


Korzystając z TUI opencode, możesz wpisać /, po którym następuje nazwa polecenia, aby szybko wykonać działania. Na przykład:

Terminal
/help

Większość poleceń ma również skrót klawiszowy wykorzystujący ctrl+x jako klucz wiodący, gdzie ctrl+x jest domyślnym klawiszem wiodącym. Dowiedz się więcej.

Oto wszystkie dostępne slash commands:


Dodaj dostawcę do opencode. Umożliwia wybór dostępnych dostawców i dodanie ich kluczy API.

Terminal
/connect

Kompaktuj bieżącą sesję. Alias: /summarize

Terminal
/compact

Keybind: ctrl+x c


Otwórz zewnętrzny edytor do tworzenia wiadomości. Używa edytora ustawionego w zmiennej środowiskowej EDITOR. Dowiedz się więcej.

Terminal
/editor

Keybind: ctrl+x e


Zamknij opencode. Aliasy: /quit, /q

Terminal
/exit

Keybind: ctrl+x q


Wyeksportuj bieżącą rozmowę do Markdown i otwórz ją w domyślnym edytorze. Używa edytora ustawionego w zmiennej środowiskowej EDITOR. Dowiedz się więcej.

Terminal
/export

Keybind: ctrl+x x


Pokaż okno pomocy.

Terminal
/help

Keybind: ctrl+x h


Utwórz lub zaktualizuj plik AGENTS.md. Dowiedz się więcej.

Terminal
/init

Keybind: ctrl+x i


Lista dostępnych modeli.

Terminal
/models

Keybind: ctrl+x m


Rozpocznij nową sesję. Alias: /clear

Terminal
/new

Keybind: ctrl+x n


Ponów cofniętą wcześniej wiadomość. Dostępne tylko po użyciu /undo.

Wewnętrznie używa Git do zarządzania zmianami plików. Więc Twój projekt ** musi be a Git repository**.

Terminal
/redo

Keybind: ctrl+x r


Wyświetl listę i przełączaj się między sesjami. Aliasy: /resume, /continue

Terminal
/sessions

Keybind: ctrl+x l


Lista dostępnych motywów.

Terminal
/theme

Keybind: ctrl+x t


Przełącz widoczność bloków myślenia/rozumowania w rozmowie. Po włączeniu tej opcji można zobaczyć proces wnioskowania modelu w przypadku modeli obsługujących myślenie rozszerzone.

Terminal
/thinking

Cofnij ostatnią wiadomość w rozmowie. Usuwa najnowszą wiadomość użytkownika, wszystkie kolejne odpowiedzi i wszelkie zmiany w plikach.

Wewnętrznie używa Git do zarządzania zmianami plików. Więc Twój projekt ** musi be a Git repository**.

Terminal
/undo

Keybind: ctrl+x u


Zarówno polecenia /editor, jak i /export korzystają z edytora określonego w zmiennej środowiskowej EDITOR.

Terminal
# 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"

Aby było to trwałe, dodaj to do swojego profilu shell; ~/.bashrc, ~/.zshrc, etc.

Popularne opcje edytora:

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

Niektórzy edytory potrzebują argumentów wiersza poleceń, aby działać w trybie blokowania. Flaga --wait blokuje proces edytora aż do jego zamknięcia.


Możesz dostosować zachowanie TUI za pomocą pliku tui.json (lub tui.jsonc).

tui.json
{
  "$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"
    }
  }
}

Jest to oddzielny plik od opencode.json, który konfiguruje zachowanie serwera/runtime.

keybinds jest łączone z wbudowanymi wartościami domyślnymi, więc wystarczy skonfigurować tylko te skróty, które chcesz zmienić.

  • theme - Ustawia motyw interfejsu. Dowiedz się więcej.
  • keybinds - Dostosowuje skróty klawiszowe. Dowiedz się więcej.
  • leader_timeout - Określa, jak długo OpenCode czeka po naciśnięciu leader key. Domyślnie 2000.
  • scroll_acceleration.enabled — Włącz przyspieszenie przewijania w stylu macOS, aby zapewnić płynne, naturalne przewijanie. Po włączeniu prędkość przewijania wzrasta wraz z szybkimi gestami przewijania i pozostaje precyzyjna w przypadku wolniejszych ruchów. To ustawienie ma pierwszeństwo przed scroll_speed i zastępuje je, gdy jest włączone.
  • scroll_speed - Kontroluje szybkość przewijania TUI podczas korzystania z poleceń przewijania (minimum: 0.001, obsługuje wartości dziesiętne). Wartość domyślna to 3. Uwaga: jest to ignorowane, jeśli scroll_acceleration.enabled jest ustawione na true.
  • diff_style - Steruje renderowaniem różnic. "auto" dostosowuje się do szerokości terminala, "stacked" zawsze pokazuje układ jednokolumnowy.
  • mouse - Włącza lub wyłącza przechwytywanie myszy w TUI (domyślnie true). Po wyłączeniu zachowane zostaje natywne zachowanie terminala przy zaznaczaniu i przewijaniu myszą.
  • attention - Konfiguruje powiadomienia pulpitu i dźwięki TUI. Domyślnie wyłączone.

Użyj OPENCODE_TUI_CONFIG, aby załadować niestandardową ścieżkę konfiguracji TUI.

Attention pozwala TUI powiadomić Cię, gdy OpenCode czeka na odpowiedź, wymaga zatwierdzenia uprawnienia, zgłasza błąd sesji albo informuje o zakończeniu sesji. Włącz tę funkcję za pomocą attention.enabled; wbudowane zdarzenia odtwarzają dźwięk, gdy wystąpią. Powiadomienia pulpitu są wysyłane tylko wtedy, gdy okno terminala nie jest aktywne, i nie są używane dla zdarzeń subagent.

  • enabled - Włącza wszystkie powiadomienia i dźwięki Attention. Domyślnie false.
  • notifications - Gdy Attention jest włączone, pozwala TUI wysyłać powiadomienia pulpitu przez terminal. Domyślnie true.
  • sound - Gdy Attention jest włączone, pozwala odtwarzać dźwięki powiadomień. Domyślnie true.
  • volume - Domyślna głośność dźwięków powiadomień od 0 do 1. Domyślnie 0.4.
  • sound_pack - ID sound pack do użycia. Domyślnie opencode.default.
  • sounds - Ustawia niestandardowe pliki dźwiękowe dla default, question, permission, error, done lub subagent_done. Ścieżki mogą być bezwzględne, być URL-ami file:// albo być względne względem tui.json.

Za pomocą palety poleceń (ctrl+x h lub /help) można dostosować różne aspekty widoku TUI. Te ustawienia są zachowywane po ponownym uruchomieniu.


Wyświetlanie nazwy użytkownika

Włącz lub wyłącz wyświetlanie Twojej nazwy użytkownika w wiadomościach na czacie. Dostęp do tego poprzez:

  • Paleta poleceń: Wyszukaj „nazwę użytkownika” lub „ukryj nazwę użytkownika”
  • Ustawienie zostanie zapamiętane automatycznie i będzie pamiętane podczas sesji TUI