Workset (beta)

Apri il repository e i progetti che lo utilizzano in un'unica finestra dell'editor, così il tuo agente li vede entrambi.

Con un repository, il contesto di cui il tuo agente ha bisogno è suddiviso tra più cartelle. Le specifiche e le modifiche risiedono nel repository, mentre il codice si trova in ogni progetto. Un agente avviato in un progetto può leggere e analizzare solo quel progetto e nient'altro, quindi opera con metà delle informazioni.

I workset sono lo strumento che OpenSpec offre per questo. Un workset è un elenco salvato e denominato di cartelle che apri insieme. Questa pagina presuppone che il repository sia già configurato e registrato sul tuo computer. Repository (beta) tratta questo argomento.

Come funziona

• Che cos'è: un elenco denominato di cartelle, salvato solo sul tuo computer. Non viene scritto nulla nelle cartelle membri e non viene eseguito alcun commit.
• Cosa fa l'apertura: OpenSpec genera un file .code-workspace dall'elenco e avvia l'editor su di esso. Ogni cartella membro si trova in un'unica finestra.
• Cosa ottieni: la ricerca del tuo editor e qualsiasi agente esegui all'interno di quella finestra possono leggere ogni cartella membro. L'agente può analizzare le specifiche del repository e il codice del progetto in una sola sessione.
• Cosa non cambia: quale cartella openspec/ viene utilizzata da un comando. Questa segue ancora la logica descritta in Dove vengono creati gli artefatti.

Configurazione

1. Salva il workset (una volta per macchina). Elenca il progetto e il repository come membri e lo strumento con cui aprirli:

   # save a named list of folders you open together
   openspec workset create platform \
     --member ~/src/web-app \
     --member ~/openspec/team-plans \
     --tool code

   Saved workset 'platform' (2 members) to your machine.
   Open it any time with: openspec workset open platform

2. Aprilo ogni volta che inizi a lavorare:

   # open every member in one VS Code window
   openspec workset open platform

openspec workset list mostra ciò che hai salvato, e openspec workset remove <name> elimina un workset senza toccare le cartelle membri:

platform  (opens in VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Uso: una modifica, due cartelle

Supponi che la modifica add-login si trovi nel repository team-plans e che il codice corrispondente si trovi in web-app. Apri il workset platform e chiedi al tuo agente di implementare la modifica. In quella singola sessione può:

• leggere team-plans/openspec/changes/add-login/ e le specifiche adiacenti
• modificare il codice in web-app/
• eseguire comandi openspec dall'interno di web-app

Senza il workset, l'agente vede solo la cartella in cui è stato avviato.

Strumenti disponibili

• VS Code (--tool code) e Cursor (--tool cursor): integrati. Ciascuno apre una finestra con ogni cartella membro.
• Claude Code e Codex nel terminale: temporaneamente disabilitati come strumenti di apertura dei workset mentre quel flusso viene rielaborato. --tool claude o --tool codex si interrompe con un errore che lo segnala e ti indirizza verso VS Code o Cursor.
• Altri editor: aggiungili sotto la chiave openers in Impostazioni CLI (config.json).