create-ragt-app

CLI oficial para inicializar aplicaciones empresariales modulares basadas en la arquitectura RAGT y su ecosistema de inteligencia de agentes (.agent).

Uso

Con npx / npm create

# Modo interactivo
npx create-ragt-app mi-proyecto

# O mediante npm create
npm create ragt-app mi-proyecto

Opciones y Flags

# Modo no interactivo con valores por defecto
npx create-ragt-app mi-proyecto -y

# Omitir instalacion automatica de dependencias
npx create-ragt-app mi-proyecto --skip-install

# Omitir inicializacion de repositorio Git
npx create-ragt-app mi-proyecto --skip-git

Requisitos de Entorno

• Node.js: Versión 18.0.0 o superior.
• OpenSpec CLI: Recomendado para el soporte completo de workflows y agentes (npm install -g @fission-codes/openspec).

Desarrollo Local

# Sincronizar plantilla y compilar
npm run build

# Probar ejecucion local
node ./bin/index.js test-app

Mantenimiento para futuras versiones

Cada vez que actualices la plantilla ragt-template o el código del CLI y quieras publicar una nueva versión:

cd packages/create-ragt-app
# 1. Incrementar la version (0.1.0 -> 0.1.1)
npm version patch
# 2. Compilar y sincronizar
npm run build
# 3. Publicar la actualizacion
npm publish

Solución de Problemas al Publicar

Error E404 / E401 al ejecutar npm publish

Si al ejecutar npm publish se presenta un error como el siguiente:

npm error code E404
npm error 404 Not Found - PUT https://registry.npmjs.org/create-ragt-app - Not found
npm error 404 The requested resource 'create-ragt-app@...' could not be found or you do not have permission to access it.

Este error suele deberse a que la sesión local de npm ha expirado o no está autenticada, provocando que el registro rechace la solicitud PUT.

Pasos de recuperación:

# 1. Comprobar la sesion activa
# Nota: Si devuelve E401 Unauthorized, las credenciales locales requieren renovacion.
npm whoami

# 2. Iniciar sesion nuevamente en npm
npm login

# 3. Confirmar que la cuenta activa corresponda al mantenedor del paquete (leom19)
npm whoami

# 4. Reintentar la publicacion
npm publish