Visor
Abrir rei view, leer sus vistas, controlar su ciclo de vida y respetar sus límites de solo lectura.
Cuándo usarla
Abre el visor cuando quieras revisar un Work Item con los documentos renderizados, su tabla de contenidos, la validación, la sesión, el diff y la FICHA en una sola página. Es una herramienta local para leer y comprobar, no para decidir.
Requisitos
- Un proyecto inicializado con
.rei/y el binario rei disponible. - Una sesión activa o el identificador del Work Item que quieres ver.
- Un navegador local; el visor sirve un HTTP en tu máquina y no despliega nada.
- El puerto libre que el propio visor elige y comunica al arrancar.
Pasos
- Ejecuta
rei viewsin identificador para abrir el Work Item de la sesión activa. Si no hay sesión, indica uno conrei view <id>. - Si no quieres bloquear la terminal, usa
rei view --open: arranca o reutiliza el servidor en segundo plano y abre el navegador. Los modos--open,--stop,--enabley--disableson mutuamente excluyentes. - Revisa los documentos de planificación y progreso, el TOC, la validación, la sesión, el diff y la FICHA. La FICHA muestra issue, base y épica cuando
links.jsonexiste. - Deja la pestaña abierta si quieres seguir el estado: el badge y la FICHA se refrescan en vivo por SSE cuando cambian en disco.
- Cierra el servidor con
rei view --stop, con Ctrl+C o esperando el tiempo de inactividad. En segundo plano también se cierra poco después de mostrar «terminado» cuando el Work Item llega a done. - Activa o desactiva la apertura automática al llegar a ready con
rei view --enableorei view --disable. Solo cambiaviewer.autoOpenOnReadyen.rei/config.json.
rei view
rei view 2026-10-27_01-54__mi-feature --open
rei view --stop
rei view --enable
rei view --disableVerificación
rei item show 2026-10-27_01-54__mi-feature
rei validate 2026-10-27_01-54__mi-featureComprueba que el estado y la FICHA del visor coinciden con la ficha del CLI y con links.json, y que el diff corresponde a los cambios reales del Work Item. Si el visor muestra un estado antiguo, actualiza la página: el refresco depende de la conexión SSE.
Límites
- Es de solo lectura: no aprueba, no modifica documentos,
meta.jsonni el estado del Work Item. - No sustituye la respuesta humana en el chat o la terminal, ni el CLI, ni el historial de git.
- No carga JavaScript, CSS ni fuentes de terceros: sus assets van embebidos en el binario.
- No expone una ruta de aprobación ni un botón que cambie el estado.
Siguiente paso
Después de revisar el visor, el siguiente control es la verificación del proyecto. La guía de checks explica qué comandos se ejecutan y cómo interpretar su resultado.
La firma humana libera la hoja. El silencio no aprueba.