hermes Befehl — Vollständige Referenz & Beispiele

Übersicht

hermes ist der primäre Einstiegspunkt für Hermes Agent. Ohne Unterbefehl gestartet, öffnet es eine interaktive Chat-Sitzung in der konfigurierten Oberfläche (TUI oder klassisches REPL) — äquivalent zu hermes chat. Die CLI bietet außerdem Dutzende Unterbefehle für Konfiguration, Integrationen, Skills, Sitzungen und Wartung.

hermes [Optionen] [Befehl]

Globale Optionen

Option	Beschreibung
`-h, --help`	Hilfe anzeigen und beenden.
`--version, -V`	Versionsinformationen anzeigen und beenden.
`-z PROMPT, --oneshot PROMPT`	One-Shot-Modus: einen einzelnen Prompt senden und nur die finale Antwort auf stdout ausgeben. Kein Banner, kein Spinner, keine Session-ID-Zeile — ideal für Skripte und Pipes.
`--usage-file PATH`	Nur im One-Shot-Modus: nach dem Lauf einen JSON-Nutzungsbericht (Kosten, Token-Zählungen, Modell, api_calls) nach PATH schreiben.
`-m MODEL, --model MODEL`	Modell-Override für diesen Aufruf (z. B. `anthropic/claude-sonnet-4.6`). Gilt für `--oneshot` und `--tui`.
`--provider PROVIDER`	Provider-Override (z. B. `openrouter`, `anthropic`). Gilt für `--oneshot` und `--tui`.
`--reasoning LEVEL`	Reasoning-Aufwand: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` oder `ultra`.
`-t TOOLSETS, --toolsets TOOLSETS`	Kommagetrennte Toolsets für diesen Aufruf.
`--resume SESSION, -r SESSION`	Eine frühere Sitzung per ID oder Titel fortsetzen.
`--no-restore-cwd`	Nicht in das gespeicherte Arbeitsverzeichnis der fortgesetzten Sitzung wechseln.
`--continue [SESSION_NAME], -c [SESSION_NAME]`	Eine Sitzung per Name fortsetzen, oder die zuletzt verwendete, wenn kein Name angegeben ist.
`--worktree, -w`	In einem isolierten Git-Worktree ausführen (für parallele Agenten).
`--accept-hooks`	Unbekannte Shell-Hooks ohne TTY-Prompt automatisch genehmigen (nützlich für CI und Headless).
`--skills SKILLS, -s SKILLS`	Eine oder mehrere Skills für die Sitzung vorladen (Flag wiederholbar oder kommagetrennt).
`--yolo`	Alle Genehmigungs-Prompts für gefährliche Befehle umgehen (auf eigene Gefahr).
`--pass-session-id`	Die Session-ID in den System-Prompt des Agenten aufnehmen.
`--ignore-user-config`	`~/.hermes/config.yaml` ignorieren und auf eingebaute Standardwerte zurückfallen (Credentials aus `.env` werden weiterhin geladen).
`--ignore-rules`	Die automatische Injektion von `AGENTS.md`, `SOUL.md`, `.cursorrules`, Memory und vorgeladenen Skills überspringen.
`--safe-mode`	Fehlerbehebungsmodus: ALLE Anpassungen deaktivieren — Benutzerkonfiguration, Memory-Injektion, Plugins und MCP-Server. Impliziert `--ignore-user-config` und `--ignore-rules`.
`--tui`	Die moderne TUI statt des klassischen REPL starten.
`--cli`	Das klassische `prompt_toolkit`-REPL erzwingen (überschreibt `display.interface=tui`).
`--dev`	Mit `--tui`: TypeScript-Quellen per `tsx` ausführen (dist-Build überspringen).
`--profile PROFILE, -p PROFILE`	Unter einem benannten Hermes-Profil ausführen (setzt `HERMES_HOME`). Wird vor der Argumentanalyse verarbeitet und funktioniert daher mit jedem Unterbefehl.

Unterbefehle

hermes bringt mehr als sechzig Unterbefehle mit. Die wichtigsten Gruppen:

Gruppe	Unterbefehle
Chat & Modelle	`chat`, `model`, `moa`, `fallback`, `acp`
Integrationen & Messaging	`gateway`, `whatsapp`, `whatsapp-cloud`, `slack`, `send`, `webhook`, `portal`, `proxy`, `mcp`, `lsp`, `computer-use`
Konfiguration & Zugriff	`setup`, `config`, `profile`, `project`, `secrets`, `egress`, `skin`, `console`, `pairing`, `approvals`, `auth`, `login`, `logout`
Sitzungen, Memory & Analysen	`sessions`, `memory`, `journey` (Alias für `learning` + `memory-graph`), `checkpoints`, `insights`, `prompt-size`, `logs`
Skills & Erweiterungen	`skills`, `bundles`, `plugins`, `curator`, `pets`, `sync`
Verwaltung & 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`

Führe hermes <befehl> --help aus, um Details zu einem Unterbefehl zu erhalten.

Beispiele

hermes                          # Interaktiven Chat starten
hermes chat -q "Hello"          # Einzelabfrage-Modus
hermes -z "Summarize this repo" # One-Shot-Modus: nur die Antwort ausgeben
hermes --tui                    # Moderne TUI starten
hermes --cli                    # Klassisches REPL erzwingen
hermes -c                       # Zuletzt verwendete Sitzung fortsetzen
hermes -c "my project"          # Sitzung per Name fortsetzen
hermes --resume <session_id>    # Bestimmte Sitzung per ID fortsetzen
hermes -m anthropic/claude-sonnet-4.6 --reasoning high   # Modell- und Reasoning-Override
hermes -t web -s hermes-agent-dev,github-auth            # Toolset + Skills vorladen
hermes --profile work           # Unter dem Profil 'work' ausführen
hermes setup                    # Setup-Assistent starten
hermes model                    # Standardmodell wählen
hermes config edit              # Konfiguration in $EDITOR bearbeiten
hermes gateway install          # Gateway-Hintergrunddienst installieren
hermes sessions list            # Frühere Sitzungen auflisten
hermes logs -f                  # agent.log in Echtzeit verfolgen
hermes dashboard                # Web-Dashboard starten (Port 9119)
hermes update                   # Auf die neueste Version aktualisieren

Tipps

hermes ohne Argumente startet den interaktiven Chat — äquivalent zu hermes chat.
--tui für die Vollbild-Oberfläche verwenden oder display.interface: tui in config.yaml setzen, um sie zum Standard zu machen.
-c/--continue setzt die zuletzt verwendete Sitzung fort; -r/--resume zielt auf eine bestimmte Session-ID.
-z/--oneshot ist für Skripte und Pipes gedacht; kombiniere es mit --usage-file, um die Kosten zu verfolgen.
--safe-mode deaktiviert alle Anpassungen — der erste Versuch, wenn etwas kaputtgeht.
--yolo überspringt alle Genehmigungs-Prompts; nur in vertrauenswürdigen, isolierten Umgebungen verwenden.
--profile/-p wird vor der Argumentanalyse verarbeitet und funktioniert daher mit jedem Unterbefehl.