hermes-agents.fr

update et gateway : maintenance

La mise à jour (update --plan, redémarrage gateway) et la gateway (run, install, start) : drapeaux complets et sorties réelles v0.21.2.

01

hermes update : la mise à jour

Pull the latest changes from git and reinstall dependencies

options:
  -h, --help       show this help message and exit
  --gateway        Gateway mode: use file-based IPC for prompts instead of
                   stdin (used internally by /update)
  --check          Check whether an update is available without installing
                   anything
  --plan           Show the update plan and exit without changing anything:
                   install kind (git/docker/nix), every running Hermes service
                   across all profiles with its supervisor and running code
                   version, and how each will be restarted. Read-only; safe on
                   a live fleet.
  --no-backup      Skip ALL pre-update backups for this run (both the quick
                   state snapshot and the full zip; overrides
                   updates.pre_update_backup)
  --backup         Force a FULL pre-update backup (quick state snapshot +
                   HERMES_HOME zip) for this run, regardless of
                   updates.pre_update_backup
  --yes, -y        Run without blocking on prompts: accepts the config-
                   migration and stash-restore prompts, skips the fork-
                   upstream prompt without adding a remote. API-key entry is
                   skipped; run 'hermes config migrate' separately for those.
  --keep-stash     Do NOT re-apply local changes after the update. Uncommitted
                   changes are still stashed so the update can proceed, but
                   they stay parked in git stash instead of being restored
                   onto the updated code. Used by the desktop updater so local
                   source edits never silently ride along across updates.
  --branch NAME    Update against this branch instead of the default (main).
                   If the local checkout is on a different branch, hermes will
                   switch to the requested branch first (auto-stashing any
                   uncommitted changes).
  --switch-branch  With updates.parked_branch_strategy: update_in_place
                   configured, override it for this run: switch to the update
                   target and update THERE instead of merging the target into
                   the checked-out branch. The branch is left exactly as it
                   was : no merge commit is written into its history. Use on
                   long-lived feature branches where an update-driven merge
                   commit would pollute the branch. No effect under the
                   default strategy (switch), which already switches. Still
                   refuses to touch a dirty tree.
  --force          Windows: proceed with the update even when another
                   hermes.exe is detected. The concurrent process will likely
                   cause WinError 32 warnings. Does NOT bypass the venv-
                   process guard (see --force-venv).
  --force-venv     Windows: mutate the venv even while other processes are
                   running from its interpreter (desktop backend, gateway,
                   terminals). Those processes keep native .pyd files locked,
                   so the dependency sync will likely fail partway and strand
                   the install half-updated. Use only if you know the detected
                   holders are false positives.

--plan montre ce qui sera mis à jour sans l'exécuter. Après une mise à jour, la gateway doit redémarrer pour servir les nouveaux modules : le message d'avertissement l'indique explicitement.

02

hermes gateway : le service de messagerie

usage: hermes gateway [-h] [--accept-hooks]
                      {run,start,stop,restart,status,install,uninstall,list,setup,migrate-legacy,enroll}
                      ...

Manage the messaging gateway (Telegram, Discord, WhatsApp, Weixin, and more)

positional arguments:
  {run,start,stop,restart,status,install,uninstall,list,setup,migrate-legacy,enroll}
    run                 Run gateway in foreground (recommended for WSL,
                        Docker, Termux)
    start               Start the installed systemd/launchd background service
    stop                Stop gateway service
    restart             Restart gateway service
    status              Show gateway status
    install             Install gateway as a systemd/launchd background
                        service
    uninstall           Uninstall gateway service
    list                List all profiles and their gateway status
    setup               Configure messaging platforms
    migrate-legacy      Remove legacy hermes.service units from pre-rename
                        installs
    enroll              Enroll this gateway with a relay connector (writes
                        relay auth creds to .env)

options:
  -h, --help            show this help message and exit
  --accept-hooks        Auto-approve unseen shell hooks without a TTY prompt
                        (equivalent to HERMES_ACCEPT_HOOKS=1 /
                        hooks_auto_accept: true).

run lance la gateway en premier plan (le bon choix pour un test), install installe le service système (systemd), start/stop/restart/status pilotent le service installé. setup configure les canaux (jetons Telegram, Discord, Slack, WhatsApp).

03

hermes moa : la multi-orchestration

usage: hermes moa [-h] {list,ls,configure,config,delete,rm} ...

Configure the provider/model set used by /moa <prompt>.

positional arguments:
  {list,ls,configure,config,delete,rm}
    list (ls)           Show current MoA model slots
    configure (config)  Interactively pick MoA models
    delete (rm)         Delete a MoA preset

options:
  -h, --help            show this help message and exit

list, configure, delete : la gestion des configurations multi-agents. Pour la découpe de travail, voir la page sur la délégation.