TUI

Korzystanie z interfejsu użytkownika terminala opencode.

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

Uruchomienie opencode uruchamia TUI dla bieżącego katalogu.

opencode

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

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.

Referencje plików

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.

Polecenia Bash

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

!ls -la

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

Komendy

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

/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:

connect

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

/connect

compact

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

/compact

Keybind: ctrl+x c

details

Przełącz szczegóły wykonywania narzędzi.

/details

Keybind: ctrl+x d

editor

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

/editor

Keybind: ctrl+x e

exit

Zamknij opencode. Aliasy: /quit, /q

/exit

Keybind: ctrl+x q

export

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.

/export

Keybind: ctrl+x x

help

Pokaż okno pomocy.

/help

Keybind: ctrl+x h

init

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

/init

Keybind: ctrl+x i

models

Lista dostępnych modeli.

/models

Keybind: ctrl+x m

new

Rozpocznij nową sesję. Alias: /clear

/new

Keybind: ctrl+x n

redo

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**.

/redo

Keybind: ctrl+x r

sessions

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

/sessions

Keybind: ctrl+x l

Udostępnij bieżącą sesję. Dowiedz się więcej.

/share

Keybind: ctrl+x s

themes

Lista dostępnych motywów.

/theme

Keybind: ctrl+x t

thinking

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.

/thinking

undo

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**.

/undo

Keybind: ctrl+x u

unshare

Anuluj udostępnianie bieżącej sesji. Dowiedz się więcej.

/unshare

Konfiguracja edytora

Zarówno polecenia /editor, jak i /export korzystają z edytora określonego w zmiennej środowiskowej 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"

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

set EDITOR=notepad

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

Aby ustawić tę opcję na stałe, użyj opcji Właściwości systemu > Środowisko Variables.

$env:EDITOR = "notepad"

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

Aby uczynić to trwałym, dodaj to do swojego profilu PowerShell.

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.

Skonfiguruj

Możesz dostosować zachowanie TUI za pomocą pliku konfiguracyjnego opencode.

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

Options

scroll_acceleration — 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: 1). Wartość domyślna to 3. Uwaga: jest to ignorowane, jeśli scroll_acceleration.enabled jest ustawione na true.

Personalizacja

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