Saltar a contenido

n45-ai init

Configura N45 en la carpeta actual — como Project o Workspace.

Synopsis

npx n45-ai@latest init [--kind project|workspace] [--tool claude,cursor,codex]

Requisitos previos

  • Node.js 22 o superior
  • Git instalado en tu máquina
  • Una licencia N45.AI activa y un npx n45-ai@latest login previo

Descripción

init primero pregunta qué estás configurando:

  • Project — un único repositorio (una app, un microservicio, un monorepo).
  • Workspace — un grupo de repositorios, polyrepo (mirá la sección Workspace).

Si la carpeta ya tiene subcarpetas que son repositorios git (candidatas a miembro), init detecta un Workspace automáticamente y omite la pregunta — usá --kind project para sobrescribir.

Luego pregunta qué asistentes de IDE usás (Claude Code, Cursor o Codex) y configura:

  • Project — crea el directorio .n45/, la configuración de la IDE (.claude/, .cursor/ o .codex/) y los slash commands (/n45, /n45-feat, /n45-fix, /n45-status, /n45-run, /n45-next).
  • Workspace — crea el .n45/ de coordinación (el nombre del workspace es el nombre de la carpeta, sin preguntar), luego lista las carpetas git que encontró y ofrece agregarlas como miembros, todas preseleccionadas — solo confirmás. Cada miembro se prepara automáticamente. Mirá Configurar el Workspace para el flujo completo.

init no descarga el binario — eso ocurre en el primer uso (login, status o un slash command), o explícitamente vía install.

Debe ejecutarse desde la raíz de tu proyecto (o la carpeta del workspace). Requiere un npx n45-ai@latest login previo — que a su vez requiere una licencia activa.

No-interactivo

Pasá flags para omitir los prompts (útil en scripts/CI):

  • --kind project|workspace — omite la pregunta Project/Workspace.
  • --tool <a,b> — las herramientas de IDE (repetible o separado por coma); omite el prompt de herramientas.
npx n45-ai@latest init --kind workspace --tool claude,cursor

¿Ya configurado con otra versión?

Si el proyecto ya tiene skills de N45 y una carpeta .n45/ de una versión diferente, init se detiene y te pide ejecutar upgrade primero. Esto garantiza que el .n45/ del proyecto se migre antes de que las skills sean reemplazadas — ejecutar skills nuevas contra un .n45/ de schema antiguo lo corrompería. Re-ejecutar init en la misma versión es seguro (ej: agregar otra IDE).

Qué modifica

Archivo / carpeta Acción
.n45/ Creado (un proyecto o un workspace, según tu elección)
.claude/ Creado (skills + settings)
.cursor/ Creado (skills + cli.json + .cursorignore)
.codex/ Creado (skills + permisos)

En un workspace, cada miembro que agregás también obtiene su propio .n45/ y las skills, configurados automáticamente. Tus configuraciones existentes se preservan cuando N45 actualiza un archivo compartido.

Ejemplos

# un proyecto single-repo (interactivo)
cd /ruta/a/tu/proyecto
npx n45-ai@latest init

# un workspace (auto-detectado si la carpeta ya tiene repos git dentro)
cd /ruta/a/tu/workspace
npx n45-ai@latest init

Mira también