hermes update în Hermes Agent CLI

Invocare CLI și Sesiuni Hermes Agent v0.22 (oct. 2026)

Actualizează o instalare din sursă la ultima versiune a canalului ei, cu backup prealabil și repornirea gateway-urilor.

Sintaxă & invocare
hermes update [--check] [--plan] [--backup | --no-backup] [--yes] [--set-channel stable|main]

Ce face hermes update

hermes update actualizează o instalare din sursă și pregătește dependențele prin managerul intern de pachete (PM). Un checkout al repository-ului oficial urmează implicit canalul stable (ultima versiune publicată vX.Y.Z); --set-channel main trece pe fiecare commit din main. Pachetele desktop, Docker, Nix și Termux au propriul mecanism de actualizare: pe o imagine Docker comanda refuză (cod 2) și afișează comanda corectă.

Înainte de actualizare se face implicit o captură rapidă a stării (quick). --backup forțează și o arhivă completă a HERMES_HOME, iar modul permanent se setează cu updates.pre_update_backup: quick | full | off. Fișierele locale modificate dintr-o instalare git sunt puse automat în stash. După succes, gateway-urile care rulează pentru același home sunt repornite.

În chat, /update face același lucru, inclusiv de pe Telegram, Discord, Slack, WhatsApp sau Teams; botul e offline câteva secunde la repornire. Coduri de ieșire: 0 succes, 1 erori de pull sau instalare, 2 modificări neașteptate în arborele de lucru.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
--check Verifică dacă există o actualizare, fără pull, instalare sau repornire.
--plan Afișează planul (tipul instalării, serviciile Hermes care rulează și cum vor fi repornite) fără să schimbe nimic.
--backup Forțează un backup complet înainte de actualizare.
--no-backup Sare peste toate backup-urile pentru această rulare.
--yes, -y Răspunde „da” la întrebări (migrare config, restaurare stash). Cheile API nu se cer; rulează separat hermes config migrate.
--set-channel stable|main Salvează canalul de actualizare, fără să actualizeze.
--channel stable|main Canal doar pentru această rulare.
--branch NAME Ramura sursă pentru această rulare; are prioritate față de canal.
--install-id Afișează identitatea și calea instalării, apoi iese.
--gateway Mod intern folosit de /update din mesagerie; nu repornește gateway-ul.
/update Comanda echivalentă din chat (CLI și mesagerie).

Exemple practice

Exemplul 1: Verificare fără modificări

hermes update --check
hermes update --plan

Exemplul 2: Actualizare cu backup complet

hermes update --backup

Exemplul 3: Urmărirea fiecărui commit din main

hermes update --set-channel main

Greșeli frecvente și bune practici

  • Cauți hermes update --force. Nu există; pentru verificare folosește --check sau --plan.
  • Actualizezi cu pip install -U sau rulezi git într-o aplicație semnată ori într-o imagine. Documentația cere hermes update sau managerul pachetului.
  • Lași modificări locale necomise în checkout. Sunt puse în stash; la conflict, stash-ul rămâne pentru recuperare manuală.

Comenzi înrudite