OpenSpec

Worksets (beta) ​

Öffnen Sie den Store und die Repos, die ihn verwenden, in einem Editor-Fenster, damit Ihr Agent beides sieht.

Bei einem Store ist der Kontext, den Ihr Agent benötigt, über mehrere Ordner verteilt. Die Specs und Änderungen liegen im Store, und der Code liegt in jedem Repo. Ein Agent, der in einem Repo gestartet wird, kann dieses Repo lesen und mit grep durchsuchen – und nichts anderes, sodass er mit nur halbem Bild arbeitet.

Worksets sind das Werkzeug, das OpenSpec hierfür bereitstellt. Ein Workset ist eine gespeicherte, benannte Liste von Ordnern, die Sie gemeinsam öffnen. Diese Seite setzt voraus, dass der Store bereits eingerichtet und auf Ihrem Rechner registriert ist. Stores (beta) behandelt das.

Wie es funktioniert ​

  • Was es ist: eine benannte Liste von Ordnern, die nur auf Ihrem Rechner gespeichert wird. Nichts wird in die Mitgliedsordner geschrieben, und nichts wird committet.
  • Was das Öffnen bewirkt: OpenSpec generiert aus der Liste eine .code-workspace-Datei und startet Ihren Editor damit. Jeder Mitgliedsordner liegt in einem Fenster.
  • Was Sie erhalten: die Suche Ihres Editors und jeder Agent, den Sie in diesem Fenster ausführen, können jeden Mitgliedsordner lesen. Der Agent kann die Specs des Stores und den Code des Repos in einer Sitzung mit grep durchsuchen.
  • Was es nicht ändert: welchen openspec/-Ordner ein Befehl verwendet. Das folgt weiterhin Wohin Artefakte erstellt werden.

Einrichten ​

  1. Speichern Sie das Workset (einmal pro Rechner). Listen Sie das Repo und den Store als Mitglieder auf sowie das Werkzeug, mit dem sie geöffnet werden sollen:

    bash
    # speichert eine benannte Liste von Ordnern, die Sie gemeinsam öffnen
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Saved workset 'platform' (2 members) to your machine.
Open it any time with: openspec workset open platform

  2. Öffnen Sie es, wann immer Sie mit der Arbeit beginnen:

    bash
    # öffnet jedes Mitglied in einem VS Code-Fenster
openspec workset open platform

openspec workset list zeigt, was Sie gespeichert haben, und openspec workset remove <name> löscht ein Workset, ohne die Mitgliedsordner anzutasten:

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

Verwendung: eine Änderung, zwei Ordner ​

Angenommen, die Änderung add-login liegt im Store team-plans, und der dazugehörige Code liegt in web-app. Öffnen Sie das Workset platform und bitten Sie Ihren Agenten, die Änderung zu implementieren. In dieser einen Sitzung kann er:

  • team-plans/openspec/changes/add-login/ und die danebenliegenden Specs lesen
  • den Code in web-app/ bearbeiten
  • openspec-Befehle aus web-app heraus ausführen

Ohne das Workset sieht der Agent nur den Ordner, in dem er gestartet wurde.

Werkzeuge im Lieferumfang ​

  • VS Code (--tool code) und Cursor (--tool cursor): integriert. Jedes öffnet ein Fenster mit allen Mitgliedsordnern.
  • Claude Code und Codex im Terminal: vorübergehend als Workset-Öffner deaktiviert, während dieser Ablauf überarbeitet wird. --tool claude oder --tool codex bricht mit einem Fehler ab, der dies mitteilt und Sie auf VS Code oder Cursor verweist.
  • Andere Editoren: fügen Sie sie unter dem Schlüssel openers in den CLI-Einstellungen (config.json) hinzu.