# Avvio rapido — Liu Terminal

> Guida di avvio rapido per Liu Terminal. Inizia con schede, divisioni, sessioni e agenti IA in pochi minuti.

URL: https://liu.software/it/docs/quickstart/  
Language: it  
Updated: 2026-10-17

Da una nuova build alla tua prima sessione IA ripresa in meno di cinque minuti. Questa pagina percorre il percorso ideale; il materiale più approfondito si trova nella sezione Guide.

## 1 - Primo avvio

Avvia ./build/Liu. La prima finestra si apre con un PTY locale nella tua directory home. Se avviato dal Finder, Liu eseguirà chdir($HOME) nel processo figlio in modo che le nuove schede non finiscano in /.

Premi ⌘, per le impostazioni. Tema e font sono le due cose che vale la pena impostare prima di ogni altra.

## 2 - Sblocca la cassaforte

Host, chiavi e snippet risiedono in una cassaforte crittografata (SQLite + AES-256-GCM, chiave derivata con PBKDF2-HMAC-SHA256). Alla prima apertura di Smart Vault (⌘ ⇧ V) Liu chiede una passphrase: solo tua, nessun recupero. La memoria sensibile viene cancellata con crypto\_secure\_zero allo sblocco/blocco.

Sbloccata, la cassaforte resta aperta per la sessione. Bloccala manualmente (⌘ K → Vault: Lock Now) o lascia che vault\_auto\_lock\_minutes in config.json gestisca l'inattività.

## 3 - Apri Cronologia agenti

Premi ⌘ K e scegli Cronologia agenti. Liu esamina l'archivio delle sessioni su disco di ogni CLI IA installata, normalizza le voci in un elenco unificato e le mostra in un selettore. Digita per una corrispondenza fuzzy per snippet, strumento o directory di lavoro.

Premi ↵ su una voce per ripristinarla in modo nativo in una nuova scheda. Oppure premi ⌘ ↵ per aprire la vista della trascrizione: scorri i turni utente/assistente senza avviare l'agente.

Apri il selettore dall'interno di un progetto e si filtrerà automaticamente su quella directory. Aprilo da $HOME e mostrerà tutto sul disco.

**Flusso di lavoro degli agenti supportato**

Liu riconosce attualmente Claude Code, Codex, GitHub Copilot CLI, Cursor Agent, Amp, OpenCode, Crush, Factory Droid, Antigravity, Kimi, Qwen Code, Grok e Command Code. Sono supportati anche la CLI autonoma di Cline e le estensioni editor Cline, Roo Code e Kilo Code.

[Vedi la matrice completa delle integrazioni →](https://liu.software/it/docs/agent-history.md)

## 4 - Genera un tema con l'IA

⌘ K → Crea tema. Descrivi l'aspetto che desideri, scegli l'agente e Liu consegnerà il prompt a una CLI locale. Il JSON restituito viene convalidato, applicato in tempo reale e salvato in ~/.config/Liu/themes/.

## 5 - Dividi, cerca, cambia

- ⌘ D / ⌘ ⇧ D - dividi il pannello corrente orizzontalmente o verticalmente.
- ⌘ F - cerca nello scrollback.
- ⌘ K - tavolozza fuzzy su comandi, host, snippet, temi e sessioni agente.
- ⌃ \` - scorciatoia globale predefinita della modalità Quake quando abilitata.

## 6 - Dove andare dopo

- [Cronologia agenti](https://liu.software/it/docs/agent-history.md) - Tabella completa degli strumenti e funzionamento della scansione.
- [Temi](https://liu.software/it/docs/themes.md) - Il flusso Crea tema con IA + scrivere il proprio JSON.
- [Scorciatoie tastiera](https://liu.software/it/docs/keys.md) - Riferimento completo delle scorciatoie.

[Prossimo Temi →](https://liu.software/it/docs/themes.md)
