Salta ai contenuti
OpenCode
HomeDocs

TUI

Utilizzo dell'interfaccia utente terminale di OpenCode.

OpenCode fornisce un’interfaccia terminale interattiva o TUI per lavorare sui tuoi progetti con un LLM.

L’esecuzione di OpenCode avvia la TUI per la directory corrente.

Terminal window
opencode

Oppure puoi avviarla per una directory di lavoro specifica.

Terminal window
opencode /path/to/project

Una volta nella TUI, puoi inviarle un messaggio.

Give me a quick summary of the codebase.

Riferimenti ai file

Puoi fare riferimento ai file nei tuoi messaggi usando @. Questo esegue una ricerca approssimativa dei file nella directory di lavoro corrente.

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

Il contenuto del file viene aggiunto automaticamente alla conversazione.

Comandi Bash

Inizia un messaggio con ! per eseguire un comando shell.

!ls -la

L’output del comando viene aggiunto alla conversazione come risultato di uno strumento.

Comandi

Quando usi la TUI di OpenCode, puoi digitare / seguito da un nome di comando per eseguire rapidamente azioni. Ad esempio:

/help

La maggior parte dei comandi ha anche una scorciatoia da tastiera che usa ctrl+x come tasto leader, dove ctrl+x e il tasto leader predefinito. Più info.

Ecco tutti i comandi slash disponibili:

connect

Aggiungi un fornitore a OpenCode. Ti permette di selezionare tra i fornitori disponibili e aggiungere le loro chiavi API.

/connect

compact

Compatta la sessione corrente. Alias: /summarize

/compact

Scorciatoia: ctrl+x c

details

Attiva/disattiva i dettagli di esecuzione degli strumenti.

/details

Scorciatoia: ctrl+x d

editor

Apri l’editor esterno per comporre i messaggi. Usa l’editor impostato nella tua variabile d’ambiente EDITOR. Più info.

/editor

Scorciatoia: ctrl+x e

exit

Esci da OpenCode. Alias: /quit, /q

/exit

Scorciatoia: ctrl+x q

export

Esporta la conversazione corrente in Markdown e aprila nell’editor predefinito. Usa l’editor impostato nella tua variabile d’ambiente EDITOR. Più info.

/export

Scorciatoia: ctrl+x x

help

Mostra la finestra di aiuto.

/help

Scorciatoia: ctrl+x h

init

Crea o aggiorna il file AGENTS.md. Più info.

/init

Scorciatoia: ctrl+x i

models

Elenca i modelli disponibili.

/models

Scorciatoia: ctrl+x m

new

Avvia una nuova sessione. Alias: /clear

/new

Scorciatoia: ctrl+x n

redo

Ripristina un messaggio precedentemente annullato. Disponibile solo dopo aver usato /undo.

Internamente, questo usa Git per gestire le modifiche ai file. Quindi il tuo progetto deve essere un repository Git.

/redo

Scorciatoia: ctrl+x r

sessions

Elenca e passa da una sessione all’altra. Alias: /resume, /continue

/sessions

Scorciatoia: ctrl+x l

share

Condividi la sessione corrente. Più info.

/share

Scorciatoia: ctrl+x s

themes

Elenca i temi disponibili.

/theme

Scorciatoia: ctrl+x t

undo

Annulla l’ultimo messaggio nella conversazione. Rimuove il messaggio utente più recente, tutte le risposte successive e tutte le modifiche ai file.

Internamente, questo usa Git per gestire le modifiche ai file. Quindi il tuo progetto deve essere un repository Git.

/undo

Scorciatoia: ctrl+x u

unshare

Annulla la condivisione della sessione corrente. Più info.

/unshare

Configurazione dell’editor

Sia i comandi /editor che /export usano l’editor specificato nella tua variabile d’ambiente EDITOR.

Terminal window
# Esempio per nano o vim
export EDITOR=nano
export EDITOR=vim


# Per editor GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, ecc.
# includere --wait
export EDITOR="code --wait"

Per renderlo permanente, aggiungilo al tuo profilo di shell; ~/.bashrc, ~/.zshrc, ecc.

Le opzioni dell’editor popolari includono:

  • code - Visual Studio Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Editor Neovim
  • vim - Editor Vim
  • nano - Editor Nano
  • notepad - Blocco note di Windows
  • subl - Sublime Text

Alcuni editor necessitano argomenti da riga di comando per funzionare in modalità bloccante. Il flag --wait fa si che il processo dell’editor si blocchi fino alla chiusura.

Configura

Puoi personalizzare il comportamento della TUI attraverso il tuo file di configurazione OpenCode.

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

Opzioni

  • scroll_acceleration - Abilita l’accelerazione dello stile di scorrimento macOS per uno scorrimento fluido e naturale. Quando abilitata, la velocità di scorrimento aumenta con i gesti di scorrimento rapidi e rimane precisa per movimenti più lenti. Questa impostazione ha la precedenza su scroll_speed e lo sovrascrive quando abilitata.
  • scroll_speed - Controlla la velocità di scorrimento della TUI quando si usano i comandi di scorrimento (minimo: 1). Predefinito a 1 su Unix e 3 su Windows. Nota: Questo viene ignorato se scroll_acceleration.enabled è impostato su true.

Personalizzazione

Puoi personalizzare vari aspetti della vista TUI usando la tavolozza dei comandi (ctrl+x h o /help). Queste impostazioni persistono tra i riavvii.

Visualizzazione del nome utente

Attiva/disattiva se il tuo nome utente appare nei messaggi di chat. Accessibile tramite:

  • Tavolozza dei comandi: Cerca “username” o “hide username”
  • L’impostazione viene salvata automaticamente e sarà ricordata tra le sessioni TUI