8. Come funziona dentro
8.2 Le cartelle del kit su disco
projects e data: che cosa c'è in ogni cartella, quali file sono tuoi, quali del kit e quali sono protetti.
In breve
- Tutto sta nella cartella del kit: l'eseguibile, projects (tuo) e data (del kit).
- In data i programmi sono separati per sistema; il resto è in comune fra Windows, macOS e Linux.
- Le cartelle con password sono leggibili solo dal tuo utente (sui dischi NTFS).
Le cartelle
- Cartella progetti
projects\- Agenti condivisi
data\agents\- Dati database
data\db\- Backup database
data\projects\<progetto>\private\backups\
| Cartella o file | Che cosa contiene |
|---|---|
<cartella del kit>\ | La cartella che contiene l'eseguibile, per esempio D:\Atollo. |
Atollo.exe | L'unico programma: è l'app con la finestra e anche la riga di comando. Su macOS Atollo.app, su Linux l'AppImage. |
projects\ | I tuoi progetti, una cartella ciascuno. È tuo: il kit non ci scrive senza che tu lo chieda. |
data\ | Tutto ciò che è del kit. |
app\ | Lo stato dell'app: settings.json (Impostazioni), secrets\ (la chiave di Gemini, quella del server dei modelli locali e il token di Hugging Face, protetti), llm.json e llm\presets.ini (il server dei modelli locali), ca-bundle.pem (i certificati, se le Impostazioni hanno un file PEM), components.txt (componenti scelti), versions\ (versioni installate), logs\, services.json e servers.json (database e server web, con le porte di ogni versione e di ogni pool), terminals.json, frameworks.json, root.txt (ultima cartella del kit), safe-directory.txt (l'ultimo safe.directory scritto dal kit). |
app\db\ | Password di amministratore dei database e accessi di mysql. Protetta: la legge solo il tuo utente. |
app\diagnostics\ | Gli zip di «Esporta diagnostica» (atollo-diagnostica-<data-ora>.zip), da allegare a una segnalazione: segreti mascherati, restano sul PC. |
apps\<sistema>\ | I programmi, per sistema (win32-x64, darwin-arm64…), una cartella per componente e per versione. |
projects\<progetto>\ | I dati del kit per ogni progetto: dev-settings.json (versioni, estensioni, preferiti), ports.json (le porte delle sue azioni), configurazioni di Apache e Caddy (le tue direttive in apache\conf.d\*.conf e caddy\conf.d\*.caddy valgono sia per il server tutto suo sia in un pool), private\ (password e copie dei database, protetta). |
db\<mysql|mongodb>\<versione>\ | I dati dei database, una cartella per versione. |
models\gguf\<proprietario>--<nome>\ | I modelli locali (file GGUF), una cartella per repository di Hugging Face, una sola copia per Windows, macOS e Linux; atollo.json dice che cosa ha scaricato il kit. |
servers\<pool>\ | Le configurazioni generate dei server web condivisi. |
agents\ | Ciò che gli agenti condividono: AGENTS.md, skills\, mcp.json, e lo stato dell'allineamento in .sync\. |
antigravity\ | L'accesso di Antigravity conservato nel kit (keyring.json). |
home\ | La «cartella utente» dei programmi del kit: .claude, .codex, .gemini, .pi (profili degli agenti), .gitconfig, .npmrc, AppData (su Windows). |
gh\ | L'accesso di GitHub CLI (hosts.yml). |
vscodium-server\ | Impostazioni ed estensioni del server dell'editor. |
kit\ | File che il kit riscrive a ogni avvio: profilo della PowerShell, comandi di supporto (agy, mysql, gradle). |
cache\ | Cache dei gestori di pacchetti (npm, pip, uv, Composer, Go, NuGet…) e delle risposte di GitHub. Si può cancellare. |
python-user\, npm-global\, composer\, go\, gradle\… | Pacchetti e strumenti installati globalmente con pip, npm, Composer, Go e gli altri. |
tmp\ | File temporanei, quando le Impostazioni li vogliono nel kit. |
webview2\ | I dati della finestra dell'app. |
Che cosa è tuo e che cosa è del kit
| Puoi modificare a mano | Meglio lasciare al kit |
|---|---|
| Tutto in projects; data\agents (istruzioni, skill, mcp.json); data\home\.gitconfig | data\app, data\apps, data\kit, data\servers, data\db: li gestisce il kit, e alcuni vengono riscritti a ogni avvio |
Sotto il cofano
- Cartelle protette (solo il tuo utente, su NTFS; permessi 700 su macOS e Linux): data\app\db, data\app\secrets, data\projects\<progetto>\private, data\agents\claude, data\tmp quando è la cartella temporanea di Claude.
- Su exFAT e FAT32 i permessi non esistono: il kit funziona, ma quelle cartelle non sono protette.
- I file di configurazione vengono scritti in modo sicuro: prima un file temporaneo, poi la sostituzione, così un'interruzione non lascia file a metà.
- data\kit viene riscritta a ogni avvio: non metterci file tuoi.