1. Primi passi
1.3 Conoscere la finestra
Barra delle attività, barra laterale, schede, barra di stato e pannello «Attività»: dove sono le cose e a che cosa servono.
In breve
- La finestra imita quella di Visual Studio Code: chi lo conosce si orienta subito.
- A sinistra la barra delle attività cambia pagina; accanto, la barra laterale mostra elenchi e alberi.
- Al centro le schede; in basso la barra di stato e il pannello «Attività» con ciò che è in corso.
- Ctrl+P apre un progetto per nome da qualsiasi pagina.
- Ctrl+Shift+P apre la palette dei comandi da qualsiasi pagina, anche da un terminale: avviare o fermare un progetto, aprirlo, lanciarci un agente, cambiare pagina.
Le parti della finestra
1 · Barra del titolo
2 · Barra delle attività
3 · Barra laterale
4 · Area delle schede
5 · Pannello «Attività»
6 · Barra di stato
| Parte | Che cosa contiene |
|---|---|
| 1 · Barra del titolo | Il nome Atollo e la pagina aperta; a destra riduci, ingrandisci e chiudi. Trascinala per spostare la finestra, doppio clic per ingrandirla. |
| 2 · Barra delle attività | Le icone delle pagine. In alto quelle di lavoro: Progetti, AI (agenti e modelli locali), Database, Server Web, Terminali, Strumenti. In basso: Guida, Impostazioni, Rimuovi l'unità. Un numero sull'icona di Progetti dice quante cose sono in esecuzione: azioni dei progetti, versioni dei database, pool dei server web e il server dei modelli locali. |
| 3 · Barra laterale | Il titolo della pagina con le sue icone (tra cui il libro «Apri la guida di questa pagina»), spesso una casella di ricerca, e dei riquadri che si aprono e si chiudono con un clic sul titolo. |
| 4 · Area delle schede | Ciò che hai scelto nella barra laterale si apre in una scheda. La prima scheda di alcune pagine è fissa: il «Pannello rapido» in Progetti, «Tutti gli strumenti» in Strumenti. |
| 5 · Pannello «Attività» | Si apre dalla barra di stato. Elenca l'installazione in corso, le versioni dei database accese, i pool dei server web accesi, il server dei modelli locali e le azioni dei progetti, ognuna con il suo output; «Ferma tutto» le ferma tutte dopo una conferma. |
| 6 · Barra di stato | A sinistra la voce Atollo e il contatore di ciò che è in esecuzione e degli errori, che mostra o nasconde il pannello «Attività»; a destra i terminali aperti, lo stato dell'editor, il sistema (per esempio win32-x64) e, per ultima, la versione di Atollo: un clic cerca gli aggiornamenti, e accanto compare l'esito (un segno di spunta, la versione nuova o un avviso). |
Le pagine
Progetti
Il centro del lavoro: l'elenco dei progetti, il «Pannello rapido», la creazione di progetti nuovi e la pagina di ogni progetto. Come funziona
Leggi →AI
Tutta l'IA del kit in due riquadri. «Agenti»: accesso al tuo account, limiti del piano e consumi, e ciò che gli agenti condividono (istruzioni, skill, server MCP). «Modelli locali»: i modelli linguistici sul PC per Pi e la chat nel browser, il server llama.cpp, i download dal catalogo e da Hugging Face. Come funziona
Leggi →Database
I server MySQL e MongoDB del kit: avvio, password, porte, versioni, phpMyAdmin e mongo-express. Come funziona
Leggi →Server Web
I server Caddy e Apache condivisi fra i progetti e i siti .localhost che servono. Come funziona
Leggi →Strumenti
Linguaggi, agenti, database e programmi del kit: installare, aggiornare, togliere, più versioni. Come funziona
Leggi →Guida
Questa guida. Ogni pagina ha anche un'icona a forma di libro che apre l'argomento giusto. Come funziona
Leggi →Impostazioni
Lingua, tema, rete, account GitHub e chi firma i commit, aggiornamenti, privacy e istruzioni dei framework, salvati da soli; «Il kit», con la sua salute, la sua copia e la diagnostica. Come funziona
Leggi →Rimuovi l'unità
Chiude tutto ciò che il kit ha aperto, prima di staccare la chiavetta. Come funziona
Leggi →La barra di stato e il pannello «Attività»
| Elemento | Che cosa dice | Che cosa fa al clic |
|---|---|---|
| Atollo (a sinistra) | Passandoci sopra mostra la cartella del kit. | — |
| ▶ numero · ⨯ numero | Quante cose sono in esecuzione (azioni dei progetti, ogni versione dei database accesa, anche più d'una dello stesso database, i pool dei server web accesi e il server dei modelli locali) e quante azioni si sono fermate con un errore. Diventa rosso se c'è almeno un errore. | Apre o chiude il pannello «Attività». |
| Rotellina con testo | Un'installazione di componenti in corso e il passo che sta facendo. | — |
| Terminali aperti | Quante sessioni ha il pannello dei terminali dell'app. | Mostra o nasconde i terminali. |
| Editor attivo | Il server dell'editor è acceso (passandoci sopra, il suo indirizzo). | — |
| win32-x64, darwin-arm64… | Il sistema e il processore su cui gira il kit. | — |
| v0.x.y | La versione di Atollo. | — |
Nel pannello «Attività» ogni voce si seleziona per vederne i dettagli: per un'azione di progetto lo stato, l'indirizzo e l'output in diretta, con «Apri nel browser», «Ferma» o, se è finita, «Togli»; per un database il nome, l'indirizzo, eventuali errori, il file di log e «Ferma»; per un pool dei server web l'indirizzo, i VirtualHost collegati e «Ferma»; per i modelli locali l'indirizzo, i modelli in memoria e «Ferma». «Ferma tutto», in alto, chiede «Fermare le azioni dei progetti, i database, i modelli locali e i server web in esecuzione?» e poi ferma azioni, database, modelli locali e pool. Se non c'è niente compare «niente in corso». Il pannello si ridimensiona trascinandone il bordo; un doppio clic sul bordo lo riporta all'altezza iniziale.
Scorciatoie e abitudini utili
| Tasti | Che cosa fa |
|---|---|
| Ctrl+P | Apre «Apri un progetto» (⌘P su macOS): scrivi parte del nome, della piattaforma o del linguaggio. Invio apre la pagina del progetto, Maiusc+Invio avvia la sua azione predefinita, Esc chiude. |
| Ctrl+Shift+P | Apre «Comandi», la palette dei comandi (⌘⇧P su macOS), da qualsiasi pagina e anche da un terminale. Offre «Avvia» o «Ferma» e «Apri» per ogni progetto, «Apri … nell'editor», ogni agente installato in un progetto, «Avvia» o «Ferma» per MySQL e MongoDB, «Vai a» per le altre pagine e, quando qualcosa è in corso, «Ferma tutto». Ogni parola scritta deve comparire, in qualsiasi ordine; ↑ e ↓ scelgono, Invio esegue, Esc chiude. |
| Esc | Chiude le finestre di conferma e lo zoom delle immagini, e annulla le domande nella pagina (per esempio quella di «Ferma tutto» o della rimozione di un terminale). |
- Passa il mouse sopra icone, pallini e etichette: quasi tutto ha un suggerimento che spiega che cosa è o che cosa fa.
- Lingua e tema si cambiano in Impostazioni › Generale › «Lingua» e «Tema»: di base il tema chiaro o scuro segue quello del sistema operativo, e vale anche per l'editor e i terminali.
- L'icona a forma di libro nella barra laterale di ogni pagina apre l'argomento della guida che la spiega.