Commande hermes — Référence Complète & Exemples

Vue d’ensemble

hermes est le point d’entrée principal de Hermes Agent. Exécuté sans sous-commande, il lance une session de chat interactive dans l’interface configurée (TUI ou REPL classique) — c’est l’équivalent de hermes chat. La CLI expose aussi des dizaines de sous-commandes pour la configuration, les intégrations, les skills, les sessions et la maintenance.

hermes [options] [commande]

Options globales

Option	Description
`-h, --help`	Afficher l’aide et quitter.
`--version, -V`	Afficher la version et quitter.
`-z PROMPT, --oneshot PROMPT`	Mode one-shot : envoyer un seul prompt et imprimer uniquement la réponse finale sur stdout. Pas de bannière, de spinner ni de ligne d’ID de session — idéal pour les scripts et les pipes.
`--usage-file PATH`	Uniquement en mode one-shot : écrire un rapport d’utilisation JSON (coût, compteurs de tokens, modèle, api_calls) dans PATH après l’exécution.
`-m MODEL, --model MODEL`	Remplacement du modèle pour cet appel (ex. `anthropic/claude-sonnet-4.6`). S’applique à `--oneshot` et `--tui`.
`--provider PROVIDER`	Remplacement du fournisseur (ex. `openrouter`, `anthropic`). S’applique à `--oneshot` et `--tui`.
`--reasoning LEVEL`	Effort de raisonnement : `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` ou `ultra`.
`-t TOOLSETS, --toolsets TOOLSETS`	Toolsets séparés par des virgules à activer pour cet appel.
`--resume SESSION, -r SESSION`	Reprendre une session précédente par ID ou par titre.
`--no-restore-cwd`	Ne pas revenir dans le répertoire de travail enregistré de la session reprise.
`--continue [SESSION_NAME], -c [SESSION_NAME]`	Reprendre une session par nom, ou la plus récente si aucun nom n’est donné.
`--worktree, -w`	Exécuter dans un git worktree isolé (pour les agents en parallèle).
`--accept-hooks`	Approuver automatiquement les shell hooks inconnus sans prompt TTY (utile en CI et headless).
`--skills SKILLS, -s SKILLS`	Précharger un ou plusieurs skills pour la session (flag répétable ou séparés par des virgules).
`--yolo`	Contourner tous les prompts d’approbation de commandes dangereuses (à vos risques et périls).
`--pass-session-id`	Inclure l’ID de session dans le system prompt de l’agent.
`--ignore-user-config`	Ignorer `~/.hermes/config.yaml` et revenir aux valeurs intégrées par défaut (les identifiants de `.env` sont toujours chargés).
`--ignore-rules`	Ignorer l’injection automatique de `AGENTS.md`, `SOUL.md`, `.cursorrules`, de la mémoire et des skills préchargés.
`--safe-mode`	Mode de dépannage : désactiver TOUTES les personnalisations — configuration utilisateur, injection de mémoire, plugins et serveurs MCP. Implique `--ignore-user-config` et `--ignore-rules`.
`--tui`	Lancer la TUI moderne au lieu du REPL classique.
`--cli`	Forcer le REPL classique de `prompt_toolkit` (remplace `display.interface=tui`).
`--dev`	Avec `--tui` : exécuter les sources TypeScript via `tsx` (ignorer le build dist).
`--profile PROFILE, -p PROFILE`	Exécuter sous un profil Hermes nommé (définit `HERMES_HOME`). Consommé avant l’analyse des arguments, il fonctionne donc avec toutes les sous-commandes.

Sous-commandes

hermes fournit plus de soixante sous-commandes. Les principaux groupes :

Groupe	Sous-commandes
Chat et modèles	`chat`, `model`, `moa`, `fallback`, `acp`
Intégrations et messagerie	`gateway`, `whatsapp`, `whatsapp-cloud`, `slack`, `send`, `webhook`, `portal`, `proxy`, `mcp`, `lsp`, `computer-use`
Configuration et accès	`setup`, `config`, `profile`, `project`, `secrets`, `egress`, `skin`, `console`, `pairing`, `approvals`, `auth`, `login`, `logout`
Sessions, mémoire et analytique	`sessions`, `memory`, `journey` (alias de `learning` + `memory-graph`), `checkpoints`, `insights`, `prompt-size`, `logs`
Skills et extensions	`skills`, `bundles`, `plugins`, `curator`, `pets`, `sync`
Gestion et administration	`status`, `doctor`, `security`, `cron`, `hooks`, `backup`, `import`, `import-agent`, `migrate`, `dump`, `debug`, `monitoring`, `version`, `update`, `uninstall`, `completion`, `dashboard`, `serve`, `desktop` (alias `gui`), `claw`, `kanban`, `tools`

Exécutez hermes <commande> --help pour les détails d’une sous-commande.

Exemples

hermes                          # Démarrer le chat interactif
hermes chat -q "Hello"          # Mode requête unique
hermes -z "Summarize this repo" # Mode one-shot : seule la réponse est affichée
hermes --tui                    # Lancer la TUI moderne
hermes --cli                    # Forcer le REPL classique
hermes -c                       # Reprendre la session la plus récente
hermes -c "my project"          # Reprendre une session par nom
hermes --resume <session_id>    # Reprendre une session précise par ID
hermes -m anthropic/claude-sonnet-4.6 --reasoning high   # Remplacement modèle + raisonnement
hermes -t web -s hermes-agent-dev,github-auth            # Toolset + skills préchargés
hermes --profile work           # Exécuter sous le profil 'work'
hermes setup                    # Lancer l'assistant de configuration
hermes model                    # Choisir le modèle par défaut
hermes config edit              # Modifier la configuration dans $EDITOR
hermes gateway install          # Installer le service de gateway en arrière-plan
hermes sessions list            # Lister les sessions passées
hermes logs -f                  # Suivre agent.log en temps réel
hermes dashboard                # Démarrer le dashboard web (port 9119)
hermes update                   # Mettre à jour vers la dernière version

Conseils

hermes sans argument démarre le chat interactif — équivalent à hermes chat.
Utilisez --tui pour l’interface plein écran, ou définissez display.interface: tui dans config.yaml pour en faire la valeur par défaut.
-c/--continue reprend la session la plus récente ; -r/--resume cible un ID de session précis.
-z/--oneshot est conçu pour les scripts et les pipes ; associez-le à --usage-file pour suivre les coûts.
--safe-mode désactive toutes les personnalisations — le premier réflexe quand quelque chose casse.
--yolo ignore tous les prompts d’approbation ; à n’utiliser que dans des environnements fiables et isolés.
--profile/-p est traité avant l’analyse des arguments, il fonctionne donc avec toutes les sous-commandes.