Saltar a contenido

CLI

Aegis Spec tiene un CLI simple para gestionar la instalación y el ciclo de vida de los agentes en tu proyecto. Todos los comandos se ejecutan con npx aegis-spec en la raíz del proyecto.


Comandos disponibles

install

npx aegis-spec install

Instala Aegis Spec en el proyecto heredado actual. Detecta los motores presentes, pregunta tus preferencias y crea toda la estructura necesaria.

Úsalo una vez, en la raíz del proyecto que quieres analizar.


status

npx aegis-spec status

Muestra el estado actual del análisis: qué fase está en curso, qué agentes ya corrieron, qué falta completar.

Útil para tener una visión rápida antes de retomar una sesión.


update

npx aegis-spec update

Actualiza los agentes a la versión más reciente de Aegis Spec.

El comando es inteligente: verifica el manifiesto SHA-256 de cada archivo y nunca sobreescribe archivos que hayas personalizado.


add-agent

npx aegis-spec add-agent

Agrega un agente específico al proyecto. Útil si no instalaste todos los agentes en la instalación inicial y ahora quieres incluir, por ejemplo, el Data Master o el Design System.


add-engine

npx aegis-spec add-engine

Agrega soporte para un motor de IA que no estaba presente cuando instalaste.


uninstall

npx aegis-spec uninstall

Elimina Aegis Spec del proyecto: borra los archivos creados por la instalación.

Tus archivos quedan intactos

uninstall elimina solo lo que Aegis Spec creó. Ningún archivo original del proyecto es tocado. Las especificaciones generadas en aegis/ también se conservan por defecto. Los hooks instalados vía add-hooks también son eliminados.


add-hooks

npx aegis-spec add-hooks --engine claude-code

Instala hooks del Keeper en la config de la engine para que corra automáticamente tras cada edición. Muestra preview, pide confirmación, escribe.

Engines: claude-code, cursor, kimi-cli, codex, opencode. Ver Hooks.


remove-hooks

npx aegis-spec remove-hooks --engine claude-code
npx aegis-spec remove-hooks --all

Elimina hooks del Keeper. Otros hooks añadidos manualmente se preservan.


drift-check

npx aegis-spec drift-check

CI gate. Lee aegis/reports/drift.md y exit 1 si hay specs pendientes. Ver drift-check.