Guide de référence Hermes Agent CLI — commandes, drapeaux et raccourcis slash

Commandes Shell et TUI pour l'agent Hermes auto-hébergé.

Sommaire

L’agent Hermes de Nous Research est un assistant agnostique du modèle et utilisant des outils que vous exécutez localement ou sur un VPS.

Hermes ne vous enferme pas dans une seule interface. Vous pouvez utiliser :

  • le CLI classique hermes / hermes chat,
  • la session plein écran hermes --tui,
  • un hermes gateway en cours d’exécution pour Telegram, Discord, Slack et autres plateformes de messagerie,
  • hermes dashboard pour une interface utilisateur locale dans le navigateur lorsque l’extension web est installée.

Ces chemins partagent la même configuration et les mêmes données sous ~/.hermes ; cette page liste les commandes shell importantes dans tous ces modes.

Aide-mémoire CLI de l’agent Hermes — référence terminal

Voici une référence de commandes dense regroupée par tâche.

Installation de l’agent Hermes et commandes CLI de première exécution

Pour l’installation et le dépannage, commencez par Assistant IA Hermes — Installation, Configuration, Flux de travail et Dépannage.

L’installateur récupère le dépôt, configure un environnement Python et relie l’exécutable hermes. Après source ~/.bashrc ou ~/.zshrc, votre point d’entrée par défaut pour le chat interactif est simplement hermes (même famille que hermes chat).

Commande Description
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Installation officielle en une ligne (Linux, macOS, WSL2).
hermes / hermes chat Démarrer le chat interactif après l’installation (entrée quotidienne par défaut).
hermes --version / hermes version Afficher les informations de version.
hermes completion bash | zsh | fish Émettre des scripts de complétion de shell pour la complétion par tabulation.
hermes update [--check] [--backup] [--restart-gateway] Tirer le dernier code, réinstaller les dépendances, snapshot facultatif du home avant mise à jour ou redémarrage du gateway.
hermes uninstall [--full] [--yes] Supprimer Hermes ; suppression complète des données facultative.

Windows natif n’est pas supporté ; utilisez WSL2. Les installations Android via Termux suivent un parcours dédié dans la documentation en amont.

Drapeaux globaux pour chaque invocation de hermes

Ces drapeaux s’appliquent avant les sous-commandes et modifient quel profil, quelle session ou quelle quantité de configuration personnelle est chargée.

Drapeau Description
--profile, -p Sélectionner le profil Hermes pour cette exécution (remplace la valeur collante par défaut de hermes profile use).
--resume, -r Reprendre une session par ID ou titre.
--continue [name], -c Continuer la session la plus récente, ou la plus récente correspondant à un titre.
--worktree, -w Démarrer dans un worktree Git isolé pour des agents parallèles.
--yolo Contourner les invites d’approbation pour les commandes dangereuses (à utiliser avec prudence).
--pass-session-id Inclure l’ID de session dans le prompt système.
--ignore-user-config Ignorer ~/.hermes/config.yaml (valeurs par défaut uniquement) ; .env est toujours chargé.
--ignore-rules Ignorer l’injection automatique de AGENTS.md, SOUL.md, .cursorrules, mémoire et compétences préchargées.
--tui Lancer l’interface TUI (équivalent de HERMES_TUI=1).
--dev Avec --tui, exécuter les sources TS via tsx pour le développement de l’interface TUI.

L’automatisation isolée associe souvent hermes chat --ignore-user-config --ignore-rules avec hermes -z pour des exécutions uniques reproductibles.

hermes chat, prompts en une seule exécution et hermes -z

Commande / modèle Description
hermes chat Chat interactif ou scripté ; surface principale pour -q, -m, --provider, ensembles d’outils, reprise, worktree, points de contrôle.
hermes chat -q "..." Prompt en une seule exécution (non interactif) ; conserve une sortie plus riche que -z lorsque des outils s’exécutent.
hermes -z "..." Exécution unique scriptée — seule la réponse finale sur stdout, sans bannière ni bruit de session. Même agent et mêmes outils ; idéal pour les pipelines et scripts.
hermes chat --quiet, -Q Mode programmatique plus silencieux (bannière et aperçus d’outils supprimés).
-m / --model, --provider Remplacements de modèle et de fournisseur par exécution ; les variables d’environnement HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER reflètent ce comportement.
-t / --toolsets Activer les ensembles d’outils séparés par des virgules pour l’exécution.
-s / --skills Précharger des compétences (répétables ou séparées par des virgules).
--image path Joindre une image locale à une seule requête.
--checkpoints Activer les points de contrôle du système de fichiers avant les modifications destructrices.
--max-turns N Limiter les itérations d’appel d’outils par tour (défini par défaut dans la configuration).
--source Balise de source de session (cli vs tool pour les intégrations).

Modèle Hermes en dehors de la session vs /model à l’intérieur — Lancer hermes model depuis le shell est l’endroit où vous ajoutez des fournisseurs, des clés et OAuth. Slash /model permet uniquement de basculer entre les fournisseurs déjà configurés. Si vous ne voyez que OpenRouter dans /model, quittez la session et complétez hermes model.

Sélectionneur de modèles, pools de crédentials et fournisseurs de repli

Commande Description
hermes model Sélectionneur interactif de fournisseur et de modèle ; clés, OAuth, points de terminaison personnalisés.
hermes auth Pools de crédentials — add, list, remove, reset pour des clés et OAuth faciles à faire pivoter.
hermes fallback [list | add | remove | clear] Gérer les fournisseurs de repli ordonnés lorsque le principal échoue ou est limité en débit.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Configuration interactive sectionnée ou complète (--quick, --reset, --non-interactive).

hermes login / hermes logout sont obsolètes — utilisez hermes auth et hermes model à la place.

Le choix entre des points de terminaison locaux compatibles OpenAI et des API hébergées pour hermes model repose sur les mêmes compromis que l’hébergement LLM (latence, coût, opérations).

Une fois que votre défaut se termine par Qwen ou Gemma sur quelque chose comme Ollama, les valeurs par défaut de l’échantillonneur comptent autant que l’ID de modèle que vous avez tapé ; consultez les paramètres d’inférence agencés pour Qwen et Gemma dans Paramètres d’inférence agencés pour Qwen et Gemma.

Fichiers de configuration et commandes hermes config

La configuration se résout comme suit : remplacements CLI → config.yaml → .env → valeurs par défaut. Les clés API appartiennent à .env ; les paramètres structurés à config.yaml.

Commande Description
hermes config show Afficher la configuration effective.
hermes config edit Ouvrir config.yaml dans $EDITOR.
hermes config set key value Définir les valeurs (les secrets sont routés vers .env, les non-secrets vers YAML).
hermes config path / hermes config env-path Afficher les chemins vers les fichiers de configuration et d’environnement.
hermes config check Détecter les paramètres manquants ou périmés.
hermes config migrate Appliquer les options nouvellement introduites de manière interactive.

Où se trouvent les fichiers — Tout est sous HERMES_HOME (par défaut ~/.hermes) pour la configuration, les secrets, les mémoires, les compétences, les sessions, l’état du gateway et les journaux.

Gestion des sessions et hermes profile

Commande Description
hermes sessions list Lister les sessions récentes.
hermes sessions browse Sélecteur interactif avec recherche et reprise.
hermes sessions export Exporter les sessions (par exemple JSONL).
hermes sessions delete, prune, rename, stats Supprimer une session, élaguer les anciennes, renommer les titres, afficher les statistiques du magasin.
hermes profile list | use | create | delete | show | rename Gérer des instances Hermes isolées sur une seule machine.
hermes profile export / import Archiver ou restaurer un tarball de profil.
hermes profile alias Scripts enveloppe courts pour un changement rapide de profil.

Utilisez hermes -p work chat -q "..." pour des exécutions ad hoc sans modifier le profil par défaut collant.

Hub de compétences, ensembles d’outils, crochets shell et plugins

Pour une configuration centrée sur les profils et des compétences adaptées aux flux de travail de production réels par rôle, consultez Compétences de l’assistant IA Hermes pour des configurations de production réelles. Pour écrire et déboguer les fichiers SKILL.md — métadonnées, divulgation progressive et visibilité conditionnelle — consultez Rédaction de compétences pour l’agent Hermes — Structure et meilleures pratiques de SKILL.md.

Commande Description
hermes tools Activation interactive des outils par plateforme ; --summary affiche les choix actuels.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Flux de travail du hub de compétences incluant les registres et les installations par URL.
hermes curator status, run, pause, pin, rollback, … Maintenance des compétences en arrière-plan et rollback sécurisé.
hermes hooks list, test, revoke, doctor Crochets shell déclarés et listes autorisées dans la configuration.
hermes plugins UI composite ou sous-commandes pour installer, activer, désactiver, supprimer des plugins.

Mémoire intégrée et fournisseurs hermes memory

Les fichiers intégrés MEMORY.md / USER.md restent actifs ; les fournisseurs externes ajoutent des couches de rappel optionnelles. Pour comprendre comment cette architecture se comporte en pratique, lisez Système de mémoire de l’agent Hermes — Comment la mémoire IA persistante fonctionne réellement. Pour comparer les backends externes et les compromis d’activation, consultez Fournisseurs de mémoire d’agent comparés — Honcho, Mem0, Hindsight et cinq autres.

Commande Description
hermes memory setup Configuration interactive du fournisseur de mémoire externe.
hermes memory status Afficher les paramètres du fournisseur actif.
hermes memory off Désactiver le fournisseur externe ; les fichiers intégrés restent.

Lorsqu’un fournisseur est actif, il peut enregistrer des sous-commandes de niveau supérieur spécifiques au fournisseur — exécutez hermes --help pour voir ce qui est câblé aujourd’hui.

Passerelle de messagerie, appairage DM et plateformes

Commande Description
hermes gateway setup Configuration interactive de la plateforme de messagerie.
hermes gateway run Passerelle au premier plan (recommandé sur WSL, Docker, Termux).
hermes gateway start | stop | restart | status Contrôle du service systemd / launchd (--all affecte le gateway de chaque profil).
hermes gateway install | uninstall Installer ou supprimer un service d’arrière-plan au niveau de l’utilisateur.
hermes pairing list | approve | revoke | clear-pending Approbations d’appairage DM pour les bots de messagerie.
hermes whatsapp Flux d’appairage du pont WhatsApp.
hermes slack manifest Générer un manifeste d’application Slack avec parité de slash de gateway.

Sur WSL, hermes gateway run dans tmux est le modèle résilient lorsque gateway start dysfonctionne. Pour les flux de travail de bout en bout sur téléphone utilisant cette même couche de gateway, consultez Contrôle vocal Hermes depuis votre téléphone. Pour une opération sur serveur dédié avec un client de bureau séparé, suivez Configuration du serveur sans tête et bureau à distance de l’agent Hermes.

Planificateur Cron, webhooks et Kanban

Commande Description
hermes cron … Créer, éditer, mettre en pause, reprendre, exécuter, supprimer des prompts planifiés (tick pour une passe de planificateur manuel).
hermes webhook subscribe, list, remove, test Routes de webhook dynamiques pour les exécutions pilotées par événements.
hermes kanban … Tableau de tâches multi-profil soutenu par SQLite ; dispatch pilote les travailleurs.

Si vous avez besoin de modèles de concurrence pratiques pour hermes kanban sur des gateways auto-hébergés, consultez Kanban dans l’agent Hermes pour les flux de travail LLM auto-hébergés.

hermes doctor, journaux, sauvegarde et aperçus d’utilisation

Commande Description
hermes doctor [--fix] Diagnostics interactifs et réparation automatique optionnelle.
hermes status [--all] [--deep] Statut concis ; vérifications plus approfondies si nécessaire.
hermes dump [--show-keys] Résumé de configuration convivial pour le collage sur Discord ou les problèmes GitHub.
hermes debug share Téléverser un bundle de débogage anonymisé vers un service de collage (ou --local).
hermes logs [agent | errors | gateway | list] Tail et filtrer les journaux sous le répertoire de journaux du profil.
hermes backup, hermes import Snapshots zip des données home et restauration des chemins.
hermes insights [--days N] [--source …] Analyses de jetons, coûts et activités.

Quand quelque chose casse après une mise à niveau, hermes doctor, hermes status et hermes logs errors -f forment la boucle de triage la plus rapide.

MCP, ACP, tableau de bord web et migration OpenClaw

Commande Description
hermes mcp serve Exécuter Hermes en tant que serveur MCP.
hermes mcp add, remove, list, test, configure Gérer les connexions client MCP depuis Hermes.
hermes acp Serveur stdio du protocole Agent Client Protocol pour les éditeurs (installation supplémentaire peut s’appliquer).
hermes dashboard [--port …] [--host …] Tableau de bord web local (pip install hermes-agent[web]).
hermes claw migrate … Migrer les configurations de style OpenClaw vers Hermes (--dry-run, présélections, secrets optionnels).

Migration OpenClaw — hermes claw migrate lit les répertoires home legacy OpenClaw ; pour voir à quoi ressemblait cette pile avant le déménagement, consultez l’étude de cas OpenClaw.

Commandes slash dans la session CLI Hermes

Tapez / pour l’auto-complétion. Les commandes sont insensibles à la casse ; les compétences enregistrent des routes supplémentaires /skill-name. Les tableaux ci-dessous sont un sous-ensemble soigné ; pour le registre complet, consultez la documentation officielle de l’agent Hermes à la fin de cet article.

Flux de session, tâches en arrière-plan et objectifs

Commande Description
/new, /reset Nouvel ID de session et historique.
/resume [name] Reprendre une session nommée.
/compress [focus] Compression de contexte manuelle avec sujet de фокус optionnel.
/retry, /undo Réessayer le dernier tour ou abandonner le dernier échange.
/title … Nommer la session pour un /resume ultérieur.
/background …, /queue …, /steer … Exécution en arrière-plan parallèle, prompt suivant en file d’attente, relance en milieu de boucle après le prochain outil.
/goal … Objectif multi-tours persistant avec boucle de juge (status, pause, resume, clear).
/branch, /fork Brancher la conversation pour une exploration alternative.

Modèles, bascules d’outils, compétences et rechargement

Commande Description
/model … [--global] Basculer les modèles entre les fournisseurs configurés ; --global persiste la valeur par défaut.
/tools …, /toolsets Bascules d’outils de session et liste des ensembles d’outils.
/skills … Rechercher, installer et gérer les compétences depuis le chat.
/cron … Interface utilisateur des tâches planifiées depuis la session CLI.
/reload-mcp Recharger les serveurs MCP depuis la configuration.
/reload Recharger .env dans la session en cours sans redémarrage.

Utilisation, aide et sortie

Commande Description
/usage, /insights Visibilité des jetons et des coûts ; instantané analytique.
/help, /quit Aide ou quitter le CLI.

Les applications de messagerie (Telegram, Discord, Slack et autres) exposent un ensemble slash chevauchant plus /approve, /restart, /commands et assistants liés au gateway uniquement — les différences de plateforme sont documentées dans la référence des commandes slash sous documentation officielle de l’agent Hermes ci-dessous.

Lectures supplémentaires utiles

Pages connexes sur ce site (contexte plus large pour Hermes et les agents terminaux) :

Documentation officielle de l’agent Hermes

Documentation en amont sur hermes-agent.nousresearch.com :

Astuce. Gardez hermes dump et hermes doctor --fix en mémoire musculaire — ils transforment les rapports vagues de “quelque chose a cassé” en diffs actionnables contre une configuration connue comme bonne.

S'abonner

Recevez de nouveaux articles sur les systèmes, l'infrastructure et l'ingénierie IA.