8. Come funziona dentro

8.5 La riga di comando

I comandi dell'eseguibile di Atollo per preparare, controllare e sincronizzare il kit senza aprire la finestra.

In breve

L'eseguibile di Atollo è anche un programma a riga di comando: con un comando, fa il lavoro e esce, senza aprire la finestra.
Utile per preparare un kit per un altro sistema, controllare i componenti, o vedere l'ambiente.
Funziona anche mentre l'app è aperta.

Come si usa

Apri una console nella cartella del kit. Su Windows, in PowerShell, aggiungi | Out-Host perché l'output compaia nella console (l'eseguibile è un programma con finestra); nel Prompt dei comandi non serve. Su macOS e Linux usa il percorso del programma (per esempio ./Atollo.AppImage).

Esempio

cd D:\Atollo
.\Atollo.exe components | Out-Host
.\Atollo.exe prepare --only node,php --line php=8.3 | Out-Host
.\Atollo.exe check | Out-Host

I comandi

Comando	Che cosa fa
`env [--project <nome>]`	Stampa l'ambiente del kit (segreti mascherati); con un progetto, con le sue versioni.
`components [--target <sistema>]`	Elenca i componenti: scelto o no, gruppo, versione installata o perché non è disponibile.
`versions [<id>]`	Senza id: le versioni su disco degli strumenti installati. Con un id: chiede alla fonte le versioni offerte e le salva.
`check`	Chiede a ogni componente installato la sua versione e segna ✓ o ✗.
`check --kit`	La salute del kit: disco, spazio, percorso, permessi, librerie, come «Salute del kit» nelle Impostazioni. Una riga per controllo (√, ! o x) con sotto che cosa fare; finisce con 1 se un controllo è un errore.
`check --files`	I file dei programmi, come «Verifica i file» nella pagina Strumenti: una riga per cartella (√ a posto, x danneggiata con i percorsi mancanti o cambiati, - senza manifesto); finisce con 1 se una cartella è danneggiata.
`prepare [opzioni]`	Installa, aggiorna e toglie i componenti secondo la scelta. Le opzioni sono nella tabella sotto.
`sync [--project <cartella>] [--verbose]`	Allinea istruzioni, skill e server MCP degli agenti.
`serve <cartella> <porta>`	Serve una cartella come sito statico (il server di file del kit).
`keyring restore \| save`	Usato dal kit attorno ad Antigravity: rimette o salva il suo accesso.
`models`	I modelli locali: quelli del catalogo e quelli scaricati.
`models pull <modello>`	Scarica un id del catalogo o un modello di Hugging Face (proprietario/nome:quantizzazione); riprende se interrotto.
`models rm <id>`	Cancella un modello scaricato.
`llm start \| stop \| status`	Il server dei modelli locali (chat e agenti): lo avvia, lo ferma o dice se risponde. status non manda la chiave a chi ascolta sulla porta.
`diagnostics`	Crea lo zip da allegare a una segnalazione (segreti mascherati) in data\app\diagnostics, come «Esporta diagnostica» nelle Impostazioni, e ne stampa il percorso.
`version · help`	La versione (anche --version, -V) e l'aiuto (anche --help, -h, /?).

Opzione di prepare	Effetto
`--only a,b`	Solo questi componenti (più ciò di cui hanno bisogno), senza togliere gli altri.
`--skip a,b`	Tutti tranne questi (gli obbligatori non si saltano).
`--update-all`	Aggiorna anche ciò che è già installato.
`--force`	Reinstalla anche se la versione è già quella.
`--line id=x.y`	Aggiunge quella versione accanto alle altre (si può ripetere).
`--target <sistema>`	Prepara per un altro sistema: win32-x64, win32-arm64, darwin-arm64, darwin-x64, linux-x64, linux-arm64.

Sotto il cofano

Codice di uscita	Significato
`0`	Tutto bene.
`1`	prepare o check: qualcosa non è riuscito.
`2`	Comando sconosciuto (viene stampato anche l'aiuto).
`3`	prepare: è già in corso un'altra preparazione dello stesso kit.

Dalla riga di comando prepare usa GITHUB_TOKEN o GH_TOKEN della console, se ci sono, per alzare il limite dell'API di GitHub; non usa l'account del kit. Se un download fallisce stampa l'indirizzo da scaricare a mano e la cartella in cui metterlo.