Référence Hermes Agent

Référence Hermes Agent

Cette page fait partie du référence technique francophone consacré à Hermes Agent. Elle répond à l'intention de recherche : accéder aux références.

Le contenu s'appuie sur la documentation officielle Hermes Agent associée à cette page. L'objectif n'est pas de remplacer la documentation de Nous Research, mais de fournir une lecture claire en français, structurée pour aller vite, avec un maillage logique vers les pages complémentaires du même site.

À retenir

• Sujet principal : hermes agent référence.
• Type de page : hub.
• Cluster : reference.
• Source canonique : documentation officielle Hermes Agent.
• Aucun lien vers l'autre domaine n'est utilisé dans cette page.

Comment utiliser cette section

Cette section regroupe les pages du cluster reference. Commencez par cette page si vous voulez comprendre le sujet dans son ensemble, puis ouvrez les guides détaillés selon votre contexte.

Chaque page interne contient des liens vers les prérequis, les pages voisines et les suites logiques. Le but est de créer un parcours utile, pas une liste brute de pages SEO.

Base officielle

This page covers the terminal commands you run from your shell.

For in-chat slash commands, see Slash Commands Reference.

Global entrypoint

hermes [global-options] <command> [subcommand/options]

Global options

• Option — Description
• --version, -V — Show version and exit.
• --profile <name>, -p <name> — Select which Hermes profile to use for this invocation. Overrides the sticky default set by hermes profile use.
• --resume <session>, -r <session> — Resume a previous session by ID or title.
• --continue [name], -c [name] — Resume the most recent session, or the most recent session matching a title.
• --worktree, -w — Start in an isolated git worktree for parallel-agent workflows.
• --yolo — Bypass dangerous-command approval prompts.
• --pass-session-id — Include the session ID in the agent's system prompt.
• --ignore-user-config — Ignore ~/.hermes/config.yaml and fall back to built-in defaults. Credentials in .env are still loaded.
• --ignore-rules — Skip auto-injection of AGENTS.md, SOUL.md, .cursorrules, memory, and preloaded skills.
• --tui — Launch the TUI instead of the classic CLI. Equivalent to HERMES_TUI=1. Always wins over display.interface.
• --cli — Force the classic prompt_toolkit REPL. Use this to override display.interface: tui for a single invocation.
• --dev — With --tui: run the TypeScript sources directly via tsx instead of the prebuilt bundle (for TUI contributors).

Top-level commands

• Command — Purpose
• hermes chat — Interactive or one-shot chat with the agent.
• hermes model — Interactively choose the default provider and model.
• hermes moa — Configure named Mixture of Agents presets selectable from the model picker.
• hermes fallback — Manage fallback providers tried when the primary model errors.
• hermes gateway — Run or manage the messaging gateway service.
• hermes proxy — Local OpenAI-compatible proxy that attaches OAuth provider credentials. See Subscription Proxy.
• hermes lsp — Manage Language Server Protocol integration (semantic diagnostics for write_file/patch).
• hermes setup — Interactive setup wizard for all or part of the configuration.
• hermes whatsapp — Configure and pair the WhatsApp bridge.
• hermes whatsapp-cloud — Configure the official Meta WhatsApp Business Cloud API adapter (Business account + public webhook required). Distinct from hermes whatsapp (Baileys personal-account bridge).
• hermes slack — Slack helpers (currently: generate the app manifest with every command as a native slash).
• hermes auth — Manage credentials — add, list, remove, reset, status, logout. Handles OAuth flows for Codex/Nous/Anthropic.
• hermes login / logout — Deprecated — use hermes auth instead.
• hermes send — Send a one-shot message to a configured messaging platform (Telegram, Discord, Slack, Signal, SMS, …). Useful from shell scripts, cron jobs, CI hooks, and monitoring daemons — no agent loop, no LLM.
• hermes secrets — Manage external secret sources (currently Bitwarden Secrets Manager) for pulling API keys at process startup instead of from ~/.hermes/.env.
• hermes migrate — Diagnose and (optionally) rewrite config.yaml to replace references to retired models or deprecated settings (e.g. migrate xai).
• hermes status — Show agent, auth, and platform status.
• hermes cron — Inspect and tick the cron scheduler.
• hermes kanban — Multi-profile collaboration board (tasks, links, dispatcher).
• hermes project — Manage named, multi-folder workspaces (projects). Anchors desktop session grouping and, when bound to a kanban board, gives tasks a deterministic worktree + branch convention. State is per-profile.
• hermes webhook — Manage dynamic webhook subscriptions for event-driven activation.
• hermes hooks — Inspect, approve, or remove shell-script hooks declared in config.yaml.
• hermes doctor — Diagnose config and dependency issues.
• hermes security audit — On-demand supply-chain audit (OSV.dev) for the venv, plugin requirements, and pinned MCP servers.
• hermes dump — Copy-pasteable setup summary for support/debugging.
• hermes prompt-size — Show a byte breakdown of the system prompt + tool schemas (skills index, memory, profile). Runs offline.
• hermes debug — Debug tools — upload logs and system info for support.
• hermes backup — Back up Hermes home directory to a zip file.
• hermes checkpoints — Inspect / prune / clear ~/.hermes/checkpoints/ (the shadow store used by /rollback). Run with no args for a status overview.
• hermes import — Restore a Hermes backup from a zip file.
• hermes logs — View, tail, and filter agent/gateway/error log files.
• hermes config — Show, edit, migrate, and query configuration files.
• hermes pairing — Approve or revoke messaging pairing codes.
• hermes skills — Browse, install, publish, audit, and configure skills.
• hermes bundles — Group several skills under a single /<name> slash command. See Skill Bundles.
• hermes curator — Background skill maintenance — status, run, pause, pin. See Curator.
• hermes memory — Configure external memory provider. Plugin-specific subcommands (e.g. hermes honcho) register automatically when their provider is active.
• hermes acp — Run Hermes as an ACP server for editor integration.
• hermes mcp — Manage MCP server configurations and run Hermes as an MCP server.
• hermes plugins — Manage Hermes Agent plugins (install, enable, disable, remove).
• hermes portal — Nous Portal status, subscription link, and Tool Gateway routing. See Tool Gateway.
• hermes tools — Configure enabled tools per platform.
• hermes computer-use — Install or check the cua-driver backend (macOS Computer Use).
• hermes pets — Browse, install, and select petdex animated pets shown across the CLI, TUI, and desktop app. Subcommands: list, install, select, show, off, scale, remove, doctor.
• hermes sessions — Browse, export, prune, rename, and delete sessions.
• hermes insights — Show token/cost/activity analytics.
• hermes claw — OpenClaw migration helpers.
• hermes dashboard — Launch the web dashboard for managing config, API keys, and sessions.
• hermes desktop (alias gui) — Build and launch the native Electron desktop app.
• hermes profile — Manage profiles — multiple isolated Hermes instances.
• hermes completion — Print shell completion scripts (bash/zsh/fish).
• hermes version — Show version information.
• hermes update — Pull latest code and reinstall dependencies. --check previews without installing; --backup takes a pre-pull HERMES_HOME snapshot.
• hermes uninstall — Remove Hermes from the system.

hermes chat

hermes chat [options]

Common options:

• Option — Description
• -q, --query "..." — One-shot, non-interactive prompt.
• -m, --model <model> — Override the model for this run.
• -t, --toolsets <csv> — Enable a comma-separated set of toolsets.
• --provider <provider> — Force a provider: auto, openrouter, nous, openai-codex, copilot-acp, copilot, anthropic, gemini, huggingface, novita (aliases novita-ai, novitaai), openai-api, zai, kimi-coding, kimi-coding-cn, minimax, minimax-cn, minimax-oauth, kilocode, xiaomi, arcee, gmi, alibaba, alibaba-coding-plan (alias alibaba_coding), deepseek, nvidia, ollama-cloud, xai (alias grok), xai-oauth (alias grok-oauth), qwen-oauth, bedrock, opencode-zen, opencode-go, azure-foundry, lmstudio, stepfun, tencent-tokenhub (alias tencent, tokenhub).
• -s, --skills <name> — Preload one or more skills for the session (can be repeated or comma-separated).
• -v, --verbose — Verbose output.
• -Q, --quiet — Programmatic mode: suppress banner/spinner/tool previews.
• --image <path> — Attach a local image to a single query.
• --resume <session> / --continue [name] — Resume a session directly from chat.
• --worktree — Create an isolated git worktree for this run.
• --checkpoints — Enable filesystem checkpoints before destructive file changes.
• --yolo — Skip approval prompts.
• --pass-session-id — Pass the session ID into the system prompt.
• --ignore-user-config — Ignore ~/.hermes/config.yaml and use built-in defaults. Credentials in .env are still loaded. Useful for isolated CI runs, reproducible bug reports, and third-party integrations.
• --ignore-rules — Skip auto-injection of AGENTS.md, SOUL.md, .cursorrules, persistent memory, and preloaded skills. Combine with --ignore-user-config for a fully isolated run.
• `--safe

Points de vigilance

• Vérifiez toujours la version active de Hermes Agent avant d'appliquer une commande ou une configuration.
• Ne collez pas de clé API dans un chat public ou dans une page visible.
• Gardez les secrets dans les fichiers ou gestionnaires prévus pour cela.
• Si une fonctionnalité dépend d'un provider, d'un plugin ou d'une plateforme de messagerie, vérifiez que le composant est bien activé dans votre profil.
• Pour une installation de production, testez d'abord le flux complet sur une machine ou un profil isolé.

Exemple de parcours logique

1. Lire la page courante pour comprendre hermes agent référence.
2. Ouvrir le hub parent du cluster reference.
3. Passer ensuite aux pages complémentaires proposées dans « À lire ensuite ».
4. Revenir à la documentation officielle si vous avez besoin du détail exact ou d'une commande récemment modifiée.

FAQ rapide

Cette page remplace-t-elle la documentation officielle ?

Non. Elle sert de guide francophone structuré. Le lien vers la source officielle est disponible en bas de page.

Les commandes sont-elles garanties à jour ?

Elles sont basées sur la documentation officielle récupérée au moment de la génération. Pour un usage critique, vérifiez toujours la page officielle liée en bas.

Pourquoi autant de liens internes ?

Hermes Agent est un système modulaire. L'installation, les providers, les outils, la mémoire, les skills, la sécurité et les plateformes se répondent. Le maillage interne aide à suivre ce chemin sans tomber sur des pages orphelines.

Comment lire cette page efficacement

Commencez par identifier votre situation : installation locale, usage serveur, configuration d'un provider, connexion à une plateforme, automatisation ou usage développeur. Hermes Agent est modulaire : une fonctionnalité dépend souvent d'un autre bloc. Par exemple, une automatisation cron devient réellement utile quand le modèle, les outils et le canal de livraison sont déjà configurés.

Pour éviter les erreurs, avancez toujours dans cet ordre : vérifier le prérequis, appliquer la commande ou la configuration, relancer une session si nécessaire, puis tester avec une action simple. Si le résultat ne correspond pas à ce qui est attendu, revenez à la page officielle liée en bas et comparez la version de votre installation avec la documentation actuelle.

Bonnes pratiques

• Garder une configuration minimale tant que le premier test n'est pas validé.
• Ajouter les outils et plateformes progressivement.
• Séparer les profils si plusieurs usages doivent cohabiter.
• Documenter les procédures répétées dans des skills plutôt que dans de longs prompts.
• Vérifier les droits, tokens et scopes avant d'accuser le modèle ou Hermes Agent.
• Relancer la session après un changement de configuration important.

Erreurs fréquentes

La première erreur consiste à activer trop de choses trop tôt. Plus la configuration initiale est large, plus le diagnostic devient difficile. La deuxième erreur consiste à confondre un problème de provider avec un problème Hermes : si le modèle ne répond pas, vérifiez d'abord l'authentification, la clé API, le nom du modèle et le provider sélectionné. La troisième erreur consiste à oublier que certains changements ne s'appliquent qu'à une nouvelle session ou après redémarrage du gateway.

Suite recommandée

Après cette page, ouvrez les liens internes proposés dans la section « À lire ensuite ». Ils ont été choisis pour suivre une progression logique dans le même site, sans envoyer vers l'autre domaine.