Cos'è GSD Pi e Come Può Rivoluzionare il Tuo Workflow di Sviluppo

Cosa fa GSD Pi

GSD Pi è un agente di codifica local-first utilizzabile dal terminale. Coordina l'intero ciclo di vita di un progetto—pianificazione, implementazione, verifica e tracciamento—da un'unica interfaccia a riga di comando, riducendo l'attrito del passaggio tra strumenti separati.

L'agente può:

• Pianificare il lavoro in milestone, slice e task.
• Eseguire sessioni di codifica con il contesto del progetto e verifica integrata.
• Utilizzare i worktree di Git per isolare le modifiche sperimentali.
• Tracciare lo stato in un database locale e produrre panoramiche in markdown.
• Supportare strumenti basati su estensioni e integrazioni con i provider.
• Generare artefatti come piani, riepiloghi e note di validazione.

Tutti i piani, le conversazioni e lo stato di esecuzione risiedono all'interno di una directory .gsd/, rimanendo completamente sulla tua macchina.

Per iniziare

Installa il pacchetto globalmente da npm:

npm install -g @opengsd/gsd-pi@latest

Il binario gsd diventa disponibile. Se in precedenza hai utilizzato la vecchia versione senza scope gsd-pi, segui prima i passaggi di migrazione indicati di seguito.

Al primo avvio con gsd, un flusso di configurazione interattivo ti consente di scegliere un provider di modelli, aprire una directory di progetto e inizializzare la configurazione. In alternativa, utilizza il configuratore web all'indirizzo https://pi.opengsd.net/ per creare una configurazione nel tuo browser prima ancora di avviare la CLI. Tutto lo stato viene memorizzato in .gsd/ nella radice del tuo progetto. Una guida dettagliata è disponibile nel file docs/user-docs/getting-started.md del repository.

Utilizzo pratico

Avvia GSD all'interno di qualsiasi progetto:

gsd

Controlla l'agente con i comandi slash. Esempi comuni:

/gsd config          # rivedi o modifica la configurazione
/gsd auto            # lascia che l'agente lavori autonomamente sul piano corrente
/gsd quick "Descrivi il task"
/gsd status          # mostra lo stato del progetto e della sessione

Un flusso di lavoro tipico: 1. Apri il tuo progetto con gsd. 2. Pianifica il lavoro in milestone e slice. 3. Avvia sessioni di codifica in cui l'agente crea un worktree Git, implementa le modifiche, esegue la verifica e produce un riepilogo. 4. Esamina gli artefatti e lo stato del progetto tracciati in .gsd/.

L'agente comprende la struttura dei tuoi file, coordinando l'implementazione in più fasi con una supervisione minima.

Configurazione e opzioni

• Flusso di configurazione – al primo avvio, gsd ti guida interattivamente attraverso la selezione del provider e l'inizializzazione del progetto.
• Configuratore web – crea la tua configurazione all'indirizzo https://pi.opengsd.net/ prima ancora di eseguire la CLI.
• Configurazione in sessione – utilizza /gsd config per modificare le impostazioni dopo la configurazione iniziale.
• Archiviazione dello stato – tutti i dati di pianificazione, le sessioni dell'agente e gli artefatti risiedono nella directory .gsd/ all'interno della radice del progetto.

Nel README non sono documentate variabili d'ambiente o file di configurazione esterni.

Limitazioni note

Il README non elenca casi d'uso non supportati, casi limite o bug noti. Il progetto è alla versione 1.0.0 con una nuova baseline di sviluppo. La cronologia delle versioni precedenti è stata archiviata, pertanto le informazioni sulle limitazioni pre‑1.0 non fanno parte della documentazione attuale.

Migrazione da installazioni precedenti

GSD Pi è ora pubblicato come @opengsd/gsd-pi. Se in precedenza hai installato il pacchetto gsd-pi senza scope, devi rimuoverlo e pulire i file residui prima di eseguire l'aggiornamento. In questo modo si evita che il vecchio binario oscuri quello nuovo.

Dopo la migrazione puoi utilizzare il comando integrato gsd upgrade per gli aggiornamenti futuri. In alternativa, avvia direttamente il programma di installazione:

npx @opengsd/gsd-pi@latest

In caso di problemi, consulta docs/user-docs/troubleshooting.md#upgrade-from-older-gsd-pi-installs.

npm uninstall -g gsd-pi
rm -f ~/.gsd/.update-check ~/.gsd/agent/managed-resources.json
npm install -g @opengsd/gsd-pi@latest
which gsd
gsd --version

npm uninstall -g gsd-pi
Remove-Item "$env:USERPROFILE\.gsd\.update-check" -Force -ErrorAction SilentlyContinue
Remove-Item "$env:USERPROFILE\.gsd\agent\managed-resources.json" -Force -ErrorAction SilentlyContinue
npm install -g @opengsd/gsd-pi@latest
where.exe gsd
gsd --version