Ligne de commande CLI de Hermes Agent

CLI (interface en ligne de commande) est la manière la plus native d'interagir avec Hermes Agent, et aussi le point d'entrée le plus complet en termes de fonctionnalités.

Ce chapitre présente systématiquement les trois modes de fonctionnement de la CLI, la gestion des sessions, les commandes slash, l'interface TUI, les opérations de raccourci et les techniques d'utilisation de scripts.

Trois modes d'exécution

La CLI Hermes propose trois modes de fonctionnement, de la simple question-réponse aux sessions interactives jusqu'à l'utilisation purement au clavier, couvrant différents scénarios d'utilisation.

Mode 1 : Session interactive (hermes chat)

C'est le mode le plus couramment utilisé — lancer une session de conversation continue à plusieurs tours.

Démarrer une session interactive (en utilisant le Profile par défaut) :

hermes chat

Après le démarrage, vous entrez dans l'interface de conversation, l'invite change en, et après avoir saisi un message, appuyez sur Entrée pour envoyer ; l'Agent commence à répondre :

Une fois dans une session interactive, vous pouvez envoyer plusieurs messages en continu, et l'Agent se souviendra du contexte de conversation précédent.

C'est la façon la plus naturelle de l'utiliser au quotidien en développement — comme discuter avec un collègue sur Slack.

Mode 2 : Requête unique (-q / --query)

Pas besoin d'entrer dans une session interactive ; posez directement une question et obtenez une réponse, adapté aux scripts et aux requêtes rapides.

-qCaractéristiques principales des modes :

• Non interactif ; l'agent quitte immédiatement après avoir terminé la réponse.
• Renvoie un code de sortie standard, permettant aux scripts de déterminer le succès ou l'échec.
• Prend en charge les pipes et la redirection

Mode 3 : interface terminal TUI (hermes --tui)

TUI (Terminal User Interface) fournit une interface terminal plein écran avec un fonctionnement purement au clavier.

Avantages uniques du mode TUI :

• La barre latérale peut afficher simultanément la conversation, les modifications de fichiers et l'historique des appels d'outils.
• Fonctionnement entièrement au clavier, aucune souris nécessaire
• Adapté aux scénarios de travail approfondi de longue durée

Comparaison des trois modes

Gestion des sessions

Une session est l'unité de base de conversation dans la CLI. Chaque session possède son propre contexte indépendant, son nombre de tokens et son ID de session.

Continuer et reprendre des sessions

Lors de la reprise d'une session, l'Agent conserve l'intégralité du contexte de conversation, y compris les enregistrements des appels d'outils précédents et l'historique de raisonnement du LLM.

Démarrer une nouvelle session

Les nouvelles sessions ne conservent pas le contexte de conversation précédent, mais la mémoire persistante (MEMORY.md et USER.md) reste visible.

Gestion des titres de session

Hermes génère automatiquement un titre de session après le premier tour de conversation ; vous pouvez également le nommer manuellement :

Compression du contexte

Lorsque l'historique de conversation devient trop long et s'approche de la limite de la fenêtre de contexte, vous pouvez déclencher manuellement la compression :

La compression automatique est déclenchée par Hermes lorsque le contexte s'approche de la limite. /compress vous permet simplement de la déclencher manuellement à l'avance. Les deux ont le même effet.

Commandes slash courantes

En session interactive et en mode TUI, avec/Une entrée commençant par / est reconnue comme une commande slash.

Voici les commandes CLI les plus couramment utilisées, regroupées par fonction.

Contrôle de session

Contrôle des tâches

/undo est une annulation au niveau de la conversation—elle supprime le dernier tour de Q&R de l'historique de session, ramenant le contexte d'Agent à l'état précédant la réponse précédente. Cela diffère de /retry (qui conserve la Q&R d'origine et demande à Agent de répondre à nouveau).

Modèles et configuration

Sécurité et approbation

Mémoire et compétences

Autre

Actions rapides et astuces

Raccourcis clavier

En session interactive, les raccourcis suivants peuvent améliorer l'efficacité opérationnelle :

Saisie multiligne

Lorsque vous devez envoyer des messages contenant des sauts de ligne (comme des blocs de code) :

Tubes et redirection

-qLe mode prend nativement en charge les tubes Unix standard :

Combiné avec les alias de commande de Profile

Chaque Profile génère automatiquement des alias de commande dédiés, pas besoin de-pl'option :

Approbations et contrôles de sécurité

Mode d'approbation

Lors de l'exécution de commandes dangereuses dans la CLI, Hermes affiche une demande d'approbation :

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

Vous pouvez décider en temps réel dans la session d'approuver ou de rejeter.

Le mode d'approbation est configuré dans config.yaml :

Mode YOLO

Lorsque vous êtes certain que ce que l'Agent s'apprête à faire est sans danger (comme des opérations dans un projet que vous connaissez bien), vous pouvez temporairement ignorer l'approbation :

Le mode YOLO ne prend effet que dans la session en cours ; les nouvelles sessions restaurent automatiquement le mode d'approbation configuré dans config.yaml. Cela garantit qu'un assouplissement temporaire ne devient pas une vulnérabilité permanente.

Utilisation scriptée

Utilisation de Hermes dans des scripts shell

-qLes codes de sortie et la sortie standard du mode permettent à Hermes de s'intégrer parfaitement dans des scripts shell :

Intégrer avec les hooks Git

Voici un exemple de hook pre-commit Git—permettant à l'Agent de vérifier le code avant le commit.

Exécution planifiée

Combiné avec le cron du système ou le système Cron intégré de Hermes, les tâches CLI peuvent être exécutées périodiquement—mais il est recommandé d'utiliser le Cron intégré de Hermes (viahermes cron create), car il peut transmettre directement les résultats à la plateforme de messagerie.