Waveterm

Terminale open-source con integrazione AI, sessioni persistenti, grafica inline e gestione connessioni remote.

Installazione

Installazione per Piattaforma

Comando	Descrizione
`brew install --cask wave`	Installa su macOS con Homebrew
Scarica da `waveterm.dev`	Installa dal sito ufficiale
Scarica `.deb` o `.rpm` dalle release	Installa su Linux
Scarica l’installer `.exe` dalle release	Installa su Windows
`wsh version`	Mostra la versione della CLI Wave
`wsh help`	Mostra i comandi wsh disponibili

Utilizzo Base

Gestione Tab e Finestre

Comando	Descrizione
`Cmd/Ctrl + N`	Apri nuovo tab terminale
`Cmd/Ctrl + T`	Apri nuovo tab workspace
`Cmd/Ctrl + W`	Chiudi tab corrente
`Cmd/Ctrl + Shift + N`	Apri nuova finestra
`Cmd/Ctrl + 1-9`	Passa al tab per numero
`Cmd/Ctrl + Shift + ]`	Tab successivo
`Cmd/Ctrl + Shift + [`	Tab precedente
`Cmd/Ctrl + Shift + T`	Riapri ultimo tab chiuso

Gestione Blocchi e Pannelli

Comando	Descrizione
`Cmd/Ctrl + Shift + D`	Dividi terminale orizzontalmente
`Cmd/Ctrl + D`	Dividi terminale verticalmente
Clicca e trascina i bordi dei blocchi	Ridimensiona i pannelli del terminale
`Alt + Tasti freccia`	Naviga tra i blocchi
`Cmd/Ctrl + Enter`	Massimizza/ripristina blocco corrente
`Cmd/Ctrl + Shift + P`	Apri palette dei comandi
`Cmd/Ctrl + Backspace`	Chiudi blocco corrente

Funzionalita AI

Chat AI

Comando	Descrizione
`Cmd/Ctrl + Space`	Apri chat AI nel blocco corrente
Digita domanda nella chat AI	Chiedi all’AI informazioni su comandi o codice
`/explain` nella chat AI	Spiega l’output del comando precedente
`/fix` nella chat AI	Suggerisci correzione per l’ultimo errore
`/summarize` nella chat AI	Riassumi output lungo
Clicca “Apply” sul suggerimento AI	Inserisci comando suggerito nel terminale
`Esc`	Chiudi pannello chat AI

Configurazione Provider AI

Comando	Descrizione
Configura modello AI nelle impostazioni	Scegli tra OpenAI, Anthropic, modelli locali
Imposta `ai:preset` nel config	Cambia tra provider AI
Imposta `ai:apitoken` nel config	Configura chiave API per il provider AI
Imposta `ai:model` nel config	Specifica nome del modello (es. gpt-4, claude-3)
Imposta `ai:baseurl` nel config	Punta a endpoint API personalizzato/locale
Imposta `ai:maxtokens` nel config	Imposta numero massimo di token nella risposta

Esempio di Configurazione AI

{
  "ai:preset": "custom",
  "ai:apitoken": "sk-...",
  "ai:baseurl": "https://api.openai.com/v1",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

Per modelli locali usando Ollama:

{
  "ai:preset": "custom",
  "ai:baseurl": "http://localhost:11434/v1",
  "ai:model": "llama3",
  "ai:maxtokens": 4096
}

Connessioni SSH

Operazioni SSH

Comando	Descrizione
`wsh ssh user@hostname`	Connettiti all’host remoto tramite SSH
`wsh ssh user@host -i ~/.ssh/key`	SSH con chiave di identita specifica
`wsh ssh -p 2222 user@host`	SSH su porta personalizzata
Clicca ”+” poi “SSH Connection”	Crea connessione SSH dall’interfaccia
Le connessioni persistono tra le sessioni	Le sessioni sopravvivono al riavvio dell’app
`wsh ssh-import`	Importa connessioni dalla configurazione SSH
Configura voci `~/.ssh/config`	Scoperta automatica degli host SSH
Clic destro connessione poi Reconnect	Riconnetti sessione SSH interrotta

Integrazione con SSH Config

Wave legge il tuo SSH config per la scoperta degli host. Configura le voci per connessioni senza interruzioni:

Host prod-web
    HostName 10.0.1.50
    User deploy
    IdentityFile ~/.ssh/deploy_key
    Port 22

Host staging-*
    HostName %h.staging.example.com
    User admin
    IdentityFile ~/.ssh/staging_key
    ForwardAgent yes

Host jump-box
    HostName bastion.example.com
    User ops
    IdentityFile ~/.ssh/ops_key

Host internal-*
    ProxyJump jump-box
    User admin
    IdentityFile ~/.ssh/internal_key

Navigazione File Remoti

Comando	Descrizione
`wsh view remote:file.txt`	Visualizza file sull’host remoto
`wsh edit remote:file.txt`	Modifica file sull’host remoto inline
`wsh view remote:/var/log/syslog`	Visualizza file di log remoto
`wsh run --remote user@host -- command`	Esegui comando sull’host remoto in un nuovo blocco

Visualizzazione File e Contenuti

Comando	Descrizione
`wsh view file.png`	Visualizza immagine inline nel terminale
`wsh view file.jpg`	Visualizza immagine JPEG inline
`wsh view file.svg`	Visualizza grafico SVG inline
`wsh view file.md`	Renderizza markdown inline
`wsh view file.csv`	Mostra CSV come tabella
`wsh view file.json`	Mostra JSON con evidenziazione della sintassi
`wsh view file.pdf`	Anteprima documento PDF
`wsh view https://example.com`	Incorpora pagina web nel blocco

Operazioni sui Blocchi

Comando	Descrizione
`wsh edit file.txt`	Apri file nell’editor inline
`wsh edit --lang=python script.py`	Apri editor con modalita linguaggio
`wsh getmeta`	Ottieni metadati del blocco corrente
`wsh setmeta key=value`	Imposta metadati del blocco
`wsh run -- command args`	Esegui comando in un nuovo blocco
`wsh run --magnify -- htop`	Esegui comando in blocco massimizzato
`wsh createblock`	Crea un blocco vuoto
`wsh createblock --tabid=tab1`	Crea blocco in un tab specifico

Comando	Descrizione
`wsh view --magnify file.png`	Visualizza immagine in blocco massimizzato
`wsh view --height=20 file.csv`	Visualizza con altezza del blocco specifica
Trascina e rilascia file su Wave	Visualizza file direttamente
`wsh view .`	Naviga la directory corrente
`wsh view ~/projects`	Naviga una directory specifica

Personalizzazione

Impostazioni Aspetto

Comando	Descrizione
Apri Impostazioni poi Aspetto	Cambia tema e colori
Apri Impostazioni poi Terminale	Configura font, dimensione, cursore
Imposta `term:fontsize` nel config	Imposta dimensione font del terminale
Imposta `term:fontfamily` nel config	Imposta famiglia font del terminale
Imposta `term:theme` nel config	Imposta tema colori del terminale
Imposta `term:cursorstyle` nel config	Imposta stile cursore (block, bar, underline)
Imposta `window:transparent` nel config	Abilita trasparenza finestra
Imposta `window:blur` nel config	Abilita sfocatura sfondo
Imposta `window:opacity` nel config	Imposta livello di opacita finestra
Imposta `telemetry:enabled = false`	Disabilita telemetria

Configurazione Aspetto Terminale

{
  "term:fontsize": 14,
  "term:fontfamily": "JetBrains Mono, Menlo, monospace",
  "term:theme": "dracula",
  "term:cursorstyle": "bar",
  "term:scrollback": 10000,
  "window:transparent": true,
  "window:blur": true,
  "window:opacity": 0.92
}

Configurazione Tema Personalizzato

{
  "term:theme": "custom",
  "term:localtheme": {
    "black": "#282a36",
    "red": "#ff5555",
    "green": "#50fa7b",
    "yellow": "#f1fa8c",
    "blue": "#bd93f9",
    "magenta": "#ff79c6",
    "cyan": "#8be9fd",
    "white": "#f8f8f2",
    "brightBlack": "#6272a4",
    "brightRed": "#ff6e6e",
    "brightGreen": "#69ff94",
    "brightYellow": "#ffffa5",
    "brightBlue": "#d6acff",
    "brightMagenta": "#ff92df",
    "brightCyan": "#a4ffff",
    "brightWhite": "#ffffff",
    "background": "#282a36",
    "foreground": "#f8f8f2",
    "cursor": "#f8f8f2",
    "selectionBackground": "#44475a"
  }
}

Scorciatoie da Tastiera

Navigazione

Comando	Descrizione
`Cmd/Ctrl + Shift + P`	Palette dei comandi
`Cmd/Ctrl + L`	Pulisci terminale
`Cmd/Ctrl + Shift + E`	Attiva/disattiva barra laterale
`Cmd/Ctrl + K`	Focus sulla ricerca
`Cmd/Ctrl + Shift + F`	Ricerca globale
`Alt + Tasti freccia`	Naviga tra i blocchi
`Cmd/Ctrl + Enter`	Massimizza/ripristina blocco corrente
`Cmd/Ctrl + ,`	Apri impostazioni

Modifica e Appunti

Comando	Descrizione
`Cmd/Ctrl + Shift + C`	Copia dal terminale
`Cmd/Ctrl + Shift + V`	Incolla nel terminale
`Cmd/Ctrl + A`	Seleziona tutto nel blocco
`Cmd/Ctrl + F`	Cerca nel blocco corrente
`Shift + Page Up`	Scorri verso l’alto nel terminale
`Shift + Page Down`	Scorri verso il basso nel terminale
`Cmd/Ctrl + Home`	Scorri all’inizio del buffer
`Cmd/Ctrl + End`	Scorri alla fine del buffer

Gestione Blocchi

Comando	Descrizione
`Cmd/Ctrl + D`	Dividi verticalmente
`Cmd/Ctrl + Shift + D`	Dividi orizzontalmente
`Cmd/Ctrl + Backspace`	Chiudi blocco corrente
`Cmd/Ctrl + Enter`	Attiva/disattiva massimizzazione blocco
`Alt + Su/Giu/Sinistra/Destra`	Sposta focus tra i blocchi
`Cmd/Ctrl + Shift + Freccia`	Ridimensiona blocco corrente

Configurazione

Gestione della Configurazione

Comando	Descrizione
`wsh getvar key`	Ottieni variabile di configurazione
`wsh setvar key=value`	Imposta variabile di configurazione
`wsh getvar --all`	Elenca tutte le variabili di configurazione
Configurazione archiviata in `~/.waveterm/`	Directory di configurazione predefinita
Imposta `autoupdate:enabled` nel config	Abilita/disabilita aggiornamenti automatici
Imposta `conn:askbeforewshinstall` nel config	Chiedi prima di installare wsh su remoto
Imposta `editor:minimap` nel config	Attiva/disattiva minimap nell’editor inline
Imposta `web:openlinksinternally` nel config	Apri link nel blocco browser di Wave

Esempio di Configurazione Completa

{
  "term:fontsize": 13,
  "term:fontfamily": "Fira Code, monospace",
  "term:theme": "one-dark",
  "term:cursorstyle": "block",
  "term:scrollback": 5000,
  "window:transparent": false,
  "window:blur": false,
  "telemetry:enabled": false,
  "autoupdate:enabled": true,
  "conn:askbeforewshinstall": true,
  "editor:minimap": false,
  "web:openlinksinternally": true,
  "ai:preset": "openai",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

Variabili d’Ambiente

Comando	Descrizione
`WAVETERM_HOME=~/.waveterm`	Sovrascrive la directory di configurazione di Wave
`WAVETERM_DEV=1`	Abilita modalita sviluppo
`TERM_PROGRAM=waveterm`	Impostata automaticamente nelle sessioni Wave
`WAVETERM_BLOCKID`	ID del blocco corrente (impostato per blocco)
`WAVETERM_TABID`	ID del tab corrente (impostato per tab)

Gestione dei Workspace

Workspace

Comando	Descrizione
Clicca nome workspace nella barra laterale	Passa tra i workspace
Clic destro workspace poi Rinomina	Rinomina un workspace
Crea nuovo workspace dalla barra laterale	Aggiungi un workspace pulito
Trascina tab tra workspace	Riorganizza i tab
I workspace persistono tra i riavvii	Tutto lo stato viene salvato automaticamente

Persistenza delle Sessioni

Comando	Descrizione
La cronologia del terminale persiste	Output dei comandi salvato tra le sessioni
Le connessioni SSH si riconnettono automaticamente	Sessioni remote ripristinate al riavvio
Layout dei blocchi salvato per tab	Disposizione dei pannelli preservata
Directory di lavoro ricordate	Ogni blocco ricorda il suo cwd
Posizione di scroll mantenuta	Torna dove avevi lasciato

Buone Pratiche

Usa i blocchi per il multitasking — dividi il tuo terminale in blocchi per monitorare log, eseguire build e modificare codice fianco a fianco.
Sfrutta l’AI per comandi sconosciuti — premi Cmd/Ctrl + Space per chiedere all’assistente AI informazioni su sintassi, flag o risoluzione di problemi.
Configura SSH config per accesso rapido — aggiungi tutti i tuoi server a ~/.ssh/config cosi Wave li scopre automaticamente nel menu connessioni.
Usa i visualizzatori inline per ispezione rapida — wsh view ti permette di visualizzare in anteprima immagini, CSV e markdown senza lasciare il terminale.
Fissa i blocchi importanti — massimizza i blocchi importanti con Cmd/Ctrl + Enter quando ti concentri su un’attivita, poi ripristina il layout quando hai finito.
Disabilita la telemetria se preferisci — imposta telemetry:enabled su false nella tua configurazione per la privacy.
Usa i workspace per i progetti — crea workspace separati per progetti diversi per mantenere il contesto organizzato.
Usa il suffisso -dev per la configurazione del modello AI — punta ai:baseurl a un’istanza locale Ollama o LM Studio per assistenza AI privata e offline.
Impara le scorciatoie da tastiera per i blocchi — Alt + Freccia per la navigazione e Cmd/Ctrl + Shift + D per la divisione sono le scorciatoie piu usate.
Personalizza il tuo tema — configura un tema colori personalizzato usando term:localtheme per abbinare i colori del tuo editor preferito per un’esperienza coerente.