Hermes Agent CLI-Referenz — Befehle, Flags und Slash-Kurzbefehle

Hermes Agent von Nous Research ist ein modellunabhängiger, werkzeugnutzender Assistent, den Sie lokal oder auf einem VPS ausführen können – aus der Shell, einem Vollbild-TUI oder einem Messaging-Gateway.

Hermes lässt Sie nicht auf eine einzige Oberfläche fest. Sie können nutzen:

• die klassische hermes / hermes chat CLI,
• die Vollbild-hermes --tui-Sitzung,
• ein dauerhaft laufendes hermes gateway für Telegram, Discord, Slack und andere Messaging-Plattformen,
• hermes dashboard für eine lokale Browser-Oberfläche, wenn das Web-Add-on installiert ist.

Diese Pfade teilen sich dieselbe Konfiguration und dieselben Daten unter ~/.hermes; diese Seite listet die Shell-Befehle auf, die in diesen Modi relevant sind.

Nachfolgend finden Sie eine dichte Befehlsreferenz nach Aufgabe gruppiert, überprüft anhand der offiziellen CLI-Befehlsreferenz am 6. Oktober 2026. Der neueste stabile Tag zu diesem Datum ist v0.21.5 (v2026.9.24).

Hermes Agent installieren und erste CLI-Befehle

Für Installation und Troubleshooting starten Sie mit Hermes AI Assistant — Installation, Einrichtung, Workflow und Troubleshooting.

Das Installationsprogramm holt das Repository, richtet eine Python-Umgebung ein und verdrahtet die hermes-Ausführbare Datei. Nach source ~/.bashrc oder ~/.zshrc ist Ihr Standard-Einstiegspunkt für interaktiven Chat einfach hermes (aus derselben Familie wie hermes chat).

Befehl	Beschreibung
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash	Offizielle Einzeilen-Installation (Linux, macOS, WSL2).
hermes / hermes chat	Startet interaktiven Chat nach der Installation (täglicher Standard-Einstieg).
hermes --version / hermes version	Gibt Versionsinformationen aus.
hermes completion bash | zsh | fish	Gibt Shell-Vervollständigungsskripte für Tab-Vervollständigung aus.
hermes update [--check] [--backup] [--restart-gateway]	Holt den neuesten Code, installiert Abhängigkeiten neu, optionales Home-Snapshot vor dem Update oder Gateway-Neustart.
hermes uninstall [--full] [--yes]	Entfernt Hermes; optionale vollständige Datenlöschung.

Natives Windows wird nicht unterstützt; verwenden Sie WSL2. Android-Installationen über Termux folgen einem dedizierten Pfad in den Upstream-Dokumentationen.

Globale Flags für jeden hermes-Aufruf

Diese Flags gelten vor Unterbefehlen und ändern welches Profil, welche Sitzung oder wie viel persönliche Konfiguration geladen wird.

Flag	Beschreibung
--profile, -p	Wählt das Hermes-Profil für diesen Lauf (überschreibt das stichfeste Standardprofil von hermes profile use).
--resume, -r	Setzt eine Sitzung per ID oder Titel fort.
--continue [name], -c	Setzt die letzte Sitzung fort oder die letzte, die zu einem Titel passt.
--worktree, -w	Startet in einem isolierten Git-Worktree für parallele Agents.
--yolo	Umgeht Genehmigungsabfragen für gefährliche Befehle (mit Vorsicht verwenden).
--pass-session-id	Enthalte die Sitzungs-ID im System-Prompt.
--ignore-user-config	Überspringt ~/.hermes/config.yaml (nur Standardwerte); .env wird weiterhin geladen.
--ignore-rules	Überspringt die automatische Injektion von AGENTS.md, SOUL.md, .cursorrules, Speicher und vorgeladenen Skills.
--tui	Startet das TUI (äquivalent zu HERMES_TUI=1).
--dev	Führt mit --tui TS-Quellcode über tsx für die TUI-Entwicklung aus.

Isolierte Automatisierung paart oft hermes chat --ignore-user-config --ignore-rules mit hermes -z für reproduzierbare Einmal-Läufe.

hermes chat, Einmal-Prompts und hermes -z

Befehl / Muster	Beschreibung
hermes chat	Interaktiver oder skriptbasierter Chat; Hauptoberfläche für -q, -m, --provider, Toolsets, Fortsetzen, Worktree, Checkpoints.
hermes chat -q "..."	Übermittelt den Prompt auf einem TTY als ersten Turn und bleibt in der Sitzung. Vor 0.21 wurde nach einer Antwort beendet.
hermes chat --oneshot -q "..."	Antwortet und beendet sich (das alte Verhalten von -q). Impliziert durch -Q und durch nicht-TTY-Stdio. Verwenden Sie dies, wenn Sie Tool-Ausgabe in der Transkription benötigen.
hermes chat --query-file PATH	Liest den Prompt aus einer Datei oder - für Stdin. Es wird nichts shell-interpretiert. Gegenseitig ausschließend mit -q.
hermes -z "..."	Skriptbasierter Einmal-Lauf — nur die finale Antwort auf Stdout, kein Banner oder Sitzungs-Rauschen. Gleicher Agent und Werkzeuge; am besten für Pipes und Skripte.
hermes -z "…" --usage-file PATH	Schreibt nach einem -z-Lauf einen JSON-Nutzungsbericht (Token, Kosten, completed / failed / partial), auch wenn der Lauf fehlschlägt.
hermes chat -q "…" --format stream-json	JSONL-Events auf Stdout (system, text, tool_use, tool_result, result). Impliziert leise; lehnt --tui ab.
hermes chat --quiet, -Q	Leiserer programmatischer Modus (Banner und Tool-Vorschauen unterdrückt). Impliziert ebenfalls Oneshot in Kombination mit -q.
-m / --model, --provider	Lauf-spezifische Modell- und Provider-Überschreibungen; Umgebungsvariablen HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER spiegeln das Verhalten wider.
-t / --toolsets	Aktiviert kommatagetrennte Toolsets für den Lauf.
-s / --skills	Lädt Skills vor (wiederholbar oder kommatagetrennt).
--image path	Hängt ein lokales Bild an eine einzelne Abfrage an.
--checkpoints	Aktiviert Dateisystem-Checkpoints vor destruktiven Änderungen.
--max-turns N	Begrenzt die Iterationen des Tool-Aufrufs pro Turn (Standard 500 oder agent.max_turns in der Konfiguration).
--safe-mode	Deaktiviert Benutzereinstellungen, Regeln, Speicher, Plugins, Shell-Hooks und MCP. Impliziert --ignore-user-config und --ignore-rules.
--source	Sitzungsquellen-Tag (cli vs. tool für Integrationen). Einmal-Läufe haben standardmäßig oneshot.

Hermes Modell außerhalb der Sitzung vs. /model innerhalb — Das Ausführen von hermes model aus der Shell ist der Ort, an dem Sie Provider, Schlüssel und OAuth hinzufügen. Slash /model wechselt nur zwischen bereits konfigurierten Providern. Wenn Sie nur OpenRouter in /model sehen, beenden Sie die Sitzung und führen Sie hermes model aus.

Exit-Codes. Ein chat --oneshot / -Q-Lauf beendet sich mit 0, wenn der Turn abgeschlossen wurde, mit 1, wenn er fehlschlug, mittendrin stoppte, das Iterationsbudget erreichte oder nie startete, und mit 130 bei Unterbrechung. hermes -z verwendet eine andere Zuordnung: 0 abgeschlossen, 2 fehlgeschlagen oder teilweise (auch wenn es eine Erklärung ausgab), 1, wenn ein abgeschlossener Turn keinen Text erzeugte, 130 bei Unterbrechung. Beurteilen Sie eine Pipeline anhand des Codes, nicht daran, ob Stdout leer ist.

Modell-Wähler, Credential-Pools und Fallback-Provider

Befehl	Beschreibung
hermes model	Interaktiver Provider- und Modell-Wähler; Schlüssel, OAuth, benutzerdefinierte Endpunkte.
hermes auth	Credential-Pools — add, list, remove, reset für rotierbare Schlüssel und OAuth.
hermes fallback [list | add | remove | clear]	Verwaltet geordnete Fallback-Provider, wenn der Primär-Provider Fehler oder Rate-Limits meldet.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Sektionsweise oder vollständige interaktive Einrichtung (--quick, --reset, --non-interactive).
hermes setup --portal	Einmalige Nous Portal-Anmeldung: OAuth, setzt Nous als Inferenz-Provider, Opt-in für das Tool Gateway.
hermes portal [status | open | tools]	Portal-Auth-Zustand und Tool Gateway-Routing. Ohne Unterbefehl wird status ausgeführt.

hermes login wurde entfernt. Verwenden Sie hermes auth für OAuth und Credential-Pools, hermes model zum Auswählen eines Providers oder hermes setup für den vollständigen Assistenten. hermes auth logout <provider> löscht eine gespeicherte Anmeldung.

Die Wahl zwischen lokalen OpenAI-kompatiblen Endpunkten und gehosteten APIs für hermes model folgt denselben Abwägungen wie allgemeines LLM-Hosting (Latenz, Kosten, Betrieb).

Sobald Ihr Standard-Endpunkt bei Qwen oder Gemma auf etwas wie Ollama endet, sind Sampler-Standardwerte genauso wichtig wie die eingegebene Modell-ID; aggregierte, agent-orientierte Temperatur- und Strafe-Presets finden Sie in Agentische LLM-Inferenz-Parameter für Qwen und Gemma.

Konfigurationsdateien und hermes config-Befehle

Die Konfiguration wird als CLI-Überschreibungen → config.yaml → .env → Standardwerte aufgelöst. API-Schlüssel gehören in .env; strukturierte Einstellungen in config.yaml.

Befehl	Beschreibung
hermes config show	Zeigt die effektive Konfiguration an.
hermes config edit	Öffnet config.yaml in $EDITOR.
hermes config set key value	Setzt Werte (Geheimnisse werden zu .env geroutet, Nicht-Geheimnisse zu YAML).
hermes config path / hermes config env-path	Gibt Pfade zu Konfigurations- und Env-Dateien aus.
hermes config check	Erkent fehlende oder veraltete Einstellungen.
hermes config migrate	Wendet neu eingeführte Optionen interaktiv an.

Wo Dateien liegen — Alles befindet sich unter HERMES_HOME (Standard ~/.hermes) für Konfiguration, Geheimnisse, Speicher, Skills, Sitzungen, Gateway-Zustand und Logs.

Sitzungsverwaltung und hermes profile

Befehl	Beschreibung
hermes sessions list	Listet jüngste Sitzungen auf.
hermes sessions browse	Interaktiver Wähler mit Suche und Fortsetzen.
hermes sessions export	Exportiert Sitzungen (z. B. JSONL).
hermes sessions delete, prune, rename, stats	Löscht eine Sitzung, entfernt alte, benennt Titel um, zeigt Store-Statistiken.
hermes profile list | use | create | delete | show | rename	Verwaltet isolierte Hermes-Instanzen auf einem Computer.
hermes profile export / import	Archiviert oder stellt ein Profil-Tarball wieder her.
hermes profile alias	Kurze Wrapper-Skripte für schnelles Umschalten zwischen Profilen.
hermes worktree list	Audit von Scratch-Worktrees: Alter, Größe und ob jeder sicher entfernt werden kann. --json für Skripte.
hermes worktree prune	Entfernt saubere, gemergte Scratch-Trees. --dry-run gibt den Plan aus; --older-than N schränkt den Durchlauf nur ein. Trees mit uncommittetem Arbeit oder einzigartigen Commits werden behalten.

Verwenden Sie hermes -p work chat -q "..." für Ad-hoc-Läufe, ohne das stichfeste Standardprofil zu ändern. Auf einem TTY bleibt das in der Sitzung; fügen Sie --oneshot hinzu, wenn der Profil-Lauf beendet werden muss.

Skills-Hub, Toolsets, Shell-Hooks und Plugins

Für profilbasierte Konfiguration und auf reale Produktions-Workflows nach Rolle abgestimmte Skills, siehe Hermes AI Assistant Skills für echte Produktionssetups. Zum Schreiben und Debuggen von SKILL.md-Dateien – Metadaten, progressive Offenlegung und konditionale Sichtbarkeit – siehe Hermes Agent Skill Autoring — SKILL.md-Struktur und Best Practices.

Befehl	Beschreibung
hermes tools	Interaktive Tool-Aktivierung pro Plattform; --summary gibt die aktuellen Auswahlmöglichkeiten aus.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config	Skills-Hub-Workflows einschließlich Register und URL-Installationen.
hermes curator status, run, pause, pin, rollback, …	Hintergrund-Wartung von Skills und sichere Rollbacks.
hermes hooks list, test, revoke, doctor	Deklarierte Shell-Hooks und Allowlists in der Konfiguration.
hermes plugins	Composite-UI oder Unterbefehle zum Installieren, Aktivieren, Deaktivieren und Entfernen von Plugins.

Integrierter Speicher und hermes memory-Provider

Die integrierten MEMORY.md / USER.md bleiben aktiv; externe Provider fügen optionale Abruf-Ebenen hinzu. Für das Verhalten dieser Architektur in der Praxis lesen Sie Hermes Agent Memory System — Wie persistenter KI-Speicher tatsächlich funktioniert. Zum Vergleichen externer Backends und Aktivierungs-Abwägungen, siehe Agent Memory Provider im Vergleich — Honcho, Mem0, Hindsight und fünf weitere.

Befehl	Beschreibung
hermes memory setup	Interaktive Konfiguration externer Speicher-Provider.
hermes memory status	Zeigt aktive Provider-Einstellungen.
hermes memory off	Deaktiviert externen Provider; integrierte Dateien bleiben erhalten.

Wenn ein Provider aktiv ist, kann er zusätzliche provider-spezifische Top-Level-Unterbefehle registrieren — führen Sie hermes --help aus, um zu sehen, was aktuell verdrahtet ist.

Messaging-Gateway, DM-Pairing und Plattformen

Befehl	Beschreibung
hermes gateway setup	Interaktive Einrichtung der Messaging-Plattform.
hermes gateway run	Gateway im Vordergrund (empfohlen auf WSL, Docker, Termux).
hermes gateway start | stop | restart | status	systemd / launchd Dienststeuerung (--all betrifft das Gateway jedes Profils).
hermes gateway install | uninstall	Installiert oder entfernt benutzerbezogene Hintergrunddienste.
hermes gateway migrate [--dry-run]	Faltet Profil-spezifische Gateways in ein Host-Gateway. hermes update führt dies aus, es sei denn, eine Preflight-Prüfung blockiert es. Es gibt kein --standalone-Rollback.
hermes pairing list | approve | revoke | clear-pending	DM-Pairing-Genehmigungen für Messaging-Bots.
hermes whatsapp	WhatsApp-Bridge-Pairing-Flow.
hermes slack manifest	Erzeugt Slack-App-Manifest mit Gateway-Slash-Parität.

Auf WSL ist hermes gateway run innerhalb von tmux das robuste Muster, wenn gateway start unberechenbar ist. Für End-to-End-Telefon-Workflows, die dieselbe Gateway-Ebene verwenden, siehe Hermes Sprachsteuerung von Ihrem Telefon. Für den Betrieb auf einem dedizierten Server mit einem separaten Desktop-Client, folgen Sie Hermes Agent Headless Server und Remote Desktop Setup.

Cron-Planer, Webhooks und Kanban

Befehl	Beschreibung
hermes cron …	Erstellen, bearbeiten, pausieren, fortsetzen, ausführen, entfernen von geplanten Prompts (tick für manuellen Scheduler-Pass).
hermes webhook subscribe, list, remove, test	Dynamische Webhook-Routen für ereignisgesteuerte Läufe.
hermes kanban …	Multi-Profil-Aufgabenboard, unterstützt durch SQLite; dispatch steuert Workers.

Wenn Sie praktische Parallelitätsmuster für hermes kanban auf selbst gehosteten Gateways benötigen, siehe Kanban in Hermes Agent für Self Hosted LLM Workflows.

hermes doctor, Logs, Backup und Nutzungs-Einblicke

Befehl	Beschreibung
hermes doctor [--fix]	Interaktive Diagnosen und optionale automatische Reparatur.
hermes status [--all] [--deep]	Knapper Status; tiefere Prüfungen bei Bedarf.
hermes dump [--show-keys]	Klebefreundliche Setup-Zusammenfassung für Discord oder GitHub Issues.
hermes debug share	Lädt einen redigierten Debug-Bundle zu einem Paste-Dienst hoch (oder --local).
hermes logs [agent | errors | gateway | list]	Tailt und filtert Logs im Log-Verzeichnis des Profils.
hermes backup, hermes import	Zip-Snapshots von Home-Daten und Wiederherstellungspfade.
hermes insights [--days N] [--source …]	Token-, Kosten- und Aktivitätsanalysen.

Wenn etwas nach einem Upgrade kaputt geht, bilden hermes doctor, hermes status und hermes logs errors -f den schnellsten Triage-Zyklus.

MCP, ACP, Web-Dashboard und OpenClaw-Migration

Befehl	Beschreibung
hermes mcp serve	Führt Hermes als MCP-Server aus.
hermes mcp add, remove, list, test, configure	Verwaltet MCP-Client-Verbindungen von Hermes.
hermes acp	Agent Client Protocol stdio-Server für Editoren (zusätzliche Installation kann erforderlich sein).
hermes dashboard [--port …] [--host …]	Lokales Web-Dashboard (pip install hermes-agent[web]).
hermes claw migrate …	Migriert OpenClaw-artige Konfigurationen nach Hermes (--dry-run, Presets, optionale Geheimnisse).
hermes import-agent [claude-code | codex]	Importiert eine Claude Code (~/.claude) oder Codex CLI (~/.codex) Einricht. Vorschau erfolgt immer zuerst; API-Schlüssel werden nie kopiert. --sync importiert neu Quellen, deren Dateien sich geändert haben.

OpenClaw-Migration — hermes claw migrate liest veraltete OpenClaw-Home-Verzeichnisse; der vollständige gestufte Umstieg, einschließlich Dry-Run-Prüfung, Konfliktpolitik, Geheimnisverarbeitung und Kanalübergabe, ist in Wie man sicher von OpenClaw zu Hermes Agent migriert abgedeckt. Für das Aussehen dieses Stacks vor dem Umzug, siehe die OpenClaw Fallstudie.

Slash-Befehle in der Hermes CLI-Sitzung

Geben Sie / für Autocomplete ein. Befehle sind unterscheidungslos; Skills registrieren zusätzliche /skill-name-Routen. Die folgenden Tabellen sind eine kuratierte Teilmenge; für das vollständige Register siehe die Offizielle Hermes Agent Dokumentation am Ende dieses Artikels.

Sitzungsfluss, Hintergrundaufgaben und Ziele

Befehl	Beschreibung
/new, /reset	Neue Sitzungs-ID und Historie.
/resume [name]	Setzt eine benannte Sitzung fort.
/compress [focus]	Manuelle Kontext-Kompression mit optionalem Fokus-Thema.
/retry, /undo	Versucht den letzten Turn erneut oder entfernt den letzten Austausch.
/title …	Benennt die Sitzung für spätere /resume.
/background …, /queue …, /steer …	Paralleler Hintergrundlauf, nächster Prompt in der Warteschlange, Anstoß nach dem nächsten Tool mitten im Loop.
/goal …	Persistierendes mehrsturniges Ziel mit Judge-Loop (status, pause, resume, clear).
/branch, /fork	Zweigt die Unterhaltung ab für alternative Erkundung.
/btw …	Seitenfrage zur aktuellen Unterhaltung; unterbricht den Hauptturn nicht.
/context [all]	Kontext-Nutzungs-Aufschlüsselung. all fügt Kosten pro Skill und Toolset hinzu.
/status	Sitzungsinfo plus lokaler Recap (jüngste Turns, Tools, Dateien). Kein Modellaufruf.
/sessions	In-Sitzung-Wähler: Filtern, Pfeile, Enter zum Fortsetzen.

Modelle, Tool-Umschalter, Skills und Neuladen

Befehl	Beschreibung
/model … [--global]	Wechselt Modelle zwischen konfigurierten Providern; --global macht Standard persistent.
/tools …, /toolsets	Sitzungs-Tool-Umschalter und Toolset-Liste.
/skills …	Sucht, installiert und verwaltet Skills aus dem Chat.
/cron …	Geplante Aufgaben-UI aus der CLI-Sitzung.
/reload-mcp	Lädt MCP-Server aus der Konfiguration neu.
/reload	Lädt .env in die laufende Sitzung neu, ohne Neustart.

Nutzung, Hilfe und Beenden

Befehl	Beschreibung
/usage, /insights	Token- und Kosten-Sichtbarkeit; Analyse-Snapshot.
/voice on, /voice tts	CLI-Stimm Aufnahme (standardmäßig Ctrl+B) und gesprochene Wiedergabe.
/reasoning high	Erhöht den Reasoning-Aufwand für die Sitzung.
/help, /quit	Hilfe oder verlässt die CLI.

Eine Zeile, die mit ! beginnt, wird in der Host-Shell ausgeführt, ohne einen Modell-Turn (!git status). Sie tritt nicht in die Unterhaltung ein, und gefährliche Befehle treffen immer noch auf die Genehmigungsabfrage. Ctrl+S legt den Composer-Entwurf nur für die Sitzung weg; nichts wird auf der Festplatte geschrieben.

Messaging-Apps (Telegram, Discord, Slack und andere) bieten ein überlappendes Slash-Set plus /approve, /restart, /commands und verwandte gateway-spezifische Helfer — Plattformunterschiede sind in der Slash-Befehlsreferenz unter der Offiziellen Hermes Agent Dokumentation unten dokumentiert.

Weitere nützliche Lektüre

Verwandte Seiten auf dieser Website:

• KI-Systeme — Self-Hosted-Assistenten, RAG und lokale Infrastruktur — Cluster-Übersicht und wie Assistenten in den Stack passen
• KI-Systeme Speicher — Speicher-Hub und angrenzende Leitfäden

Offizielle Hermes Agent Dokumentation

Upstream-Dokumentation auf hermes-agent.nousresearch.com:

• Hermes Agent
• CLI-Befehlsreferenz
• Slash-Befehlsreferenz

---

Tipp. Halten Sie hermes dump und hermes doctor --fix im Muskelgedächtnis — sie verwandeln vage „etwas ist kaputt“-Berichte in handlungsnahe Diffs gegenüber einem bekannten guten Setup.