> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Lascia configurare tutto a un agente Incolla un prompt già pronto in un agente di codifica, lascia che esegua la configurazione Desktop sul tuo computer e controlla il report che scrive su ogni passaggio. ## Puoi delegare la parte noiosa Questo repository è stato scritto in modo che un agente di codifica possa leggerlo. Include un file mappa (`llms.txt`), un file di regole (`AGENTS.md`), note di memoria per file (`.ai/`) e skill per attività (`.agents/skills/`). Il checkout Desktop autonomo non include la cartella `prompts/`, quindi il prompt già pronto è stampato in questa guida — copialo da qui sotto invece di aprire un file. Delegare la digitazione non significa saltare i controlli. L'agente lavora dentro la tua copia del repository e deve riportare ciò che ha fatto con prove. Le sezioni qui sotto mostrano com'è fatto un buon report, così resti tu al comando del risultato. Questo percorso configura la shell Tauri e la sua connessione al backend Web — il server che gestisce account e dati. La finestra desktop mostra solo quel backend; se il tuo checkout contiene anche apps/web, l'agente può eseguirlo localmente, e un checkout solo Desktop necessita dell'indirizzo backend raggiungibile che ti è stato fornito. [Esegui l'app Desktop a mano invece](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md) ## Cosa ti serve prima Completa prima la guida di preparazione: Node.js, Git e un editor installati, l'invito GitHub accettato e la cartella supastack scaricata sul tuo computer. L'agente lavora dentro quella cartella, quindi vale ancora tutto ciò che c'è in [Prima di iniziare](https://supastack.dev/it/docs/desktop/before-you-start.md). Ti serve anche uno strumento che possa fare da agente di codice — un editor con un agente di codice AI integrato (un IDE AI) o un agente che gira nel tuo terminale (una CLI agent). Va bene qualsiasi strumento attuale con capacità da agente; il prompt specifica già cosa deve leggere ed eseguire, quindi non devi scrivere istruzioni da solo. Infine, decidi due cose che il prompt chiede: l'indirizzo del backend che la finestra deve caricare — http://localhost:3000 per un backend locale o il tuo indirizzo HTTPS fornito — e se Rust e gli strumenti di build nativi sono già installati su questo computer. ## Copia il prompt, compila due spazi vuoti, incolla Il prompt è il blocco di codice qui sotto — seleziona e copia l'intero blocco. Due segnaposto richiedono le tue scelte. Sostituisci `` con l'indirizzo del backend che la finestra deve caricare — http://localhost:3000 per un backend locale o il tuo indirizzo HTTPS fornito. Sostituisci `` con present quando rustc e cargo stampano già le versioni, o install quando l'agente deve prima installare Rust e gli strumenti di build del SO. I passaggi numerati restano esattamente come scritti. ``` Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at ****. 1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything. 2. Run rustc --version and cargo --version. On **** = install, install Rust and this OS's Tauri prerequisites first, then continue. 3. Run corepack pnpm install. 4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify answers from this computer and report its status. 5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works. 6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything. ``` ## Cosa fa l'agente con il prompt Il prompt indica all'agente la mappa, le regole e la checklist di sicurezza, poi gli dice di lavorare attraverso la configurazione in ordine e dimostrare ogni fase. In termini semplici, l'agente: - Legge la mappa del repository (`llms.txt`), le regole del progetto (`AGENTS.md`) e le regole di gestione delle credenziali (`docs/agent-security.md`) prima di toccare qualsiasi cosa. - Controlla la toolchain Rust e i prerequisiti Tauri di questo SO e riporta ciò che installa invece di fallire a metà di una compilazione. - Verifica che il backend risponda al tuo indirizzo — avviando `apps/web` da solo solo quando quella cartella esiste in questo checkout — invece di dare per scontato un server che non c'è. - Installa le dipendenze, compila la shell e apre la finestra, poi riporta il comportamento di finestra, tray e scorciatoia di richiamo con l'output reale. - Si ferma e riporta dopo che lo stesso passaggio fallisce due volte — non aggira un fallimento né elimina nulla senza chiedere. ## Cosa controlli nel report dell'agente Un buon report mostra prove, non affermazioni. Cerca l'URL del backend che risponde, l'installazione delle dipendenze completata, una compilazione Rust finita e una finestra aperta dietro ogni PASS — non una frase come 'tutto funziona'. Il prompt dice all'agente di fermarsi e riportare dopo che lo stesso passaggio fallisce due volte — non di aggirare il fallimento — e di chiederti prima di qualsiasi azione distruttiva. Se il tuo agente continua a improvvisare dopo fallimenti ripetuti, fermalo e porta il primo errore alla [guida alla risoluzione dei problemi](https://supastack.dev/it/docs/desktop/troubleshooting.md). Due cose non devono mai apparire: una funzionalità di sicurezza spenta per silenziare un errore, e un valore segreto come una password o una chiave stampato nella chat o nel report. Se ne vedi una, considera l'esecuzione fallita. Tieni separate nella tua mente la shell e il vero accesso. La finestra che mostra la homepage del tuo backend dimostra la shell — gli account reali hanno ancora bisogno del database del backend. 'La finestra si è aperta' non è ancora 'gli account funzionano'. ## Se preferisci farlo a mano Ogni passaggio che l'agente esegue è scritto nelle guide manuali qui sotto — gli stessi comandi, gli stessi controlli, al tuo ritmo. [Esegui l'app Desktop in 5 minuti](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md) [Leggi la configurazione completa della shell](https://supastack.dev/it/docs/desktop/run.md) [Risolvi un fallimento di configurazione](https://supastack.dev/it/docs/desktop/troubleshooting.md) ## Successivo [Avvia l’app desktop in 5 minuti](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md)