Guías · Actualizar

Actualizar

Actualizar el arnés con rei init --update y el binario con rei update, incluido el caso de Windows.

Arnés y binario · actualización segura

Cuándo usarla

Usa esta guía cuando quieras comprobar si hay una versión nueva del binario, actualizarlo, o refrescar el esqueleto del arnés en un proyecto que ya lo tiene inicializado.

Requisitos

  • Para actualizar el binario, conexión con GitHub Releases y permisos de escritura sobre el ejecutable.
  • Para actualizar el arnés, un proyecto ya inicializado con .rei/.
  • Una copia de seguridad o un commit limpio antes de forzar cambios en la documentación.
  • Conocer la diferencia entre actualizar el binario y actualizar el esqueleto del proyecto.

Pasos

  1. Comprueba si hay una versión nueva con rei update --check. Solo informa del resultado: no descarga ni escribe nada.
  2. Actualiza el binario con rei update. Descarga el asset de tu sistema y arquitectura, verifica su SHA-256 contra checksums.txt y reemplaza el ejecutable de forma atómica. Si la integridad falla, aborta sin modificar el binario.
  3. En Windows no se puede reemplazar un .exe en ejecución: rei update informa y abre la página de releases para que descargues el archive a mano.
  4. Actualiza el esqueleto del arnés con rei init --update. Exige un proyecto REI; no instala desde cero y nunca toca .rei/specs/** ni .rei/progress/**.
  5. Revisa los avisos. --update es marker-aware: actualiza los documentos de personalización que aún contienen el marcador pendiente y conserva los ya personalizados. El resto de archivos se actualiza solo si el manifiesto confirma que no se modificaron.
  6. Usa rei init --update --force solo si aceptas sobrescribir cualquier archivo que difiera, incluidos los personalizados o modificados a mano. El resultado se reporta como [NEW], [UPD], [OK] o [SKIP].
Binario
rei update --check
rei update
Arnés
rei init --update
rei init --update --force
rei init status

Verificación

Shell
rei version
rei init status
rei check
rei validate

rei version confirma la versión del binario. rei init status indica si queda documentación pendiente de personalizar. rei check comprueba el arnés y los checks del proyecto, y rei validate revisa la coherencia de un Work Item.

Si la actualización del binario falla por red, permisos o checksum, el ejecutable anterior queda intacto. Si falla la sustitución después de iniciarse, se restaura el original.

Límites

  • rei init --update no instala el arnés desde cero: para eso se usa rei init.
  • --update no modifica .rei/specs/** ni .rei/progress/**: el trabajo en curso no se pierde.
  • Los documentos personalizados se conservan con aviso; solo --force los sobrescribe.
  • --update regenera los subagentes nativos solo si el proyecto ya tiene .opencode/ o .claude/.
  • En Windows, la actualización del binario es manual desde la página de releases.

Siguiente paso

Después de actualizar, vuelve a ejecutar los checks y, si el arnés cambió, revisa la referencia de comandos y la instalación.

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.