Referencia

Comandos

Referencia del CLI rei agrupada por la tarea que resuelve. Todos los comandos aceptan rei <comando> --help.

22 comandos · 4 categorías

Códigos de salida

La convención general se aplica salvo que el comando documente sus propios códigos en el detalle. El código de salida es la señal que usa el workflow para saber si una verificación pasó.

Convención de códigos de salida del CLI
CódigoSignificado
0El comando terminó correctamente.
1Falló una comprobación o el comando no pudo completarse.
2Uso incorrecto: flag desconocido, repetido, sin valor o inválido.

Preparar el proyecto

Inicializar el arnés, generar subagentes nativos y comprobar el estado de la personalización.

Preparar el proyecto: comandos, qué hacen y flags
ComandoQué haceFlags
rei initInicializa el arnés en el proyecto: esqueleto, estructura de estado y git si falta. No sobrescribe archivos existentes.--help
rei init statusIndica qué documentación del proyecto falta por personalizar.—
rei init opencodeGenera los subagentes nativos de OpenCode y el comando /personalize.--check
rei init claudeGenera los subagentes nativos de Claude Code, /personalize y CLAUDE.md.--check
rei init --updateActualiza el arnés de un proyecto ya inicializado con detección de marcadores.--force
rei doctorDiagnóstico de solo lectura del arnés, los roles y la personalización pendiente.—

rei init

Inicializa el arnés en el proyecto: esqueleto, estructura de estado y git si falta. No sobrescribe archivos existentes.

Sintaxis

rei init

Flags

  • --helpMuestra la ayuda del comando.

Ejemplo

Shell
rei init

Códigos de salida

  • 0 Instalación completada.
  • 1 No pudo crear un archivo del esqueleto o de la estructura, o falló la generación o verificación de OpenCode o Claude.
  • 2 Uso incorrecto.

Notas

  • Si AGENTS.md ya existe, avisa y lo conserva sin cambios.
  • La personalización guiada se inicia con /personalize o invocando el rol initializer.

rei init status

Indica qué documentación del proyecto falta por personalizar.

Sintaxis

rei init status

Sin flags propios.

Ejemplo

Shell
rei init status

Códigos de salida

  • 0 No queda ningún documento pendiente.
  • 1 Queda algún documento por personalizar.

rei init opencode

Genera los subagentes nativos de OpenCode y el comando /personalize.

Sintaxis

rei init opencode

Flags

  • --checkComprueba la deriva sin escribir nada.

Ejemplo

Shell
rei init opencode

Códigos de salida

  • 0 Todos los archivos coinciden con la generación canónica.
  • 1 Falta alguno, no lleva la marca o difiere.

Notas

  • Los archivos llevan la marca GENERATED; no sobrescribe archivos ajenos y es idempotente.
  • Genera /personalize con agent: initializer y subtask: true.

rei init claude

Genera los subagentes nativos de Claude Code, /personalize y CLAUDE.md.

Sintaxis

rei init claude

Flags

  • --checkComprueba la deriva sin escribir nada.

Ejemplo

Shell
rei init claude

Códigos de salida

  • 0 Todos los archivos coinciden con la generación canónica.
  • 1 Falta alguno, no lleva la marca o difiere.

Notas

  • Los archivos llevan la marca GENERATED; no sobrescribe archivos ajenos y es idempotente.
  • CLAUDE.md importa AGENTS.md con @AGENTS.md.

rei init --update

Actualiza el arnés de un proyecto ya inicializado con detección de marcadores.

Sintaxis

rei init --update

Flags

  • --forceFuerza la actualización de los archivos generados.

Ejemplo

Shell
rei init --update

rei doctor

Diagnóstico de solo lectura del arnés, los roles y la personalización pendiente.

Sintaxis

rei doctor

Sin flags propios.

Ejemplo

Shell
rei doctor

Work Items y sesión

Crear, planificar, aprobar y mover un Work Item por sus estados.

Work Items y sesión: comandos, qué hacen y flags
ComandoQué haceFlags
rei new <id> <feature|task> [title]Crea un Work Item en estado pending con su identificador y tipo.—
rei sessionMuestra la sesión activa y su Work Item.—
rei session start <id> <tipo>Inicia la sesión de un Work Item solo si existe, el tipo coincide y está en pending.—
rei session archiveArchiva la sesión cuando el Work Item ya está cerrado.—
rei session resetRestablece current.md a su estado inicial.—
rei commit set <id> <campo>Registra el commit actual en base_commit o en last_review_commit.—
rei status set <id> <estado>Cambia el estado de un Work Item. done es terminal; salir de él requiere --force.--force
rei items statusLista cada Work Item con su tipo, estado, issue y base si existe enlace.—
rei item show <id>Muestra la ficha de un Work Item: metadatos, enlaces, documentos, sesión y validación.—

rei new <id> <feature|task> [title]

Crea un Work Item en estado pending con su identificador y tipo.

Sintaxis

rei new <id> <feature|task> [title]

Sin flags propios.

Ejemplo

Shell
rei new 2026-10-27_01-54__mi-feature feature "Mi primera feature"

rei session

Muestra la sesión activa y su Work Item.

Sintaxis

rei session

Sin flags propios.

Ejemplo

Shell
rei session status

rei session start <id> <tipo>

Inicia la sesión de un Work Item solo si existe, el tipo coincide y está en pending.

Sintaxis

rei session start <id> <tipo>

Sin flags propios.

Ejemplo

Shell
rei session start 2026-10-27_01-54__mi-feature feature

rei session archive

Archiva la sesión cuando el Work Item ya está cerrado.

Sintaxis

rei session archive

Sin flags propios.

Ejemplo

Shell
rei session archive

Códigos de salida

  • 0 Sesión archivada y current.md restablecido.
  • 1 El Work Item no está en un estado terminal o current.md no es coherente.

Notas

  • Solo archiva si meta.json está en done o blocked y el Estado de current.md coincide.
  • Mueve el resumen a history.md y restablece current.md.

rei session reset

Restablece current.md a su estado inicial.

Sintaxis

rei session reset

Sin flags propios.

Ejemplo

Shell
rei session reset

rei commit set <id> <campo>

Registra el commit actual en base_commit o en last_review_commit.

Sintaxis

rei commit set <id> <campo>

Sin flags propios.

Ejemplo

Shell
rei commit set 2026-10-27_01-54__mi-feature base_commit

rei status set <id> <estado>

Cambia el estado de un Work Item. done es terminal; salir de él requiere --force.

Sintaxis

rei status set <id> <estado>

Flags

  • --forcePermite una transición no estándar fuera de done.

Ejemplo

Shell
rei status set 2026-10-27_01-54__mi-feature ready

rei items status

Lista cada Work Item con su tipo, estado, issue y base si existe enlace.

Sintaxis

rei items status

Sin flags propios.

Ejemplo

Shell
rei items status

Códigos de salida

  • 0 Listado correcto.
  • 1 Hay más de un Work Item en in_progress; el mensaje nombra los implicados.

Notas

  • Marca con << ACTIVO el Work Item en in_progress.
  • Un links.json inválido se indica como nota y no impide el listado.

rei item show <id>

Muestra la ficha de un Work Item: metadatos, enlaces, documentos, sesión y validación.

Sintaxis

rei item show <id>

Sin flags propios.

Ejemplo

Shell
rei item show 2026-10-27_01-54__mi-feature

Códigos de salida

  • 0 La ficha se muestra sin fallos de validación.
  • 1 Hay al menos un [FAIL] de validación.

Notas

  • La sección Enlaces muestra issue, URL, base (branch @ sha) y épica desde links.json.
  • Si links.json falta es una nota; si es inválido se indica como nota y se ignora.

Verificación y revisión

Comprobar la coherencia del arnés, revisar el diff y abrir el visor local.

Verificación y revisión: comandos, qué hacen y flags
ComandoQué haceFlags
rei validate [<id>]Comprueba la consistencia interna de un Work Item. Un links.json inválido es un aviso recuperable.—
rei checkVerifica el arnés y ejecuta los checks declarados en .rei/config.json.--quiet, -q
rei testEjecuta los checks declarados en .rei/config.json.—
rei review-diff <id>Genera el paquete de revisión con los cambios reales del Work Item.--full
rei view [<id>]Abre el visor local de solo lectura: documentos, validación, sesión, TOC, diff y FICHA.--open--stop--enable--disable

rei validate [<id>]

Comprueba la consistencia interna de un Work Item. Un links.json inválido es un aviso recuperable.

Sintaxis

rei validate [<id>]

Sin flags propios.

Ejemplo

Shell
rei validate 2026-10-27_01-54__mi-feature

Códigos de salida

  • 0 No hay ningún [FAIL].
  • 1 Hay al menos un [FAIL].

Notas

  • Sin <id>, valida el Work Item de la sesión activa.
  • Un links.json inválido se informa como WARN recuperable, nunca como FAIL.

rei check

Verifica el arnés y ejecuta los checks declarados en .rei/config.json.

Sintaxis

rei check

Flags

  • --quiet, -qOmite los [OK] y el resumen.

Ejemplo

Shell
rei check

Códigos de salida

  • 0 Todo pasa.
  • 1 Hay al menos un [FAIL].

Notas

  • Además de los checks, crea la estructura e inicializa git si falta.

rei test

Ejecuta los checks declarados en .rei/config.json.

Sintaxis

rei test

Sin flags propios.

Ejemplo

Shell
rei test

Códigos de salida

  • 0 No hay checks configurados o todos pasan.
  • 1 Algún check falla.

Notas

  • No es la suite de tests de REI; ejecuta solo los checks del proyecto.
  • Sin checks configurados informa y sale 0.

rei review-diff <id>

Genera el paquete de revisión con los cambios reales del Work Item.

Sintaxis

rei review-diff <id>

Flags

  • --fullMuestra el diff completo, no solo el resumen.

Ejemplo

Shell
rei review-diff 2026-10-27_01-54__mi-feature

rei view [<id>]

Abre el visor local de solo lectura: documentos, validación, sesión, TOC, diff y FICHA.

Sintaxis

rei view [<id>]

Flags

  • --openArranca o reutiliza el servidor en segundo plano y abre el navegador sin bloquear.
  • --stopDetiene el servidor del visor.
  • --enableActiva viewer.autoOpenOnReady en .rei/config.json.
  • --disableDesactiva viewer.autoOpenOnReady en .rei/config.json.

Ejemplo

Shell
rei view 2026-10-27_01-54__mi-feature

Códigos de salida

  • 0 El visor se abrió o se detuvo correctamente.
  • 1 No hay sesión activa o hubo un error de E/S.
  • 2 Uso incorrecto; los modos son mutuamente excluyentes.

Notas

  • En segundo plano se cierra poco después de mostrar «terminado» (done); --stop, el tiempo de inactividad y Ctrl+C siguen funcionando.
  • Es de solo lectura: no aprueba ni modifica documentos, meta.json ni el estado del Work Item.

Mantenimiento e integración

Actualizar el binario y activar la integración opcional con GitHub Issues.

Mantenimiento e integración: comandos, qué hacen y flags
ComandoQué haceFlags
rei update [--check]Actualiza el binario desde GitHub Releases verificando el checksum SHA-256.--check
rei github <enable|disable|status>Activa, desactiva o consulta la integración opcional GitHub Issues. El CLI nunca llama a GitHub.--repo owner/name--base <rama>--strategy squash|merge|rebase

rei update [--check]

Actualiza el binario desde GitHub Releases verificando el checksum SHA-256.

Sintaxis

rei update [--check]

Flags

  • --checkSolo comprueba si hay una versión nueva; no modifica nada.

Ejemplo

Shell
rei update --check

Códigos de salida

  • 0 Está actualizado, --check funcionó o Windows guió la descarga.
  • 1 Fallo de red, permisos, integridad o extracción.
  • 2 Uso incorrecto.

Notas

  • En Windows no se puede reemplazar el .exe en ejecución: informa y abre la página de releases.
  • Un fallo de integridad SHA-256 aborta sin modificar el binario.

rei github <enable|disable|status>

Activa, desactiva o consulta la integración opcional GitHub Issues. El CLI nunca llama a GitHub.

Sintaxis

rei github <enable|disable|status>

Flags

  • --repo owner/nameRepositorio de destino.
  • --base <rama>Rama base para los cambios.
  • --strategy squash|merge|rebaseEstrategia de merge del PR.

Ejemplo

Shell
rei github enable --repo k1wi777/REI-Harness --base main --strategy squash

Códigos de salida

  • 0 Operación correcta, también con avisos y en status.
  • 1 Error operativo o de configuración.
  • 2 Uso incorrecto.

Notas

  • Sin flags, enable detecta el repositorio desde origin y la base desde origin/HEAD.
  • disable y status no contactan con GitHub y rechazan flags.

Aprobación de la planificación

Pendiente

La firma humana libera la hoja. El silencio no aprueba.

La aprobación se registra desde el CLI; el visor no la sustituye.