Hermes Agent CLI-Befehlszeile

CLI (Command Line Interface) ist die native Möglichkeit, mit Hermes Agent zu interagieren, und zugleich der funktionsvollständigste Einstiegspunkt.

Dieses Kapitel stellt systematisch die drei Betriebsmodi der CLI, die Sitzungsverwaltung, Slash-Befehle, die TUI-Oberfläche, Tastenkürzel und Techniken zur Skriptverwendung vor.

Drei Ausführungsmodi

Hermes CLI bietet drei Betriebsmodi – von einfacher Frage und Antwort über interaktive Sitzungen bis hin zur reinen Tastaturbedienung – und deckt verschiedene Anwendungsszenarien ab.

Modus 1: Interaktive Sitzung (hermes chat)

Dies ist der am häufigsten verwendete Modus – er startet eine fortlaufende Konversationssitzung mit mehreren Runden.

Starte eine interaktive Sitzung (mit dem Standardprofil):

hermes chat

Nach dem Start gelangst du in die Konversationsoberfläche, die Eingabeaufforderung ändert sich zu, und nachdem du eine Nachricht eingegeben hast, drücke Enter zum Senden; Agent beginnt zu antworten:

Sobald du dich in einer interaktiven Sitzung befindest, kannst du kontinuierlich mehrere Nachrichten senden, und der Agent merkt sich den vorherigen Gesprächskontext.

Dies ist die natürlichste Art, es bei der täglichen Entwicklung zu verwenden – genau wie das Chatten mit einem Kollegen auf Slack.

Modus 2: Einmalige Abfrage (-q / --query)

Du musst keine interaktive Sitzung starten; übergib eine Frage direkt und erhalte eine Antwort – geeignet für Skripting und schnelle Abfragen.

-qWesentliche Funktionen der Modi:

• Nicht interaktiv; der Agent beendet sich sofort nach Abschluss der Antwort.
• Gibt einen Standard-Exit-Code zurück, sodass Skripte Erfolg oder Fehler ermitteln können.
• Unterstützt Pipes und Umleitung

Modus 3: TUI-Terminalschnittstelle (hermes --tui)

TUI (Terminal-Benutzeroberfläche) bietet eine Vollbild-Terminalschnittstelle mit reiner Tastaturbedienung.

Einzigartige Vorteile des TUI-Modus:

• Die Seitenleiste kann gleichzeitig Konversation, Dateiänderungen und Tool-Aufrufverlauf anzeigen.
• Reine Tastaturbedienung, keine Maus erforderlich
• Geeignet für lang anhaltende Deep-Work-Szenarien

Vergleich der drei Modi

Sitzungsverwaltung

Eine Sitzung ist die grundlegende Einheit der Konversation in der CLI. Jede Sitzung hat ihren eigenen unabhängigen Kontext, ihre eigene Token-Anzahl und ihre eigene Sitzungs-ID.

Sitzungen fortsetzen und wiederaufnehmen

Wenn eine Sitzung fortgesetzt wird, behält der Agent den vollständigen Gesprächskontext bei, einschließlich früherer Tool-Call-Aufzeichnungen und der LLM-Reasoning-Historie.

Neue Sitzung starten

Neue Sitzungen behalten den vorherigen Gesprächskontext nicht bei, aber der persistente Speicher (MEMORY.md und USER.md) bleibt sichtbar.

Sitzungstitel-Verwaltung

Hermes generiert nach der ersten Gesprächsrunde automatisch einen Sitzungstitel; du kannst ihn auch manuell benennen:

Kontextkomprimierung

Wenn der Gesprächsverlauf zu lang wird und sich dem Limit des Kontextfensters nähert, kannst du die Komprimierung manuell auslösen:

Die automatische Komprimierung wird von Hermes ausgelöst, wenn sich der Kontext dem Limit nähert. /compress ermöglicht es dir einfach, sie vorzeitig manuell auszulösen. Beide haben dieselbe Wirkung.

Gängige Slash-Befehle

In interaktiver Sitzung und im TUI-Modus, mit/Eingaben, die mit / beginnen, werden als Slash-Befehl erkannt.

Die folgenden sind die am häufigsten verwendeten CLI-Befehle, gruppiert nach Funktion.

Sitzungssteuerung

Task-Steuerung

/undo ist ein Undo auf Gesprächsebene — es entfernt die letzte Frage-Antwort-Runde aus dem Sitzungsverlauf und setzt den Kontext von Agent auf den Zustand vor der vorherigen Antwort zurück. Dies unterscheidet sich von /retry (wobei das ursprüngliche Frage-Antwort-Paar beibehalten und Agent gebeten wird, erneut zu antworten).

Modelle und Konfiguration

Sicherheit und Genehmigung

Gedächtnis und Skills

Sonstiges

Schnellaktionen und Tipps

Tastaturkürzel

In interaktiver Sitzung können die folgenden Tastenkürzel die Betriebseffizienz verbessern:

Mehrzeilige Eingabe

Wenn Sie Nachrichten mit Zeilenumbrüchen senden müssen (z. B. Codeblöcke):

Pipes und Umleitung

-qDer Modus unterstützt nativ Standard-Unix-Pipes:

Kombiniert mit Profile-Befehlsaliasen

Jedes Profile generiert automatisch dedizierte Befehls-Aliase, kein Bedarf-pflag:

Genehmigungen und Sicherheitskontrollen

Genehmigungsmodus

Wenn in der CLI gefährliche Befehle ausgeführt werden, zeigt Hermes eine Genehmigungsaufforderung an:

Agent 请求执行: rm -rf /tmp/build/*
原因: 清理构建缓存
[approve/deny]: _

Sie können innerhalb der Sitzung in Echtzeit entscheiden, ob Sie genehmigen oder ablehnen.

Der Genehmigungsmodus wird in config.yaml konfiguriert:

YOLO-Modus

Wenn Sie sicher sind, dass das, was Agent gerade tun will, sicher ist (z. B. Vorgänge in einem Projekt, mit dem Sie vertraut sind), können Sie die Genehmigung vorübergehend überspringen:

Der YOLO-Modus wirkt sich nur auf die aktuelle Sitzung aus; neue Sitzungen stellen automatisch den in config.yaml konfigurierten Genehmigungsmodus wieder her. Dies stellt sicher, dass eine vorübergehende Lockerung nicht zu einer dauerhaften Sicherheitslücke wird.

Skriptbasierte Nutzung

Hermes in Shell-Skripten verwenden

-qDie Exit-Codes und die Standardausgabe des Modus ermöglichen es Hermes, sich nahtlos in Shell-Skripte zu integrieren:

Integration mit Git Hooks

Das Folgende ist ein Beispiel für einen Git-pre-commit-Hook—wodurch Agent den Code vor dem Commit überprüfen kann.

Geplante Ausführung

In Kombination mit dem cron des Systems oder dem integrierten Cron-System von Hermes können CLI-Aufgaben periodisch ausgeführt werden – es wird jedoch empfohlen, das integrierte Cron von Hermes zu verwenden (überhermes cron create), weil es Ergebnisse direkt an die Nachrichtenplattform liefern kann.