Saltar a contenido

Configurar el Workspace

Un workspace es una carpeta con los repositorios de tus servicios adentro (o al lado). Creás el workspace una vez y registrás cada repositorio como miembro.

Comandos en Codex

Los comandos de abajo aparecen con / (Claude Code y Cursor). En Codex, cambiá el prefijo por $ — ej.: /n45 → $n45.

Crear el workspace

En la carpeta que contiene (o va a contener) los repositorios, corré:

npx n45-ai@latest init
  • Si la carpeta ya tiene subcarpetas que son repositorios git, N45 detecta el workspace automáticamente y va directo al setup de workspace.
  • Si no, pregunta ¿Project o Workspace? — elegí Workspace.

El nombre del workspace es el nombre de la carpeta (sin preguntar). Después N45 pregunta qué herramientas de IA usás (Claude Code, Cursor, Codex) e instala las skills.

Agregar los miembros

Al final del init, N45 lista las carpetas git que encontró y ofrece agregarlas como miembros — todas ya preseleccionadas. Solo confirmás (o desmarcás las que no quieras).

También agregás miembros en cualquier momento:

# agregar un repositorio existente (ruta local)
npx n45-ai@latest workspace add ./frontend

# clonar y agregar desde una URL git
npx n45-ai@latest workspace add git@github.com:acme/api.git

# adoptar de una vez todas las carpetas git aún no registradas
npx n45-ai@latest workspace add --all

Al agregar un miembro, N45 prepara el repositorio automáticamente: crea el .n45/ del miembro e instala las skills de las herramientas de IA que usa el workspace. El miembro queda listo sin init manual.

El miembro tiene que ser un repositorio git

workspace add <ruta> exige que la ruta sea un repositorio git de verdad. Si todavía no lo es, corré git init ahí antes (o apuntá a un repositorio existente).

Gestionar los miembros

# listar los miembros
npx n45-ai@latest workspace list

# quitar el registro de un miembro (no borra el repositorio)
npx n45-ai@latest workspace remove frontend

# reconciliar: clona los miembros declarados que faltan + adopta carpetas git huérfanas
npx n45-ai@latest workspace sync
  • remove es seguro: solo quita el registro del workspace, no borra nada. Bloquea si el miembro participa de una feature en curso (finalizá o cancelá la feature antes).
  • sync sirve al clonar el repositorio del workspace en una máquina nueva: clona los miembros que faltan y adopta las carpetas git que todavía no son miembros.

Qué queda versionado

El workspace es en sí un repositorio git, pero versiona solo la coordinación — el .n45/ del workspace (specs, contracts, docs de la feature). Los miembros son repositorios independientes y quedan afuera automáticamente: creás, clonás y editás las carpetas de los miembros libremente, y solo entran al workspace cuando corrés workspace add.

Ver también