Pianificazione del lancio

La dashboard locale: il tuo workspace visto dall’agente

Cosa mostra la dashboard locale del toolkit (prodotti, onboarding, stati, passaggi di consegne, follow-up), come avviarla, cosa scrive e i limiti che rispetta.

La dashboard locale è una piccola web app che mostra il tuo workspace così come lo vede il tuo agente: i prodotti, cosa sa l’agente di ciascuno, l’avanzamento dell’onboarding, ogni stato di invio registrato, le cose che richiedono il tuo intervento e le date di follow-up. Gira solo sulla tua macchina, non contatta nessuna directory ed è stata aggiunta con la release del 15 settembre 2026 riportata nel changelog. Questa guida spiega come avviarla, a cosa serve ogni schermata e quali regole applica.

Avviarla

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.

python3 scripts/dashboard.py            # opens 127.0.0.1:8765 in your browser
python3 scripts/dashboard.py --demo     # explore a throwaway sample workspace
python3 scripts/dashboard.py --port 8790 --no-open

Usa solo la libreria standard di Python 3.10+: nessuna dipendenza, nessuno step di build. Avviala dal tuo workspace privato, la cartella creata da scripts/init-workspace.py. Se invece la avvii dal checkout di consegna condiviso, si limita a proporti di creare quel workspace. La strada più semplice resta il prompt di avvio della guida all’avvio in tre passaggi: l’agente crea il workspace, avvia il server e ti passa il link.

La panoramica

La prima schermata risponde prima di tutto alla domanda “cosa richiede il mio intervento?”: i passaggi di consegne per CAPTCHA e autenticazione a due fattori che l’agente non ha potuto completare, le piattaforme segnate come bloccate, i follow-up scaduti e l’onboarding non terminato. Sotto trovi i tuoi prodotti con i totali per gruppo di stati (da gestire, problemi, in revisione, programmati, live) e lo stato di salute del workspace letto da workspace.json. Se apri la dashboard solo una volta a settimana, è questa la pagina da guardare.

La pagina del prodotto

Ogni prodotto ha una checklist di preparazione generata da doctor.py, il riepilogo dell’ultima sessione, i suoi invii con i filtri, i controlli di onboarding, il brief di prodotto, l’identità, i permessi e le note. Una “vista agente” elenca quali file sono compilati e quali sono ancora vuoti: utile quando una sessione finisce in anticipo e vuoi sapere su cosa ti farà domande la prossima. Il vocabolario degli stati mostrato qui è quello del tracker; la voce di glossario sullo stato della scheda spiega il significato di ciascuno.

Pianificare e riprendere una run

Parti con un obiettivo di 10 nuovi invii confermati e un solo worker del browser. Il pianificatore costruisce la run a partire dai percorsi gratuiti pronti e salva anche un budget di tempo: 15 minuti per piattaforma e, di default, 150 minuti attivi in totale. Se i percorsi adatti sono meno del tuo obiettivo, ti propone la run più piccola e onesta.

Salva la run, poi copia il suo prompt nel tuo agente. Usa /goal se il tuo host lo supporta; altrimenti incolla lo stesso testo come un normale messaggio. La dashboard memorizza il piano e mostra il lavoro rimanente, ma non avvia worker dell’agente né esegue azioni nel browser. Un obiettivo non può scavalcare i limiti del provider o le verifiche che richiedono una persona.

Contano solo i nuovi invii confermati: in attesa di revisione, in coda, programmati o live, una volta per piattaforma. Bozze e schede già esistenti non contano. Riprendi una run salvata invece di avviarne una sostitutiva che dimentica i progressi precedenti. La guida alla run spiega completamento, passaggi di consegne e chiusura delle finestre.

Registrazione degli esiti, catalogo e prompt

Il modulo Record outcome scrive tramite scripts/record.py e applica esattamente le regole della riga di comando: uno solo degli stati previsti, niente link né segreti nelle note, un URL pubblico più la tua attestazione per live, una data di lancio uguale o successiva alla data minima per scheduled, e una sostituzione esplicita quando una riga esiste già. La guida alla registrazione degli esiti passa in rassegna ciascuna di queste regole e il motivo per cui esiste.

New product chiede il nome di un prodotto, suggerisce un nome di cartella modificabile con controlli su duplicati e nomi riservati, crea la cartella a partire da templates/project e ti fornisce il prompt di onboarding per il tuo agente oppure i moduli da compilare tu stesso. Catalog si apre sui percorsi gratuiti pronti verificati, con i percorsi con condizioni, solo di ricerca e non disponibili in viste separate; puoi cercare e filtrare, leggere qualsiasi playbook, sovrapporre lo stato di un prodotto e registrare direttamente dall’elenco. Agent prompts and docs mostra i prompt per l’agente con i pulsanti per copiarli e visualizza la documentazione del toolkit direttamente lì, così raramente devi aprire a mano i file markdown.

Cosa non farà mai

I limiti sono voluti, ed è bene conoscerli prima di affidarti alla dashboard:

  • Si collega solo a 127.0.0.1 e rifiuta le richieste cross-site.
  • Modifica solo i file JSON e markdown del prodotto che modifica anche l’agente. credentials.json viene mostrato come piattaforma, metodo e stato; i suoi valori non vengono mai inviati al browser.
  • Non invia nulla, non controlla un browser e non verifica una scheda. Registrare uno stato è una dichiarazione di chi opera, non una prova: la dashboard rende quella dichiarazione facile da fare e difficile da fare in modo sbagliato, niente di più.

La posizione della dashboard tra prodotto, agente e directory è illustrata nella pagina su come funziona. Se vuoi provarla senza un workspace tuo, --demo è il punto d’ingresso.

Il kit descritto in queste guide

LaunchRepo è un repository privato che esegue il tuo agente di coding: 299 playbook per le directory, gli script del workspace, il tracker e la dashboard locale. Paghi una volta e lanci ogni prodotto che crei.

Vedi i prezzi