TUI

Bruke opencode-terminalbrukergrensesnittet.

OpenCode gir et interaktivt terminalgrensesnitt (TUI) for å jobbe med prosjektene dine med en LLM.

Å kjøre OpenCode starter TUI for gjeldende katalog.

opencode

Eller du kan starte den for en spesifikk arbeidskatalog.

opencode /path/to/project

Når du er i TUI, kan du stille den spørsmål med en prompt.

Give me a quick summary of the codebase.

Filreferanser

Du kan referere til filer i meldingene dine ved å bruke @. Dette gjør et fuzzy-filsøk i gjeldende arbeidskatalog.

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

Innholdet i filen legges automatisk til samtalen.

Bash-kommandoer

Start en melding med ! for å kjøre en skallkommando.

!ls -la

Utdataene fra kommandoen legges til samtalen som et verktøyresultat.

Kommandoer

Når du bruker OpenCode TUI, kan du skrive / etterfulgt av et kommandonavn for raskt å utføre handlinger. For eksempel:

/help

De fleste kommandoer har også tastebinding som bruker ctrl+x som leader-tast, der ctrl+x er standard leader-tast. Finn ut mer.

Her er alle tilgjengelige slash-kommandoer:

connect

Legg til en leverandør til OpenCode. Lar deg velge fra tilgjengelige leverandører og legge til deres API-nøkler.

/connect

thinking

Veksle mellom synligheten av tenke-/resonneringsblokker i samtalen. Når den er aktivert, kan du se modellens resonneringsprosess for modeller som støtter utvidet tenkning.

/thinking

unshare

Opphev deling av gjeldende økt. Finn ut mer.

/unshare

Oppsett av editor

Både kommandoene /editor og /export bruker editoren som er spesifisert i miljøvariabelen 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"

For å gjøre det permanent, legg dette til i shell-profilen din; ~/.bashrc, ~/.zshrc osv.

set EDITOR=notepad

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

For å gjøre det permanent, bruk Systemegenskaper > Miljø Variabler.

$env:EDITOR = "notepad"

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

For å gjøre det permanent, legg dette til i PowerShell-profilen din.

Populære editor-alternativer inkluderer:

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

Noen editorer trenger kommandolinjeargumenter for å kjøre i blokkeringsmodus. --wait-flagget gjør at editor-prosessen blokkeres til den lukkes.

Konfigurasjon

Du kan tilpasse TUI-oppførselen gjennom tui.json (eller tui.jsonc).

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

Dette er atskilt fra opencode.json, som konfigurerer server-/kjøretidsoppførsel.

keybinds slås sammen med de innebygde standardverdiene, så du trenger bare å konfigurere snarveiene du vil endre.

Alternativer

theme - Angir UI-temaet ditt. Finn ut mer.
keybinds - Tilpasser hurtigtaster. Finn ut mer.
leader_timeout - Styrer hvor lenge OpenCode venter etter leader key. Standard er 2000.
scroll_acceleration.enabled - Aktiver rulleakselerasjon i macOS-stil for jevn, naturlig rulling. Når aktivert, øker rullehastigheten med raske rullebevegelser og forblir presis for langsommere bevegelser. Denne innstillingen har forrang over scroll_speed og overstyrer den når den er aktivert.
scroll_speed - Styrer hvor raskt TUI ruller når du bruker rullekommandoer (minimum: 0.001, støtter desimalverdier). Standard er 3. Merk: Dette ignoreres hvis scroll_acceleration.enabled er satt til true.
diff_style - Kontrollerer diff-gjengivelse. "auto" tilpasser seg terminalbredden, "stacked" viser alltid en enkeltkolonneoppsett.
mouse - Aktiverer eller deaktiverer musefangst i TUI (standard: true). Når dette er deaktivert, bevares terminalens opprinnelige oppførsel for musemarkering og rulling.
attention - Konfigurerer skrivebordsvarsler og lyder for TUI. Deaktivert som standard.

Bruk OPENCODE_TUI_CONFIG for å laste en egendefinert TUI-konfigurasjonsbane.

Attention lar TUI varsle deg når OpenCode venter på et svar, trenger godkjenning av en tillatelse, rapporterer en øktfeil eller har fullført en økt. Aktiver dette med attention.enabled; innebygde hendelser spiller av en lyd når de skjer. Skrivebordsvarsler sendes bare når terminalvinduet ikke er i fokus, og brukes ikke for subagent-hendelser.

enabled - Aktiverer alle varsler og lyder for Attention. Standard er false.
notifications - Når Attention er aktivert, lar dette TUI sende skrivebordsvarsler via terminalen. Standard er true.
sound - Når Attention er aktivert, tillater dette varslingslyder. Standard er true.
volume - Standard volum for varslingslyder fra 0 til 1. Standard er 0.4.
sound_pack - Sound pack-ID som skal brukes. Standard er opencode.default.
sounds - Angir egendefinerte lydfiler for default, question, permission, error, done eller subagent_done. Stier kan være absolutte, file:// URL-er eller relative til tui.json.

Tilpasning

Du kan tilpasse ulike aspekter av TUI-visningen ved å bruke kommandopaletten (ctrl+x h eller /help). Disse innstillingene vedvarer ved omstarter.

Visning av brukernavn

Veksle om brukernavnet ditt vises i chat-meldinger. Få tilgang til dette gjennom:

Kommandopalett: Søk etter “brukernavn” eller “skjul brukernavn”
Innstillingen vedvarer automatisk og vil bli husket over TUI økter

TUI

Filreferanser

Bash-kommandoer

Kommandoer

connect

compact

details

editor

exit

export

help

init

models

new

redo

sessions

themes