Mode d’emploi de la ligne de commande Hermes Agent — commandes, options et raccourcis slash

L’agent Hermes de Nous Research est un assistant utilisant des outils, agnostique quant au modèle, que vous pouvez exécuter localement ou sur un VPS, depuis le shell, une interface TUI plein écran ou une passerelle de messagerie.

Hermes ne vous verrouille pas sur une seule interface. Vous pouvez utiliser :

• le CLI classique hermes / hermes chat,
• la session plein écran hermes --tui,
• hermes gateway en exécution prolongée pour Telegram, Discord, Slack et d’autres plateformes de messagerie,
• hermes dashboard pour une interface de navigateur locale lorsque le module 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 essentielles pour ces modes.

Ci-dessous se trouve une référence de commandes dense regroupée par tâche, vérifiée par rapport à la référence officielle des commandes CLI du 6 octobre 2026. La dernière étiquette stable à cette date est v0.21.5 (v2026.9.24).

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

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

L’installeur récupère le dépôt, configure un environnement Python et associe 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 en une ligne officielle (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 d’achèvement shell pour l’achèvement par tabulation.
hermes update [--check] [--backup] [--restart-gateway]	Récupérer le dernier code, réinstaller les dépendances, instantané facultatif de la home avant mise à jour ou redémarrage de la passerelle.
hermes uninstall [--full] [--yes]	Supprimer Hermes ; suppression complète des données facultative.

Windows natif n’est pas pris en charge ; utilisez WSL2. L’installation sur Android via Termux suit un chemin dédié dans la documentation amont.

Drapeaux globaux pour chaque invocation de hermes

Ces drapeaux s’appliquent avant les sous-commandes et modifient quel profil, quelle session ou combien de configuration personnelle se charge.

Drapeau	Description
--profile, -p	Sélectionner le profil Hermes pour cette exécution (remplace le défaut collant 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 les agents parallèles.
--yolo	Contourner les prompts 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 (valeurs par défaut uniquement) ; .env se charge toujours.
--ignore-rules	Ignorer l’injection automatique de AGENTS.md, SOUL.md, .cursorrules, mémoire, compétences préchargées.
--tui	Lancer la TUI (équivalent de HERMES_TUI=1).
--dev	Avec --tui, exécuter les sources TS via tsx pour le développement de la 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 fois, et hermes -z

Commande / motif	Description
hermes chat	Chat interactif ou scripté ; surface principale pour -q, -m, --provider, toolsets, reprise, worktree, points de contrôle.
hermes chat -q "..."	Sur un TTY, soumet le prompt comme premier tour et reste dans la session. Avant la version 0.21, cela se terminait après une seule réponse.
hermes chat --oneshot -q "..."	Répondre et quitter (l’ancien comportement de -q). Implicite avec -Q et avec l’entrée-sortie non-TTY. Utilisez ceci lorsque vous avez besoin de la sortie des outils dans la transcription.
hermes chat --query-file PATH	Lire le prompt depuis un fichier, ou - pour l’entrée standard. Rien n’est interprété par le shell. Mutuellement exclusif avec -q.
hermes -z "..."	Exécution unique scriptée — seule la réponse finale sur la sortie standard, sans bannière ni bruit de session. Mêmes agents et outils ; idéal pour les tuyaux et les scripts.
hermes -z "…" --usage-file PATH	Après une exécution -z, écrire un rapport d’utilisation JSON (jetons, coût, completed / failed / partial) même si l’exécution échoue.
hermes chat -q "…" --format stream-json	Événements JSONL sur la sortie standard (system, text, tool_use, tool_result, result). Implicite sur le mode silencieux ; rejette --tui.
hermes chat --quiet, -Q	Mode programmatique plus silencieux (bannière et aperçus des outils supprimés). Implique également le mode oneshot lorsqu’il est combiné avec -q.
-m / --model, --provider	Remplacements par exécution du modèle et du fournisseur ; les variables d’environnement HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER reproduisent le comportement.
-t / --toolsets	Activer des toolsets séparés par des virgules pour l’exécution.
-s / --skills	Précharger des 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 destructives.
--max-turns N	Limiter les itérations d’appels d’outils par tour (par défaut 500, ou agent.max_turns dans la configuration).
--safe-mode	Désactiver la configuration utilisateur, les règles, la mémoire, les plugins, les hooks shell et le MCP. Implicite sur --ignore-user-config et --ignore-rules.
--source	Étiquette de source de session (cli vs tool pour les intégrations). Les exécutions uniques ont oneshot par défaut.

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

Codes de sortie. Une exécution chat --oneshot / -Q se termine avec 0 si le tour est complété, 1 s’il a échoué, été stoppé en cours de route, atteint le budget d’itération, ou n’a jamais démarré, et 130 en cas d’interruption. hermes -z utilise une carte différente : 0 complété, 2 échoué ou partiel (même s’il a affiché une explication), 1 si un tour complété n’a produit aucun texte, 130 en cas d’interruption. Jugez un pipeline par le code, pas par le fait que la sortie standard soit vide.

Sélecteur de modèle, pools de crédentiels 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 crédentiels — 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 présente des erreurs ou des limites de débit.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configuration interactive sectionnée ou complète (--quick, --reset, --non-interactive).
hermes setup --portal	Connexion en une seule fois au Nous Portal : OAuth, définir Nous comme fournisseur d’inférence, opter pour la passerelle d’outils.
hermes portal [status | open | tools]	État d’authentification du portail et routage de la passerelle d’outils. Sans sous-commande, exécute status.

hermes login a été supprimé. Utilisez hermes auth pour OAuth et les pools de crédentiels, hermes model pour choisir un fournisseur, ou hermes setup pour l’assistant complet. hermes auth logout <provider> efface une connexion stockée.

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

Une fois que votre valeur par défaut se termine 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 ; les préréglages agrégés de température et de pénalité orientés agents sont disponibles dans Paramètres d’inférence LLM pour agents pour Qwen et Gemma.

Fichiers de configuration et commandes hermes config

La configuration se résout selon l’ordre : remplacements CLI → config.yaml → .env → valeurs par défaut. Les clés API appartiennent dans .env ; les configurations structurées 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 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 obsolètes.
hermes config migrate	Appliquer les options nouvellement introduites de manière interactive.

Emplacement des fichiers — Tout est situé sous HERMES_HOME (par 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, élaguer 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 seule machine.
hermes profile export / import	Archiver ou restaurer un fichier tarball de profil.
hermes profile alias	Scripts enveloppe courts pour un changement rapide de profil.
hermes worktree list	Auditer les worktrees temporaires : âge, taille, et si chacun est sûr à supprimer. --json pour les scripts.
hermes worktree prune	Supprimer les arbres temporaires propres et fusionnés. --dry-run affiche le plan ; --older-than N restreint uniquement le balayage. Les arbres avec du travail non commité ou des commits uniques sont conservés.

Utilisez hermes -p work chat -q "..." pour des exécutions ponctuelles sans changer le profil par défaut collant. Sur un TTY, cela reste dans la session ; ajoutez --oneshot lorsque l’exécution du profil doit se terminer.

Hub de compétences, toolsets, hooks shell et plugins

Pour la configuration par profil et les compétences ajustées aux flux de travail de production réels par rôle, voir Compétences de l’Assistant Hermes AI pour les configurations de production réelles. Pour l’écriture et le débogage des fichiers SKILL.md — métadonnées, divulgation progressive et visibilité conditionnelle — voir Rédaction des compétences Hermes Agent — Structure et bonnes pratiques 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 via URL.
hermes curator status, run, pause, pin, rollback, …	Maintenance de compétences en arrière-plan et retour en arrière sûr.
hermes hooks list, test, revoke, doctor	Hooks shell déclarés et listes d’autorisation dans la configuration.
hermes plugins	Interface UI composite ou sous-commandes pour installer, activer, désactiver, supprimer des plugins.

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

La MEMORY.md / USER.md intégrée reste active ; les fournisseurs externes ajoutent des couches de rappel facultatives. Pour savoir comment cette architecture se comporte en pratique, lisez Système de mémoire de l’agent Hermes — Comment fonctionne réellement la mémoire AI persistante. Pour comparer les backends externes et les compromis d’activation, voir Comparaison des fournisseurs de mémoire pour agents — 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 supplémentaires au 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 des services 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 gateway migrate [--dry-run]	Fusionner les passerelles par profil sur une passerelle d’hôte unique. hermes update exécute ceci à moins qu’un pré-vol ne l’empêche. Il n’y a pas de retour en arrière --standalone.
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é des instructions slash de la passerelle.

Sur WSL, hermes gateway run à l’intérieur de tmux est le motif résilient lorsque gateway start se comporte mal. Pour des flux de travail complets sur téléphone utilisant cette même couche de passerelle, voir 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 de serveur sans tête et de bureau distant pour l’agent Hermes.

Planificateur Cron, webhooks et Kanban

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

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 analyses d’utilisation

Commande	Description
hermes doctor [--fix]	Diagnostics interactifs et réparation automatique facultative.
hermes status [--all] [--deep]	Statut concis ; vérifications plus profondes si nécessaire.
hermes dump [--show-keys]	Résumé de configuration amical pour coller sur Discord ou dans les problèmes GitHub.
hermes debug share	Téléverser un bundle de débogage redactionné 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 zip des données de home et chemins de restauration.
hermes insights [--days N] [--source …]	Analyses des jetons, du coût et de l’activité.

Lorsque quelque chose se brise 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 serveur MCP.
hermes mcp add, remove, list, test, configure	Gérer les connexions de client MCP depuis Hermes.
hermes acp	Serveur stdio du protocole Agent Client 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 type OpenClaw vers Hermes (--dry-run, préréglages, secrets facultatifs).
hermes import-agent [claude-code | codex]	Importer une configuration Claude Code (~/.claude) ou Codex CLI (~/.codex). Aperçu toujours d’abord ; les clés API ne sont jamais copiées. --sync ré-importe les sources dont les fichiers ont changé.

Migration OpenClaw — hermes claw migrate lit les répertoires home OpenClaw legacy ; la bascule complète par étapes, y compris la revue dry-run, la politique de conflit, la gestion des secrets et la prise en main des canaux, est couverte dans Comment migrer d’OpenClaw à Hermes Agent en toute sécurité. 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 /nom-de-competence. Les tableaux ci-dessous sont un sous-ensemble soigneusement sélectionné ; pour le registre complet, voir Documentation officielle de Hermes Agent à la fin de cet article.

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

Commande	Description
/new, /reset	Nouveau ID de session et historique.
/resume [name]	Reprendre une session nommée.
/compress [focus]	Compression de contexte manuelle avec sujet de focus facultatif.
/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 parallèle en arrière-plan, prompt suivant en file d’attente, poussée en milieu de boucle après le prochain outil.
/goal …	Objectif multi-tours persistant avec boucle de juge (status, pause, resume, clear).
/branch, /fork	Créer une branche de la conversation pour une exploration alternative.
/btw …	Question secondaire sur la conversation actuelle ; n’interrompt pas le tour principal.
/context [all]	Décomposition de l’utilisation du contexte. all ajoute les coûts par compétence et par toolset.
/status	Informations de session plus un récapitulatif local (tours récents, outils, fichiers). Aucun appel de modèle.
/sessions	Sélecteur en session : filtre, flèches, Entrée pour reprendre.

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

Commande	Description
/model … [--global]	Basculer entre les modèles parmi les fournisseurs configurés ; --global persiste le défaut.
/tools …, /toolsets	Bascules d’outils de session et liste des toolsets.
/skills …	Rechercher, installer et gérer les compétences depuis le chat.
/cron …	Interface 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é d’analyses.
/voice on, /voice tts	Enregistrement vocal CLI (Ctrl+B par défaut) et lecture orale.
/reasoning high	Augmenter l’effort de raisonnement pour la session.
/help, /quit	Aide ou quitter le CLI.

Une ligne qui commence par ! s’exécute sur le shell hôte sans un tour de modèle (!git status). Elle n’entre pas dans la conversation, et les commandes dangereuses atteignent toujours le prompt d’approbation. Ctrl+S range le brouillon du compositeur pour la session uniquement ; rien n’est écrit sur le disque.

Les applications de messagerie (Telegram, Discord, Slack et autres) exposent un ensemble slash qui se chevauche plus /approve, /restart, /commands, et des utilitaires de passerelle uniquement associés — les différences de plateforme sont documentées dans la référence des commandes slash sous Documentation officielle de Hermes Agent ci-dessous.

Lectures complémentaires utiles

Pages connexes sur ce site :

• Systèmes IA — Assistants auto-hébergés, RAG et Infrastructure locale — aperçu du cluster et comment les assistants s’intègrent dans la pile
• Mémoire des Systèmes IA — hub de mémoire et guides adjacents

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 « quelque chose est cassé » en diffs actionnables par rapport à une configuration connue fonctionnelle.