Workspace Spec

Workspace as Code

Todo tu entorno de desarrollo — terminales, comandos, editor y agentes — descrito por un solo archivo que commiteas con tu repo: .termpuzzle/workspace.yaml. La app lo escribe por ti.

Por qué un archivo

Un workspace que vive en git viaja con tu repo. Laptop nueva, branch nuevo, compañero nuevo — todo el entorno vuelve con un clone. La UI es una comodidad; la fuente de verdad es un archivo que puedes leer, diffear y revisar.

Ejemplo

.termpuzzle/workspace.yaml

version: 1
name: my-app
layout: grid

terminals:
  - label: api
    cwd: ./services/api
    command: npm run dev
  - label: web
    cwd: ./apps/web
    command: vite
  - label: claude
    cwd: .
    command: claude
    role: ai-agent

editor:
  app: vscode   # or cursor, insiders
  position: right

Campos

name, layout — la identidad del workspace y cómo se ordenan las ventanas.
terminals[] — el label, directorio de trabajo (cwd) y command de cada terminal. Una terminal con role: ai-agent se trata como ventana de agente.
editor — qué editor abrir (vscode, cursor, …) y su position en el layout.

Mira Arquitectura para saber cómo el motor de restore lee esto, o la documentación para empezar.