Hopp til innholdet
V1-dokumentasjon
Filreferanser

TUI

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

Å kjøre OpenCode starter TUI for gjeldende katalog.

Terminal
opencode

Eller du kan starte den for en spesifikk arbeidskatalog.

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

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.


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

Terminal
!ls -la

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


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

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


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

Terminal
/connect

Komprimer gjeldende økt. Alias: /summarize

Terminal
/compact

Nøkkelbinding: ctrl+x c


Åpne eksternt tekstredigeringsprogram for å skrive meldinger. Bruker redigeringssettet i miljøvariabelen EDITOR. Finn ut mer.

Terminal
/editor

Nøkkelbinding: ctrl+x e


Avslutt OpenCode. Aliaser: /quit, /q

Terminal
/exit

Nøkkelbinding: ctrl+x q


Eksporter gjeldende samtale til Markdown og åpne i standardredigeringsprogrammet. Bruker redigeringssettet i miljøvariabelen EDITOR. Finn ut mer.

Terminal
/export

Nøkkelbinding: ctrl+x x


Vis hjelpedialogen.

Terminal
/help

Nøkkelbinding: ctrl+x h


Opprett eller oppdater AGENTS.md-fil. Finn ut mer.

Terminal
/init

Nøkkelbinding: ctrl+x i


Liste over tilgjengelige modeller.

Terminal
/models

Nøkkelbinding: ctrl+x m


Start en ny økt. Alias: /clear

Terminal
/new

Nøkkelbinding: ctrl+x n


Gjenta en tidligere angret melding. Kun tilgjengelig etter bruk av /undo.

Internt bruker dette Git til å administrere filendringene. Så ditt prosjekt må være et Git-repo.

Terminal
/redo

Nøkkelbinding: ctrl+x r


List opp og bytt mellom økter. Aliaser: /resume, /continue

Terminal
/sessions

Nøkkelbinding: ctrl+x l


Liste over tilgjengelige temaer.

Terminal
/themes

Nøkkelbinding: ctrl+x t


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.

Terminal
/thinking

Angre siste melding i samtalen. Fjerner den siste brukermeldingen, alle påfølgende svar og eventuelle filendringer.

Internt bruker dette Git til å administrere filendringene. Så ditt prosjekt må være et Git-repo.

Terminal
/undo

Nøkkelbinding: ctrl+x u


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

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

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.


Du kan tilpasse TUI-oppførselen gjennom tui.json (eller 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"
    }
  }
}

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.

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

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