# Documenti — Liu Terminal

> Documentazione di Liu Terminal. Scopri come installare, configurare e usare il terminale nativo per agenti IA per macOS.

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

## Introduzione

Liu è un terminale nativo per macOS, pensato per la codifica assistita dall'IA. Si colloca tra te e vari agenti di codifica e fa sentire dieci thread paralleli come un unico spazio.

## A cosa serve Liu

Apri un terminale, esegui un agente di codifica e dieci sessioni dopo non ricordi più dove hai detto cosa a chi. Liu è stato costruito attorno a questo problema.

**Flusso di lavoro agent-first.** Esegui fianco a fianco Claude Code, Codex, GitHub Copilot CLI, Cursor Agent, Amp, OpenCode, Crush, Factory Droid, Antigravity, Kimi, Qwen Code, Grok e Command Code. Liu riconosce anche la CLI autonoma di Cline e le estensioni Cline, Roo Code e Kilo Code.

- Translate-on-Tab + Prompt vocale — traduci il prompt corrente prima dell'invio e detta nel pannello attivo. Entrambi i backend, locale e ospitato, sono configurabili nelle Impostazioni.
- Cronologia agenti — archivio delle sessioni su disco di ogni CLI supportata, normalizzato e visualizzato in un selettore Cmd+K. Ripristina in modo nativo o apri una vista della trascrizione per scorrere i turni utente/assistente senza avviare l'agente.
- Crea tema con IA — ⌘ K → Crea tema. Descrivi l'aspetto, un agente locale a tua scelta emette un tema JSON, Liu lo applica in tempo reale e lo salva in ~/.config/Liu/themes/.
- Browser dei file + visualizzatore Markdown — apri uno spazio di lavoro accanto alla tua shell; leggi README, progetti e note dell'agente in un visualizzatore MD stilizzato (immagini incluse) senza uscire dalla finestra.
- Site Manager + Browser integrato — registra fino a 32 progetti locali, supervisiona i server di sviluppo e controlla la porta rilevata in una vista WebKit integrata su macOS.
- Silenzioso per impostazione predefinita — il demone liu-notify esegue TTS/avvisi desktop solo quando un agente ha effettivamente bisogno di te: routing consapevole dello strumento per (agente, evento), limitazione token-bucket, deduplicazione.

PTY nativi, schede, pannelli divisi, tavolozza comandi, barra laterale, cassaforte crittografata, SSH/SFTP/Mosh — tutto è presente come substrato.

## Cosa è cambiato

Liu si presentava come "client SSH". Quel codice è ancora nell'albero e funziona, ma non è più in primo piano. Il focus attuale è la toolchain degli agenti IA sovrastante; SSH/SFTP/Mosh vengono mantenuti collegati perché la stessa astrazione Session supporta sia PTY locali che shell remote.

**Riscritture attive.** Cronologia agenti, Crea tema con IA e il visualizzatore Markdown sono in fase di riscrittura. Il codice attuale nel repository funziona, ma aspettati cambiamenti nei formati su disco e nelle API interne. Se stai inviando una PR che tocca uno di questi, apri prima un issue.

## Piattaforme

- **macOS** - Obiettivo principale. Renderer Metal, barra delle schede nativa, AVSpeechSynthesizer per liu-notify.
- **Linux** - Compila ed esegue (X11, OpenGL 3.3, notify-send). Meno rifinito.

## Dove andare dopo

- [Installazione](https://liu.software/it/docs/install.md) - Compila dal sorgente in meno di un minuto.
- [Avvio rapido](https://liu.software/it/docs/quickstart.md) - Primo avvio, cassaforte, Cronologia agenti.
- [Cronologia agenti](https://liu.software/it/docs/agent-history.md) - La pagina principale; strumenti supportati e funzionamento della scansione.
- [Browser file](https://liu.software/it/docs/file-browser.md) - Albero laterale, SFTP, visualizzatori e grafo delle note.
- [Editor di codice](https://liu.software/it/docs/code-editor.md) - Barra esplora file, evidenziazione della sintassi, trova/sostituisci, barra di stato e dock git diff.
- [Visualizzatore Markdown](https://liu.software/it/docs/markdown.md) - Rendering MD stilizzato, ricerca vault e Go to Heading.

[Prossimo Installazione →](https://liu.software/it/docs/install.md)