Comandos
Referencia del CLI rei agrupada por la tarea que resuelve. Todos los comandos aceptan rei <comando> --help.
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ó.
| Código | Significado |
|---|---|
| 0 | El comando terminó correctamente. |
| 1 | Falló una comprobación o el comando no pudo completarse. |
| 2 | Uso 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.
| Comando | Qué hace | Flags |
|---|---|---|
| rei init | Inicializa el arnés en el proyecto: esqueleto, estructura de estado y git si falta. No sobrescribe archivos existentes. | --help |
| rei init status | Indica qué documentación del proyecto falta por personalizar. | — |
| rei init opencode | Genera los subagentes nativos de OpenCode y el comando /personalize. | --check |
| rei init claude | Genera los subagentes nativos de Claude Code, /personalize y CLAUDE.md. | --check |
| rei init --update | Actualiza el arnés de un proyecto ya inicializado con detección de marcadores. | --force |
| rei doctor | Diagnó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.
rei init
--help
rei init0Instalación completada.1No pudo crear un archivo del esqueleto o de la estructura, o falló la generación o verificación de OpenCode o Claude.2Uso incorrecto.
- 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.
rei init status
rei init status0No queda ningún documento pendiente.1Queda algún documento por personalizar.
rei init opencode
Genera los subagentes nativos de OpenCode y el comando /personalize.
rei init opencode
--check
rei init opencode0Todos los archivos coinciden con la generación canónica.1Falta alguno, no lleva la marca o difiere.
- 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.
rei init claude
--check
rei init claude0Todos los archivos coinciden con la generación canónica.1Falta alguno, no lleva la marca o difiere.
- 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.
rei init --update
--force
rei init --updaterei doctor
Diagnóstico de solo lectura del arnés, los roles y la personalización pendiente.
rei doctor
rei doctorWork Items y sesión
Crear, planificar, aprobar y mover un Work Item por sus estados.
| Comando | Qué hace | Flags |
|---|---|---|
| rei new <id> <feature|task> [title] | Crea un Work Item en estado pending con su identificador y tipo. | — |
| rei session | Muestra 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 archive | Archiva la sesión cuando el Work Item ya está cerrado. | — |
| rei session reset | Restablece 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 status | Lista 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.
rei new <id> <feature|task> [title]
rei new 2026-10-27_01-54__mi-feature feature "Mi primera feature"rei session
Muestra la sesión activa y su Work Item.
rei session
rei session statusrei session start <id> <tipo>
Inicia la sesión de un Work Item solo si existe, el tipo coincide y está en pending.
rei session start <id> <tipo>
rei session start 2026-10-27_01-54__mi-feature featurerei session archive
Archiva la sesión cuando el Work Item ya está cerrado.
rei session archive
rei session archive0Sesión archivada y current.md restablecido.1El Work Item no está en un estado terminal o current.md no es coherente.
- 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.
rei session reset
rei session resetrei commit set <id> <campo>
Registra el commit actual en base_commit o en last_review_commit.
rei commit set <id> <campo>
rei commit set 2026-10-27_01-54__mi-feature base_commitrei status set <id> <estado>
Cambia el estado de un Work Item. done es terminal; salir de él requiere --force.
rei status set <id> <estado>
--force
rei status set 2026-10-27_01-54__mi-feature readyrei items status
Lista cada Work Item con su tipo, estado, issue y base si existe enlace.
rei items status
rei items status0Listado correcto.1Hay más de un Work Item en in_progress; el mensaje nombra los implicados.
- 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.
rei item show <id>
rei item show 2026-10-27_01-54__mi-feature0La ficha se muestra sin fallos de validación.1Hay al menos un [FAIL] de validación.
- 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.
| Comando | Qué hace | Flags |
|---|---|---|
| rei validate [<id>] | Comprueba la consistencia interna de un Work Item. Un links.json inválido es un aviso recuperable. | — |
| rei check | Verifica el arnés y ejecuta los checks declarados en .rei/config.json. | --quiet, -q |
| rei test | Ejecuta 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.
rei validate [<id>]
rei validate 2026-10-27_01-54__mi-feature0No hay ningún [FAIL].1Hay al menos un [FAIL].
- 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.
rei check
--quiet, -q
rei check0Todo pasa.1Hay al menos un [FAIL].
- Además de los checks, crea la estructura e inicializa git si falta.
rei test
Ejecuta los checks declarados en .rei/config.json.
rei test
rei test0No hay checks configurados o todos pasan.1Algún check falla.
- 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.
rei review-diff <id>
--full
rei review-diff 2026-10-27_01-54__mi-featurerei view [<id>]
Abre el visor local de solo lectura: documentos, validación, sesión, TOC, diff y FICHA.
rei view [<id>]
--open--stop--enable--disable
rei view 2026-10-27_01-54__mi-feature0El visor se abrió o se detuvo correctamente.1No hay sesión activa o hubo un error de E/S.2Uso incorrecto; los modos son mutuamente excluyentes.
- 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.
| Comando | Qué hace | Flags |
|---|---|---|
| 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.
rei update [--check]
--check
rei update --check0Está actualizado, --check funcionó o Windows guió la descarga.1Fallo de red, permisos, integridad o extracción.2Uso incorrecto.
- 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.
rei github <enable|disable|status>
--repo owner/name--base <rama>--strategy squash|merge|rebase
rei github enable --repo k1wi777/REI-Harness --base main --strategy squash0Operación correcta, también con avisos y en status.1Error operativo o de configuración.2Uso incorrecto.
- Sin flags, enable detecta el repositorio desde origin y la base desde origin/HEAD.
- disable y status no contactan con GitHub y rechazan flags.
La firma humana libera la hoja. El silencio no aprueba.