Feuille de triche de l’Agent Hermes CLI — commandes, options et raccourcis Slash

L’agent Hermes de Nous Research est un assistant agnostique des modèles, capable d’utiliser des outils, que vous exécutez localement ou sur un VPS.

Hermes ne vous bride pas à 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 longue pour Telegram, Discord, Slack et d’autres plateformes de messagerie,
• hermes dashboard pour une interface navigateur locale lorsque le module supplémentaire Web est installé.

Ces chemins partagent la même configuration et les mêmes données sous ~/.hermes ; cette page répertorie les commandes shell importantes à travers ces modes.

Ci-dessous se trouve une référence de commandes dense regroupée par tâche.

Installer Hermes Agent et commandes CLI de première exécution

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

L’installateur télécharge le dépôt, configure un environnement Python et connecte 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 installation (point d’entrée quotidien 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]	Récupérer le dernier code, réinstaller les dépendances, instantané de la maison avant mise à jour ou redémarrage de la passerelle en option.
hermes uninstall [--full] [--yes]	Supprimer Hermes ; suppression complète des données en option.

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

Drapeaux globaux pour chaque invocation 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 (réécrit le défaut collant de hermes profile use).
--resume, -r	Reprendre une session par ID ou titre.
--continue [name], -c	Poursuivre la session la plus récente, ou la dernière correspondant à un titre.
--worktree, -w	Démarrer dans un arbre de travail Git isolé pour les agents parallèles.
--yolo	Ignorer les invites d’approbation des 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 (défauts 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 le TUI (équivalent de HERMES_TUI=1).
--dev	Avec --tui, exécuter les sources TS via tsx pour le développement du TUI.

L’automatisation isolée associe souvent hermes chat --ignore-user-config --ignore-rules avec hermes -z pour des expositions en une seule fois reproductibles.

hermes chat, prompts en une seule fois et hermes -z

Commande / motif	Description
hermes chat	Chat interactif ou scripté ; surface principale pour -q, -m, --provider, ensembles d’outils, reprise, arbre de travail, points de contrôle.
hermes chat -q "..."	Prompt en une seule fois (non interactif) ; conserve une sortie plus riche que -z lorsque des outils s’exécutent.
hermes -z "..."	Exposition scriptée en une seule fois — 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 pipes et les scripts.
hermes chat --quiet, -Q	Mode programmatique plus silencieux (bannière et aperçus d’outils supprimés).
-m / --model, --provider	Réécritures de modèle et de fournisseur par exécution ; les variables d’environnement HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER reproduisent ce comportement.
-t / --toolsets	Activer des ensembles d’outils séparés par des virgules pour l’exécution.
-s / --skills	Précharger des compétences (répétées 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 destructives.
--max-turns N	Limiter les itérations d’appels d’outils par tour (défaut de la configuration).
--source	Étiquette de source de session (cli contre tool pour les intégrations).

Modèle Hermes en dehors de la session contre /model dedans — Exécuter hermes model depuis le shell est l’endroit où vous ajoutez des fournisseurs, des clés et des OAuth. La commande Slash /model ne bascule que parmi 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 repli

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 les clés compatibles avec la rotation et OAuth.
hermes fallback [list | add | remove | clear]	Gérer les fournisseurs de repli ordonnés lorsque le principal échoue ou atteint la limite de 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 obsolètes — utilisez hermes auth et hermes model à la place.

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 de LLM en général (latence, coût, opérations).

Une fois votre valeur par défaut se terminant sur Qwen ou Gemma sur quelque chose comme Ollama, les valeurs par défaut de l’échantillonneur comptent autant que l’ID du modèle saisi ; agrégez les préréglages de température et de pénalité orientés agent dans Paramètres d’inférence LLM agentic pour Qwen et Gemma.

Fichiers de configuration et commandes hermes config

La configuration se résout ainsi : réécritures CLI → config.yaml → .env → valeurs par défaut. Les clés API appartiennent à .env ; les paramètres structurés dans 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 des valeurs (les secrets sont acheminé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 obsolètes.
hermes config migrate	Appliquer les options nouvellement introduites de manière interactive.

Où se trouvent les fichiers — Tout est situé sous HERMES_HOME (défaut ~/.hermes) pour la configuration, les secrets, les mémoires, les compétences, les sessions, l’état de la 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 stockage.
hermes profile list | use | create | delete | show | rename	Gérer des instances Hermes isolées sur une même machine.
hermes profile export / import	Archiver ou restaurer un archiveur de profil.
hermes profile alias	Scripts d’enceinte pour un changement rapide de profil.

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

Hub de compétences, ensembles d’outils, hooks 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, voir Compétences de l’Assistant IA Hermes pour les configurations de production réelles. Pour la rédaction et le débogage des fichiers SKILL.md — métadonnées, divulgation progressive et visibilité conditionnelle — voir Rédaction de compétences Hermes Agent — Structure et bonnes pratiques de SKILL.md.

Commande	Description
hermes tools	Activation interactive d’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 y compris les registres et les installations par URL.
hermes curator status, run, pause, pin, rollback, …	Maintenance de compétences en arrière-plan et repli sécurisé.
hermes hooks list, test, revoke, doctor	Hooks shell déclarés et listes d’autorisation 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

MEMORY.md / USER.md intégrés restent actifs ; les fournisseurs externes ajoutent des couches de rappel optionnelles. Pour voir comment cette architecture fonctionne 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, voir Comparaison des fournisseurs de mémoire d’agent — 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ée sur WSL, Docker, Termux).
hermes gateway start | stop | restart | status	Contrôle de service systemd / launchd (--all affecte la passerelle de chaque profil).
hermes gateway install | uninstall	Installer ou supprimer le service d’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 d’application Slack avec parité de slash de la passerelle.

Sur WSL, hermes gateway run dans tmux est le motif résilient lorsque gateway start se comporte mal. Pour les flux de travail de bout en bout de téléphone utilisant cette même couche de passerelle, voir Contrôle vocal de Hermes depuis votre téléphone. Pour le fonctionnement sur serveur dédié avec un client bureau séparé, suivez Configuration du serveur sans tête Hermes Agent et du bureau distant.

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 manuelle du planificateur).
hermes webhook subscribe, list, remove, test	Routes de webhook dynamiques pour des exécutions pilotées par événements.
hermes kanban …	Tableau de tâches multi-profil soutenu par SQLite ; dispatch pilote les workers.

Si vous avez besoin de motifs de concurrence pratiques pour hermes kanban sur des passerelles auto-hébergées, voir Kanban dans Hermes Agent 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 pratique pour Discord ou les problèmes GitHub.
hermes debug share	Télécharger un bundle de débogage modifié vers un service de collage (ou --local).
hermes logs [agent | errors | gateway | list]	Suivre et filtrer les journaux sous le répertoire de journaux du profil.
hermes backup, hermes import	Instantanés zippés des données de la maison 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 comme un serveur MCP.
hermes mcp add, remove, list, test, configure	Gérer les connexions de client MCP depuis Hermes.
hermes acp	Serveur stdio du protocole de client d’agent pour les éditeurs (une 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éréglages, secrets optionnels).

Migration OpenClaw — hermes claw migrate lit les répertoires maison legacy OpenClaw ; le basculement complet par étapes, y compris la revue de secoue, la politique de conflit, la gestion des secrets et la prise en main des canaux, est couvert dans Comment migrer d’OpenClaw vers Hermes Agent en toute sécurité. Pour voir à quoi ressemblait cette pile avant le déplacement, voir 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 /skill-name supplémentaires. Les tableaux ci-dessous sont un sous-ensemble soigné ; pour le registre complet, voir la documentation officielle de Hermes Agent en 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 optionnel.
/retry, /undo	Réessayer le dernier tour ou abandonner le dernier échange.
/title …	Nommer la session pour une /resume ultérieure.
/background …, /queue …, /steer …	Exécution parallèle en arrière-plan, prompt suivant en file d’attente, ajustement en milieu de boucle après l’outil suivant.
/goal …	Objectif persistant multi-tours avec boucle de juge (status, pause, resume, clear).
/branch, /fork	Ramifier la conversation pour une exploration alternative.

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

Commande	Description
/model … [--global]	Basculer les modèles parmi les fournisseurs configurés ; --global persiste le 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 de 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 sortie du CLI.

Les applications de messagerie (Telegram, Discord, Slack et autres) exposent un ensemble de slashs chevauchants plus /approve, /restart, /commands et des aides uniques à la passerelle — les différences de plateforme sont documentées dans la référence des commandes slash sous la documentation officielle de Hermes Agent ci-dessous.

Lecture utile supplémentaire

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

• Systèmes IA — Assistants auto-hébergés, RAG et Infrastructure locale — aperçu du cluster et comment les assistants s’intègrent à la pile
• Mémoire des Systèmes IA — hub mémoire et guides adjacents
• Outils de développement IA — paysage des outils terminaux et IDE
• Guide rapide OpenCode — un autre agent centré terminal pour comparaison ergonomique

Documentation officielle de Hermes Agent

Documentation amont sur hermes-agent.nousresearch.com :

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

---

Astuce. Gardez hermes dump et hermes doctor --fix en mémoire musculaire — ils transforment les rapports vagues de “quelque chose est cassé” en différences actionnables par rapport à une configuration connue bonne.