OpenSpec

Worksets (beta) ​

Abre el store y los repos que lo usan en una sola ventana del editor, para que tu agente vea ambos.

Con un store, el contexto que tu agente necesita está dividido entre carpetas. Los specs y cambios viven en el store, y el código vive en cada repo. Un agente iniciado en un repo puede leer y hacer grep en ese repo y en nada más, por lo que trabaja con la mitad del panorama.

Los worksets son la utilidad que OpenSpec proporciona para esto. Un workset es una lista guardada y con nombre de carpetas que abres juntas. Esta página asume que el store ya está configurado y registrado en tu máquina. Stores (beta) cubre eso.

Cómo funciona ​

  • Qué es: una lista de carpetas con nombre, guardada solo en tu máquina. No se escribe nada en las carpetas miembros, y no se hace commit de nada.
  • Qué hace abrir: OpenSpec genera un archivo .code-workspace a partir de la lista y abre tu editor con él. Cada carpeta miembro está en una sola ventana.
  • Qué obtienes: la búsqueda de tu editor, y cualquier agente que ejecutes dentro de esa ventana, puede leer cada carpeta miembro. El agente puede hacer grep en los specs del store y el código del repo en una sola sesión.
  • Qué no cambia: qué carpeta openspec/ usa un comando. Eso sigue siguiendo Dónde se crean los artefactos.

Configúralo ​

  1. Guarda el workset (una vez por máquina). Enumera el repo y el store como miembros, y la herramienta para abrirlos:

    bash
    # guarda una lista con nombre de carpetas que abres juntas
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Workset 'platform' guardado (2 miembros) en tu máquina.
Ábrelo en cualquier momento con: openspec workset open platform

  2. Ábrelo cada vez que comiences a trabajar:

    bash
    # abre cada miembro en una sola ventana de VS Code
openspec workset open platform

openspec workset list muestra lo que guardaste, y openspec workset remove <name> elimina un workset sin tocar las carpetas miembros:

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

Úsalo: un cambio, dos carpetas ​

Digamos que el cambio add-login vive en el store team-plans, y el código para él vive en web-app. Abre el workset platform y pide a tu agente que implemente el cambio. En esa única sesión puede:

  • leer team-plans/openspec/changes/add-login/ y los specs junto a él
  • editar el código en web-app/
  • ejecutar comandos openspec desde dentro de web-app

Sin el workset, el agente solo ve la carpeta en la que fue iniciado.

Herramientas incluidas ​

  • VS Code (--tool code) y Cursor (--tool cursor): incluidos de fábrica. Cada uno abre una ventana con cada carpeta miembro.
  • Claude Code y Codex en la terminal: temporalmente deshabilitados como abridores de worksets mientras se rehace ese flujo. --tool claude o --tool codex se detiene con un error que lo indica y te dirige a VS Code o Cursor.
  • Otros editores: agrégalos bajo la clave openers en Configuración de CLI (config.json).