OpenSpec

Worksets (bèta) ​

Open de store en de repos die deze gebruiken in één editorvenster, zodat je agent beide ziet.

Met een store is de context die je agent nodig heeft verdeeld over mappen. De specs en changes staan in de store, en de code staat in elke repo. Een agent die in één repo is gestart, kan die repo lezen en grep'en en niets anders, dus hij werkt met de helft van het beeld.

Worksets zijn de voorziening die OpenSpec hiervoor biedt. Een workset is een opgeslagen, benoemde lijst van mappen die je samen opent. Deze pagina gaat ervan uit dat de store al is ingesteld en geregistreerd op je machine. Stores (bèta) behandelt dat.

Hoe het werkt ​

  • Wat het is: een benoemde lijst van mappen, alleen opgeslagen op je machine. Er wordt niets in de lidmappen geschreven en er wordt niets gecommit.
  • Wat openen doet: OpenSpec genereert een .code-workspace-bestand uit de lijst en start je editor ermee. Elke lidmap staat in één venster.
  • Wat je krijgt: de zoekfunctie van je editor en elke agent die je in dat venster uitvoert, kunnen elke lidmap lezen. De agent kan de specs van de store en de code van de repo in één sessie doorzoeken (grep).
  • Wat het niet verandert: welke openspec/-map een opdracht gebruikt. Dat volgt nog steeds Waar artefacten worden aangemaakt.

Instellen ​

  1. Sla de workset op (één keer per machine). Geef de repo en de store op als leden, en de tool waarmee je ze opent:

    bash
    # sla een benoemde lijst van mappen op die je samen opent
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Workset 'platform' (2 leden) opgeslagen op je machine.
Open hem wanneer je wilt met: openspec workset open platform

  2. Open hem wanneer je aan het werk gaat:

    bash
    # open elk lid in één VS Code-venster
openspec workset open platform

openspec workset list toont wat je hebt opgeslagen, en openspec workset remove <name> verwijdert een workset zonder de lidmappen aan te raken:

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

Gebruik het: één change, twee mappen ​

Stel dat de add-login change in de team-plans store staat, en de code ervoor in web-app. Open de platform workset en vraag je agent om de change te implementeren. In die ene sessie kan hij:

  • team-plans/openspec/changes/add-login/ lezen en de specs ernaast
  • de code in web-app/ bewerken
  • openspec-opdrachten uitvoeren vanuit web-app

Zonder de workset ziet de agent alleen de map waarin hij is gestart.

Standaard tools ​

  • VS Code (--tool code) en Cursor (--tool cursor): ingebouwd. Elk opent één venster met elke lidmap.
  • Claude Code en Codex in de terminal: tijdelijk uitgeschakeld als workset-openers terwijl die flow wordt herwerkt. --tool claude of --tool codex stopt met een foutmelding die dat aangeeft en verwijst je naar VS Code of Cursor.
  • Andere editors: voeg ze toe onder de openers-sleutel in CLI-instellingen (config.json).