Salta ai contenuti
OpenCode
app.header.homeapp.header.docs

TUI

Usa l'interfaccia utente da terminale (TUI) di OpenCode.

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

Eseguire OpenCode avvia la TUI per la directory corrente.

Terminal window
opencode

Oppure puoi avviarla per una specifica working directory.

Terminal window
opencode /path/to/project

Una volta nella TUI, puoi inviare un messaggio come prompt.

Give me a quick summary of the codebase.

Riferimenti ai file

Puoi riferirti ai file nei messaggi usando @. Questo esegue una ricerca fuzzy dei file nella working directory 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 dal nome di un comando per eseguire rapidamente azioni. Per esempio:

/help

Molti comandi hanno anche una scorciatoia da tastiera che usa ctrl+x come tasto leader (predefinito). Scopri di piu.

Ecco tutti i comandi slash disponibili:

connetti

Aggiunge un provider a OpenCode. Ti permette di selezionare tra i provider disponibili e aggiungere le relative chiavi API.

/connect

compatta

Compatta la sessione corrente. Alias: /summarize

/compact

Scorciatoia: ctrl+x c

dettagli

Attiva/disattiva i dettagli di esecuzione degli strumenti.

/details

Scorciatoia: ctrl+x d

editor

Apre un editor esterno per comporre messaggi. Usa l’editor impostato nella variabile d’ambiente EDITOR. Scopri di piu.

/editor

Scorciatoia: ctrl+x e

esci

Esce da OpenCode. Alias: /quit, /q

/exit

Scorciatoia: ctrl+x q

esporta

Esporta la conversazione corrente in Markdown e la apre nell’editor predefinito. Usa l’editor impostato nella variabile d’ambiente EDITOR. Scopri di piu.

/export

Scorciatoia: ctrl+x x

aiuto

Mostra la finestra di aiuto.

/help

Scorciatoia: ctrl+x h

inizializza

Crea o aggiorna il file AGENTS.md. Scopri di piu.

/init

Scorciatoia: ctrl+x i

modelli

Elenca i modelli disponibili.

/models

Scorciatoia: ctrl+x m

nuovo

Avvia una nuova sessione. Alias: /clear

/new

Scorciatoia: ctrl+x n

rifai

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

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

/redo

Scorciatoia: ctrl+x r

sessioni

Elenca e passa tra le sessioni. Alias: /resume, /continue

/sessions

Scorciatoia: ctrl+x l

condividi

Condivide la sessione corrente. Scopri di piu.

/share

Scorciatoia: ctrl+x s

temi

Elenca i temi disponibili.

/theme

Scorciatoia: ctrl+x t

ragionamento

Attiva/disattiva la visibilita dei blocchi thinking/reasoning nella conversazione. Quando abilitato, puoi vedere il ragionamento del modello per i modelli che supportano extended thinking.

/thinking

annulla

Annulla l’ultimo messaggio nella conversazione. Rimuove l’ultimo messaggio utente, tutte le risposte successive e qualsiasi modifica ai file.

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

/undo

Scorciatoia: ctrl+x u

annulla condivisione

Annulla la condivisione della sessione corrente. Scopri di piu.

/unshare

Configurazione dell’editor

Sia /editor sia /export usano l’editor specificato nella variabile d’ambiente EDITOR.

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

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

Opzioni comuni per l’editor includono:

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

Alcuni editor richiedono argomenti da riga di comando per funzionare in modalita bloccante. Il flag --wait fa si che il processo dell’editor resti in attesa finche non viene chiuso.

Configura

Puoi personalizzare il comportamento della TUI tramite il file di config di OpenCode.

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

Opzioni

  • scroll_acceleration - Abilita l’accelerazione di scroll in stile macOS per uno scorrimento fluido e naturale. Quando abilitata, la velocita aumenta con gesture rapide e resta precisa con movimenti lenti. Questa impostazione ha precedenza su scroll_speed e lo sovrascrive quando attiva.
  • scroll_speed - Controlla la velocita di scorrimento della TUI quando usi i comandi di scroll (minimo: 1). Default: 3. Nota: viene ignorata se scroll_acceleration.enabled e impostato a true.

Personalizzazione

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

Visualizzazione nome utente

Attiva/disattiva se lo username appare nei messaggi della chat. Puoi farlo da:

  • Palette comandi: cerca “username” o “hide username”
  • L’impostazione viene salvata automaticamente e ricordata tra le sessioni TUI