Keep Hermes Fresh: Updating & Uninstalling Made Simple

Mantén Hermes Fresco: Actualizar y Desinstalar en un Santiamén

Mantener tu asistente de IA al día no debería ser ciencia espacial. Por eso Hermes Agent lo convierte en un trabajo de un solo comando. Repasemos todo lo que necesitas saber sobre la actualización, y lo que ocurre entre bastidores para que puedas actualizar con total confianza.

La Actualización de un Solo Comando

Actualizar Hermes es tan simple como:

hermes update

Eso es todo. Este único comando descarga el código más reciente, actualiza todas las dependencias e incluso te pregunta sobre las nuevas opciones de configuración que se hayan añadido desde tu última actualización. Sin buscar en las notas de la versión, sin pasos manuales: solo un comando limpio.

¿Qué Pasa Realmente Durante una Actualización?

Quizás te estés preguntando: “¿Qué está pasando realmente bajo el capó?”. Aquí tienes el desglose amigable de los seis pasos que Hermes da para mantenerte al día:

Instantánea previa a la actualización — Antes de que nada cambie, Hermes guarda una instantánea ligera de tus archivos de estado importantes (datos de emparejamiento, trabajos cron, configuración y más). Los archivos de más de 1 GiB se omiten para que una base de datos enorme nunca ralentice el proceso. Esta instantánea se realiza para cada perfil de tu instalación, brindándote una red de seguridad.
Git pull — Hermes descarga el código más reciente de la rama main y actualiza cualquier submódulo.
Validación de sintaxis posterior al pull + reversión automática — Aquí está la parte inteligente. Después del pull, Hermes verifica que los nueve archivos críticos sigan analizándose correctamente. Si algo parece estar roto (como un marcador de conflicto de fusión), revierte automáticamente a la versión anterior para que tu shell siga siendo arrancable. Simplemente puedes volver a ejecutar la actualización una vez que la corrección llegue al repositorio.
Instalación de dependencias — Las dependencias nuevas o modificadas se instalan automáticamente.
Migración de configuración — Hermes detecta cualquier opción de configuración nueva y te pide que las establezcas. ¿Te perdiste el aviso? No te preocupes: solo ejecuta hermes config check para ver qué falta y luego hermes config migrate para añadirlas de forma interactiva.
Reinicio automático de la puerta de enlace — Las puertas de enlace en ejecución se actualizan para que el nuevo código surta efecto de inmediato. Las puertas de enlace gestionadas por el servicio se reinician a través del gestor de servicios del sistema; las manuales se relanzan automáticamente.

Actualizar desde una Rama Diferente

A veces quieres probar una candidata a versión final o una rama de funcionalidad. Hermes te tiene cubierto:

hermes update --branch release-candidate
hermes update --check --branch experimental   # solo previsualiza cuánto te has quedado atrás

Si tu copia local está en una rama diferente, Hermes guarda automáticamente cualquier trabajo sin confirmar, cambia a la rama objetivo y hace el pull. Las ramas que no existen localmente se rastrean automáticamente desde el remoto. ¿Y si una rama no existe en ningún sitio? Hermes falla limpiamente y restaura tus cambios guardados: nunca te quedas varado.

¿Y Si Estás Estacionado en una Rama de Funcionalidad?

¿Te encuentras en una rama de funcionalidad? Hermes lo maneja con elegancia:

Rama completamente fusionada — Hermes te devuelve a main y te dice exactamente lo que ha pasado.
Commits sin fusionar, árbol limpio — La actualización continúa hacia main (importante para actualizaciones no interactivas como el botón del escritorio), pero tus commits quedan intactos. Hermes imprime un aviso bien visible con el nombre de tu rama y cómo volver a ella.
Árbol sucio (cambios sin confirmar) — Hermes no toca tu trabajo. La actualización se marca como OMITIDA con una advertencia clara y los comandos exactos para resolver la situación.

Si mantienes deliberadamente una rama personalizada, establece updates.parked_branch_strategy: update_in_place en tu config.yaml. Hermes entonces fusionará origin/main dentro de tu rama en lugar de cambiarte a otra: tus commits sobreviven y el código avanza.

Desinstalación

Aunque la actualización es la protagonista, desinstalar es igual de sencillo. El proceso elimina Hermes limpiamente de tu sistema, para que puedas despedirte sin dejar desorden digital detrás.

Reflexiones Finales

Hermes Agent trata las actualizaciones como una experiencia de primera clase: segura, reversible y transparente. Las instantáneas previas a la actualización, la reversión automática en errores de sintaxis y el manejo inteligente de ramas significan que puedes actualizar con confianza, sabiendo que tu asistente seguirá funcionando pase lo que pase.

Así que adelante: ejecuta hermes update y deja que tu asistente de IA crezca contigo. Es la forma más fácil de estar a la vanguardia.