Avvia LaunchRepo in tre passaggi

Configurazione consigliata: per ottenere i risultati migliori con LaunchRepo, ti consigliamo vivamente di usare sempre Claude Code CLI o Codex CLI in un terminale, anziché l’app desktop di Claude o di Codex. È il workflow che consigliamo, non una garanzia di permessi diversi o di un’esecuzione senza interruzioni.

La pagina di avvio del toolkit sta in una schermata: clona, incolla un prompt, apri un link. Questa guida ripercorre gli stessi tre passaggi con un po’ più di contesto su cosa succede dietro ciascuno, così sai cosa sta facendo il tuo agente e cosa controllare quando ha finito. Se prima vuoi il quadro d’insieme, la pagina su come funziona mostra dove si collocano questi passaggi nel flusso completo prodotto → agente → directory → tracker.

Cosa ti serve prima di iniziare

Per la configurazione iniziale:

• Git per clonare il repository.
• Python 3.10 o successivo su Windows, macOS o Linux. Gli script del workspace, il tracker e la dashboard locale usano solo la libreria standard di Python: non c’è nulla da installare con pip install e nessuno step di build.
• Un coding agent in grado di leggere file ed eseguire comandi: Claude Code, Codex, Cursor o uno strumento simile. Ognuno ha la propria pagina di configurazione su questo sito, per esempio Claude Code, Codex e Cursor. Il controllo del browser arriva più avanti e non serve per i primi tre passaggi.

Il repository arriva come invito GitHub per l’account che hai indicato al checkout. Tutto ciò che segue presuppone che tu l’abbia accettato.

Passaggio 1: clona e apri

Su Windows, nei comandi seguenti usa py -3 al posto di python3 (oppure python, se è quello il tuo comando per Python 3.10+). Tieni il workspace in una cartella locale privata, fuori da OneDrive o da altre cartelle sincronizzate.

git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo

Apri quella cartella nel tuo agente come faresti con qualsiasi progetto. Non parte ancora nulla. Il checkout che hai appena creato è il repository di consegna: playbook, template, script e documentazione. I tuoi prodotti, le credenziali e i record degli invii non staranno qui: è proprio lo scopo del passaggio 2.

Passaggio 2: incolla il prompt di avvio

Incolla questo nell’agente, alla lettera:

Read AGENTS.md, then follow “Start the dashboard for the owner”. Create my private workspace if I do not have one yet, start the dashboard, and give me the link.

AGENTS.md è il file che ogni AI coding agent legge per primo; contiene la procedura di avvio esatta e i controlli che l’agente deve eseguire. Seguendola, l’agente:

1. crea un workspace privato accanto al checkout (di default una cartella allo stesso livello) con scripts/init-workspace.py, così i dati del tuo prodotto non finiscono mai nel repository di consegna condiviso;
2. avvia la dashboard locale dall’interno di quel workspace;
3. risponde con un link 127.0.0.1.

Se l’agente risponde con un link, il passaggio 2 ha funzionato. Se risponde descrivendo cosa farebbe, chiedigli di eseguire davvero la procedura: la regola del toolkit è che un controllo è completo solo quando è stato osservato, non quando esistono le istruzioni.

Passaggio 3: apri il link

Il resto della prima sessione si svolge nel tab della dashboard. Da lì aggiungi il tuo primo prodotto, ripassi il prompt di onboarding al tuo agente, vedi quali schede sono live, in attesa, programmate o aspettano te, e copi i prompt per le run successive. La dashboard si collega solo a 127.0.0.1 e non contatta mai una directory; la guida alla dashboard locale descrive ogni schermata.

Quando hai finito, premi Ctrl+C nel terminale dell’agente oppure chiedi all’agente di fermare il server. Il workspace e tutto ciò che vi è registrato restano su disco.

Farlo a mano

Per la configurazione in sé non ti serve l’agente. I tre comandi che il prompt esegue sono:

python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py

Vuoi dare un’occhiata prima di impegnarti con un workspace? python3 scripts/dashboard.py --demo serve un workspace di esempio usa e getta con un prodotto fittizio, così puoi navigare nella panoramica, in una pagina prodotto e nel catalogo senza toccare i tuoi dati.

Cosa succede dopo

La prima sessione vera e propria (brief di prodotto, connessione del browser, permessi e un obiettivo di run salvato) è guidata dall’agente ed è descritta nella guida all’onboarding della prima sessione. Prima che l’agente possa compilare un modulo devi anche collegarlo al tuo Chrome. Se preferisci leggere prima un racconto, la guida pratica con Claude Code segue un lancio dall’inizio alla fine. Completato l’onboarding, una run di lancio dall’inizio alla fine mostra come si svolge ogni run successiva, dal controllo dei permessi alla ripresa delle piattaforme rimanenti.