Fiche de référence pour l'interface Hermes Agent CLI — commandes, drapeaux et raccourcis slash

L’agent Hermes de Nous Research est un assistant agnostique du modèle, utilisant des outils, que vous pouvez exécuter 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 d’autres plateformes de messagerie,
• hermes dashboard pour une interface utilisateur locale dans le navigateur lorsque le module web est installé.

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

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 lie l’exécutable hermes. Après avoir exécuté 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 en une ligne officielle (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 shell pour la complétion par tabulation.
hermes update [--check] [--backup] [--restart-gateway]	Tirer le code le plus récent, réinstaller les dépendances, snapshot facultatif du dossier personnel avant mise à jour ou redémarrage du passerelle.
hermes uninstall [--full] [--yes]	Désinstaller Hermes ; suppression complète des données facultative.

Windows natif n’est pas pris en charge ; 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 le profil, la session ou la quantité de configuration personnelle chargée.

Drapeau	Description
--profile, -p	Sélectionner le profil Hermes pour cette exécution (remplace la valeur par défaut collante de hermes profile use).
--resume, -r	Reprendre une session par ID ou titre.
--continue [name], -c	Continuer la session la plus récente, ou celle correspondant à un titre.
--worktree, -w	Démarrer dans un worktree Git isolé pour des agents parallèles.
--yolo	Contourner les invites d’approbation des commandes dangereuses (à utiliser avec précaution).
--pass-session-id	Inclure l’ID de session dans l’invite 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, 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, invites uniques et hermes -z

Commande / motif	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 "..."	Invite unique (non interactive) ; conserve une sortie plus riche que -z lorsque les outils s’exécutent.
hermes -z "..."	Exécution unique scriptée — réponse finale uniquement sur la sortie standard, 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 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 les compétences (répéter ou séparer 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éfaut depuis la configuration).
--source	Balise source de la 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, clés et OAuth. La barre oblique /model ne permet que 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électeur de modèles, pools de credentials et fournisseurs de secours

Commande	Description
hermes model	Sélecteur interactif de fournisseur et de modèle ; clés, OAuth, points de terminaison personnalisés.
hermes auth	Pools de credentials — add, list, remove, reset pour des clés et OAuth compatibles avec la rotation.
hermes fallback [list | add | remove | clear]	Gérer les fournisseurs de secours ordonnés lorsque le principal échoue ou atteint les limites de débit.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configuration interactive sectionnée ou complète (--quick, --reset, --non-interactive).

Obsolète hermes login / hermes logout — utilisez plutôt hermes auth et hermes model.

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

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 (secrets acheminés vers .env, 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 obsolètes.
hermes config migrate	Appliquer les nouvelles options introduites de manière interactive.

Emplacement des fichiers — Tout se trouve sous HERMES_HOME (par défaut ~/.hermes) pour la configuration, les secrets, les mémoires, les compétences, les sessions, l’état du passerelle 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 (ex. JSONL).
hermes sessions delete, prune, rename, stats	Supprimer une session, purger 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 de profil rapide.

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 le profil 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.

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 installations URL.
hermes curator status, run, pause, pin, rollback, …	Maintenance en arrière-plan des compétences et retour en arrière sûr.
hermes hooks list, test, revoke, doctor	Crochets shell déclarés et listes de contrôle dans la configuration.
hermes plugins	Interface utilisateur 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, appariement 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 la passerelle de chaque profil).
hermes gateway install | uninstall	Installer ou supprimer le service en arrière-plan au niveau utilisateur.
hermes pairing list | approve | revoke | clear-pending	Approbations d’appariement DM pour les bots de messagerie.
hermes whatsapp	Flux d’appariement du pont WhatsApp.
hermes slack manifest	Générer le manifeste de l’application Slack avec parité de barre oblique pour la passerelle.

Sur WSL, hermes gateway run à l’intérieur de tmux est le modèle résilient lorsque gateway start dysfonctionne.

Planificateur Cron, webhooks et Kanban

Commande	Description
hermes cron …	Créer, éditer, mettre en pause, reprendre, exécuter, supprimer des invites planifiées (tick pour un passage manuel du planificateur).
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 basé sur SQLite ; dispatch pilote les travailleurs.

hermes doctor, journaux, sauvegarde et insights d’utilisation

Commande	Description
hermes doctor [--fix]	Diagnostics interactifs et réparation automatique facultative.
hermes status [--all] [--deep]	Statut concis ; vérifications plus approfondies si nécessaire.
hermes dump [--show-keys]	Résumé de configuration compatible collage pour les problèmes Discord ou 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]	Suivre et filtrer les journaux sous le répertoire des journaux du profil.
hermes backup, hermes import	Snapshots zip des données du dossier personnel et chemins de restauration.
hermes insights [--days N] [--source …]	Analyses des jetons, coûts et activités.

Lorsque 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, presets, secrets facultatifs).

Migration OpenClaw — hermes claw migrate lit les répertoires personnels hérités d’OpenClaw ; pour voir à quoi ressemblait cette stack avant le déménagement, consultez l’étude de cas OpenClaw.

Commandes obliques 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 /nom-compétence. Les tableaux ci-dessous sont un sous-ensemble curaté ; 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 manuelle du contexte avec sujet de focus facultatif.
/retry, /undo	Réessayer le dernier tour ou supprimer le dernier échange.
/title …	Nommer la session pour un /resume ultérieur.
/background …, /queue …, /steer …	Exécution parallèle en arrière-plan, prochaine invite en file d’attente, impulsion en milieu de boucle après le prochain outil.
/goal …	Objectif persistant multi-tours avec boucle de jugement (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 entre les modèles des 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 quitter

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 oblique chevauchant ainsi que /approve, /restart, /commands et autres utilitaires exclusifs au passerelle — les différences de plateforme sont documentées dans la référence des commandes obliques sous documentation officielle de l’agent Hermes ci-dessous.

Lecture supplémentaire utile

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

• Systèmes IA — Assistants auto-hébergés, RAG et infrastructure locale — vue d’ensemble du cluster et comment les assistants s’intègrent dans la stack
• Mémoire des systèmes IA — hub de mémoire et guides connexes
• Outils de développement IA — paysage des outils terminaux et IDE
• Démarrage rapide OpenCode — un autre agent centré sur le terminal pour une comparaison ergonomique

Documentation officielle de l’agent Hermes

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

• Agent Hermes
• Référence des commandes CLI
• Référence des commandes obliques

---

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 bonne.