Guías · Visor

Visor

Abrir rei view, leer sus vistas, controlar su ciclo de vida y respetar sus límites de solo lectura.

Local · solo lectura · recarga en vivo

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

  1. Ejecuta rei view sin identificador para abrir el Work Item de la sesión activa. Si no hay sesión, indica uno con rei view <id>.
  2. 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, --enable y --disable son mutuamente excluyentes.
  3. 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.json existe.
  4. 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.
  5. 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.
  6. Activa o desactiva la apertura automática al llegar a ready con rei view --enable o rei view --disable. Solo cambia viewer.autoOpenOnReady en .rei/config.json.
Ciclo de vida
rei view
rei view 2026-10-27_01-54__mi-feature --open
rei view --stop
rei view --enable
rei view --disable

Verificación

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

Comprueba 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.json ni 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.

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.