Worksets (beta)

Abra a store e os repositórios que a usam em uma única janela do editor, para que seu agente veja ambos.

Com um store, o contexto que seu agente precisa fica dividido entre pastas. As especificações e alterações ficam no store, e o código fica em cada repositório. Um agente iniciado em um repositório pode ler e usar grep apenas nesse repositório, portanto trabalha com metade da visão.

Worksets são o utilitário que o OpenSpec oferece para isso. Um workset é uma lista nomeada e salva de pastas que você abre juntas. Esta página pressupõe que o store já está configurado e registrado na sua máquina. Stores (beta) cobre isso.

Como funciona

• O que é: uma lista nomeada de pastas, salva apenas na sua máquina. Nada é gravado nas pastas dos membros e nada é commitado.
• O que a abertura faz: o OpenSpec gera um arquivo .code-workspace a partir da lista e abre seu editor nele. Cada pasta membro fica em uma única janela.
• O que você obtém: a busca do seu editor, e qualquer agente executado dentro dessa janela, pode ler todas as pastas membros. O agente pode usar grep nas especificações do store e no código do repositório em uma única sessão.
• O que não muda: qual pasta openspec/ um comando usa. Isso ainda segue Onde os artefatos são criados.

Configurar

1. Salve o workset (uma vez por máquina). Liste o repositório e o store como membros, e a ferramenta com a qual abri-los:

   # salva uma lista nomeada de pastas que você abre juntas
   openspec workset create platform \
     --member ~/src/web-app \
     --member ~/openspec/team-plans \
     --tool code

   Workset 'platform' (2 members) salvo na sua máquina.
   Abra-o a qualquer momento com: openspec workset open platform

2. Abra-o sempre que iniciar o trabalho:

   # abre cada membro em uma única janela do VS Code
   openspec workset open platform

openspec workset list mostra o que você salvou, e openspec workset remove <name> exclui um workset sem afetar as pastas membros:

platform  (abre no VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Use-o: uma alteração, duas pastas

Digamos que a alteração add-login esteja no store team-plans, e o código para ela esteja em web-app. Abra o workset platform e peça ao seu agente para implementar a alteração. Nessa única sessão ele pode:

• ler team-plans/openspec/changes/add-login/ e as especificações próximas a ela
• editar o código em web-app/
• executar comandos openspec de dentro de web-app

Sem o workset, o agente vê apenas a pasta em que foi iniciado.

Ferramentas prontas para uso

• VS Code (--tool code) e Cursor (--tool cursor): integrados. Cada um abre uma janela com todas as pastas membros.
• Claude Code e Codex no terminal: temporariamente desabilitados como abridores de workset enquanto esse fluxo é refeito. --tool claude ou --tool codex para com um erro que informa isso e aponta para VS Code ou Cursor.
• Outros editores: adicione-os sob a chave openers nas configurações da CLI (config.json).