Kurzübersicht der Hermes-Agent-CLI: Befehle, Flags und Slash-Shortcuts

Der Hermes Agent von Nous Research ist ein modellunabhängiger, werkzeugnutzender Assistent, den Sie lokal oder auf einem VPS betreiben.

Hermes schließt Sie nicht an eine bestimmte Oberfläche fest. Sie können Folgendes nutzen:

• die klassische hermes / hermes chat CLI,
• die Vollbild-hermes --tui-Sitzung,
• einen dauerhaft laufenden 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 die gleiche Konfiguration und Daten unter ~/.hermes; diese Seite listet die Shell-Befehle auf, die in diesen Modus relevant sind.

Nachfolgend finden Sie eine dichte Befehlsreferenz, gruppiert nach Aufgaben.

Hermes Agent installieren und Erststart-CLI-Befehle

Für Installation und Fehlerbehebung beginnen Sie mit Hermes KI-Assistent — Installation, Einrichtung, Arbeitsablauf und Fehlerbehebung.

Der Installer zieht das Repository, richtet eine Python-Umgebung ein und verdrahtet das hermes-Ausführbare. Nach source ~/.bashrc oder ~/.zshrc ist Ihr Standard-Einstiegspunkt für interaktiven Chat einfach hermes (gleiche 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	Interaktiven Chat nach der Installation starten (Standardtäglicher Einstieg).
hermes --version / hermes version	Versionsinformationen ausgeben.
hermes completion bash | zsh | fish	Shell-Vervollständigungsskripte für Tab-Vervollständigung ausgeben.
hermes update [--check] [--backup] [--restart-gateway]	Neuesten Code ziehen, Abhängigkeiten neu installieren, optionales Home-Snapshot vor Update oder Gateway-Neustart.
hermes uninstall [--full] [--yes]	Hermes entfernen; optionale vollständige Datenlöschung.

Natives Windows wird nicht unterstützt; verwenden Sie WSL2. Android-Installationen über Termux folgen einem eigenen Pfad in der Upstream-Dokumentation.

Globale Flags für jeden hermes-Aufruf

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

Flag	Beschreibung
--profile, -p	Hermes-Profil für diesen Lauf auswählen (überschreibt das klebrige Standardprofil von hermes profile use).
--resume, -r	Sitzung anhand der ID oder des Titels fortsetzen.
--continue [name], -c	Neueste Sitzung fortsetzen oder die neueste, die einem Titel entspricht.
--worktree, -w	In einem isolierten Git-Worktree für parallele Agenten starten.
--yolo	Freigabe-Abfragen für gefährliche Befehle umgehen (mit Vorsicht verwenden).
--pass-session-id	Sitzungsid im System-Prompt einbeziehen.
--ignore-user-config	~/.hermes/config.yaml überspringen (nur Standardwerte); .env wird weiterhin geladen.
--ignore-rules	Automatische Injektion von AGENTS.md, SOUL.md, .cursorrules, Speicher, vorbeladenen Skills überspringen.
--tui	TUI starten (äquivalent zu HERMES_TUI=1).
--dev	Mit --tui TS-Quellen über tsx für TUI-Entwicklung ausführen.

Isolierte Automatisierung kombiniert 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 skriptgesteuerter Chat; Hauptoberfläche für -q, -m, --provider, Toolsets, Fortsetzen, Worktree, Checkpoints.
hermes chat -q "..."	Einmal-Prompt (nicht interaktiv); erhält reichhaltigere Ausgabe als -z, wenn Tools ausgeführt werden.
hermes -z "..."	Skriptgesteuerter Einmal-Lauf — nur die finale Antwort auf stdout, ohne Banner oder Sitzungsgeräusche. Gleicher Agent und Tools; ideal für Pipes und Skripte.
hermes chat --quiet, -Q	Leiserer programmatischer Modus (Banner und Tool-Vorschau unterdrückt).
-m / --model, --provider	Laufspezifische Modell- und Anbieter-Überschreibungen; Umgebungsvariablen HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER spiegeln das Verhalten.
-t / --toolsets	Komma-getrennte Toolsets für den Lauf aktivieren.
-s / --skills	Skills vorladen (wiederholbar oder kommagetrennt).
--image path	Ein lokales Bild an eine einzelne Anfrage anhängen.
--checkpoints	Dateisystem-Checkpoints vor destruktiven Edits aktivieren.
--max-turns N	Iterationen von Tool-Aufrufen pro Zug begrenzen (Standard aus Konfiguration).
--source	Sitzungsquellen-Tag (cli im Gegensatz zu tool für Integrationen).

Hermes Modell außerhalb der Sitzung vs /model innerhalb — Das Ausführen von hermes model aus der Shell ist der Ort, an dem Sie Anbieter, Schlüssel und OAuth hinzufügen. Der Slash-Befehl /model wechselt nur zwischen bereits konfigurierten Anbietern. Wenn Sie in /model nur OpenRouter sehen, verlassen Sie die Sitzung und schließen Sie hermes model ab.

Modellauswahl, Credenciale-Pools und Fallback-Anbieter

Befehl	Beschreibung
hermes model	Interaktiver Anbieter- und Modell-Auswahl; Schlüssel, OAuth, benutzerdefinierte Endpoints.
hermes auth	Credenciale-Pools — add, list, remove, reset für rotierbare Schlüssel und OAuth.
hermes fallback [list | add | remove | clear]	Geordnete Fallback-Anbieter verwalten, wenn der primäre Fehler macht oder Rate-Limits erreicht.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Sektionsweise oder vollständige interaktive Einrichtung (--quick, --reset, --non-interactive).

Veraltet: hermes login / hermes logout — verwenden Sie stattdessen hermes auth und hermes model.

Die Wahl zwischen lokalen OpenAI-kompatiblen Endpoints und gehosteten APIs für hermes model folgt denselben Trade-offs wie allgemeine LLM-Hosting (Latenz, Kosten, Betrieb).

Sobald Ihr Standard auf Qwen oder Gemma auf etwas wie Ollama endet, sind Sampler-Standardwerte ebenso wichtig wie die eingegebene Modell-ID; aggregierte, agentenorientierte Temperatur- und Strafvoreinstellungen finden Sie in Agentic LLM-Inferenzparameter für Qwen und Gemma.

Konfigurationsdateien und hermes config-Befehle

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

Befehl	Beschreibung
hermes config show	Effektive Konfiguration anzeigen.
hermes config edit	config.yaml in $EDITOR öffnen.
hermes config set key value	Werte setzen (Geheimnisse werden nach .env, Nicht-Geheimnisse nach YAML geroutet).
hermes config path / hermes config env-path	Pfade zu Konfigurations- und Env-Dateien ausgeben.
hermes config check	Fehlende oder veraltete Einstellungen erkennen.
hermes config migrate	Neu eingeführte Optionen interaktiv anwenden.

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

Sitzungsverwaltung und hermes profile

Befehl	Beschreibung
hermes sessions list	Letzte Sitzungen auflisten.
hermes sessions browse	Interaktiver Auswahldialog mit Suche und Fortsetzen.
hermes sessions export	Sitzungen exportieren (z. B. JSONL).
hermes sessions delete, prune, rename, stats	Eine Sitzung löschen, alte zurückstutzen, Titel umbenennen, Store-Statistik anzeigen.
hermes profile list | use | create | delete | show | rename	Isolierte Hermes-Instanzen auf einer Maschine verwalten.
hermes profile export / import	Profil-Tarball archivieren oder wiederherstellen.
hermes profile alias	Kurze Wrapper-Skripte für schnelles Profil-Umschalten.

Verwenden Sie hermes -p work chat -q "..." für Ad-hoc-Läufe, ohne das klebrige Standardprofil zu ändern.

Skills-Hub, Toolsets, Shell-Hooks und Plugins

Für profil-basierte Konfiguration und Skills, die auf echte Produktions-Workflows nach Rolle zugeschnitten sind, siehe Hermes KI-Assistent Skills für echte Produktions-Setups. Für das Schreiben und Debuggen von SKILL.md-Dateien—Metadaten, progressive Offenlegung und bedingte Sichtbarkeit—siehe Hermes Agent Skill Authoring — SKILL.md-Struktur und Best Practices.

Befehl	Beschreibung
hermes tools	Interaktive Tool-Aktivierung pro Plattform; --summary druckt aktuelle Auswahl 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-Skill-Wartung und sicherer Rollback.
hermes hooks list, test, revoke, doctor	Deklarierte Shell-Hooks und Allowlists in der Konfiguration.
hermes plugins	Komposit-UI oder Unterbefehle, um Plugins zu installieren, zu aktivieren, zu deaktivieren oder zu entfernen.

Integriertes Speicher und hermes memory-Anbieter

Integrierte MEMORY.md / USER.md bleiben aktiv; externe Anbieter fügen optionale Recall-Schichten hinzu. Um zu verstehen, wie diese Architektur in der Praxis funktioniert, lesen Sie Hermes Agent Memory System — Wie persistente KI-Speicherung tatsächlich funktioniert. Zum Vergleich externer Backends und Aktivierungs-Trade-offs siehe Agent Memory Providers Compared — Honcho, Mem0, Hindsight und fünf weitere.

Befehl	Beschreibung
hermes memory setup	Interaktive Konfiguration externer Speicher-Anbieter.
hermes memory status	Aktive Anbieter-Einstellungen anzeigen.
hermes memory off	Externen Anbieter deaktivieren; integrierte Dateien bleiben erhalten.

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

Messaging-Gateway, DM-Kopplung und Plattformen

Befehl	Beschreibung
hermes gateway setup	Interaktive Messaging-Plattform-Einrichtung.
hermes gateway run	Vordergrund-Gateway (empfohlen bei WSL, Docker, Termux).
hermes gateway start | stop | restart | status	systemd / launchd Service-Steuerung (--all betrifft das Gateway jedes Profils).
hermes gateway install | uninstall	Benutzer-ebene Hintergrund-Service installieren oder entfernen.
hermes pairing list | approve | revoke | clear-pending	DM-Kopplungsgenehmigungen für Messaging-Bots.
hermes whatsapp	WhatsApp-Brücke-Kopplungsablauf.
hermes slack manifest	Slack App-Manifest mit Gateway-Slash-Parität generieren.

Auf WSL ist hermes gateway run innerhalb von tmux das robuste Muster, wenn gateway start Probleme macht. Für durchgehende Smartphone-Workflows unter Verwendung desselben Gateway-Layers siehe Hermes Sprachsteuerung von Ihrem Telefon. Für dedizierten Server-Betrieb mit einem separaten Desktop-Client folgen Sie Hermes Agent Headless Server und Remote Desktop Setup.

Cron-Scheduler, Webhooks und Kanban

Befehl	Beschreibung
hermes cron …	Geplante Prompts erstellen, bearbeiten, pausieren, fortsetzen, ausführen, entfernen (tick für manuellen Scheduler-Durchlauf).
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 Worker.

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-Insights

Befehl	Beschreibung
hermes doctor [--fix]	Interaktive Diagnostik und optionale Auto-Reparatur.
hermes status [--all] [--deep]	Knapper Status; tiefere Checks, wenn benötigt.
hermes dump [--show-keys]	Einfüge-freundliche Setup-Zusammenfassung für Discord- oder GitHub-Issues.
hermes debug share	Redigiertes Debug-Bundle zu einem Paste-Dienst hochladen (oder --local).
hermes logs [agent | errors | gateway | list]	Protokolle unter dem Log-Verzeichnis des Profils tailen und filtern.
hermes backup, hermes import	Zip-Snapshots von Home-Daten und Wiederherstellungspfade.
hermes insights [--days N] [--source …]	Token-, Kosten- und Aktivitäts-Analysen.

Wenn etwas nach einem Upgrade kaputt geht, bilden hermes doctor, hermes status und hermes logs errors -f die schnellste Triage-Schleife.

MCP, ACP, Web-Dashboard und OpenClaw-Migration

Befehl	Beschreibung
hermes mcp serve	Hermes als MCP-Server ausführen.
hermes mcp add, remove, list, test, configure	MCP-Client-Verbindungen von Hermes aus verwalten.
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 …	OpenClaw-Stil-Konfigurationen in Hermes migrieren (--dry-run, Presets, optionale Geheimnisse).

OpenClaw-Migration — hermes claw migrate liest legacy OpenClaw-Home-Verzeichnisse; der vollständige stufenweise Cutover, einschließlich Dry-Run-Review, Konflikt-Politik, Geheimnis-Handling und Kanal-Übergabe, ist abgedeckt in Wie man sicher von OpenClaw zu Hermes Agent migriert. Für das Aussehen dieses Stacks vor dem Umzug, siehe die OpenClaw Fallstudie.

Slash-Befehle in der Hermes CLI-Sitzung

Tippen Sie / für Auto-Vervollständigung. Befehle sind case-insensitive; Skills registrieren zusätzliche /skill-name-Routen. Die nachfolgenden Tabellen sind ein kuratierter Ausschnitt; für das vollständige Register siehe Offizielle Hermes Agent Dokumentation am Ende dieses Artikels.

Sitzungsfluss, Hintergrundaufgaben und Ziele

Befehl	Beschreibung
/new, /reset	Neue Sitzungs-ID und Historie.
/resume [name]	Benannte Sitzung fortsetzen.
/compress [focus]	Manuelle Kontext-Kompression mit optionalem Fokus-Thema.
/retry, /undo	Letzten Zug wiederholen oder letzten Austausch verwerfen.
/title …	Sitzung benennen für späteres /resume.
/background …, /queue …, /steer …	Parallel Hintergrundlauf, nächster Prompt in Warteschlange, Nudge im Mittelkreis nach nächstem Tool.
/goal …	Persistentes Multi-Turn-Ziel mit Judge-Loop (status, pause, resume, clear).
/branch, /fork	Konversation verzweigen für alternative Erkundung.

Modelle, Tool-Toggles, Skills und Neuladen

Befehl	Beschreibung
/model … [--global]	Modelle zwischen konfigurierten Anbietern wechseln; --global persistiert Standard.
/tools …, /toolsets	Sitzungs-Tool-Toggles und Toolset-Liste.
/skills …	Skills aus dem Chat durchsuchen, installieren und verwalten.
/cron …	Geplante Aufgaben-UI aus der CLI-Sitzung.
/reload-mcp	MCP-Server aus Konfiguration neu laden.
/reload	.env in die laufende Sitzung neu laden, ohne Neustart.

Nutzung, Hilfe und Beenden

Befehl	Beschreibung
/usage, /insights	Token- und Kosten-Sichtbarkeit; Analytik-Snapshot.
/help, /quit	Hilfe anzeigen oder CLI beenden.

Messaging-Apps (Telegram, Discord, Slack und andere) stellen eine überlappende Slash-Menge plus /approve, /restart, /commands und verwandte nur-Gateway-Helfer bereit — Plattform-Unterschiede sind in der Slash-Befehl-Referenz unter Offizielle Hermes Agent Dokumentation unten dokumentiert.

Weitere nützliche Lektüre

Verwandte Seiten auf dieser Website (breiterer Kontext für Hermes und Terminal-Agenten):

• KI-Systeme — Selbst gehostete Assistenten, RAG und lokale Infrastruktur — Cluster-Übersicht und wie Assistenten in den Stack passen
• KI-Systeme Speicher — Speicher-Hub und angrenzende Guides
• KI-Entwickler-Tools — Terminal- und IDE-Tooling-Landschaft
• OpenCode Quickstart — ein weiterer terminal-first Agent zum ergonomischen Vergleich

Offizielle Hermes Agent Dokumentation

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

• Hermes Agent
• CLI-Befehlsreferenz
• Slash-Befehlsreferenz

---

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