Hermes Headless Background

Hermes headless en background (sans daemon MCP)

Pattern réel, prouvé en session : faire tourner une session hermes sur un modèle bon marché (OpenRouter) en CLI direct, headless, en arrière-plan, quand le daemon agentproto / les tools mcp__agentproto__* ne sont PAS chargés dans la session (démarrer le daemon en cours de route ne réinjecte pas ses tools MCP). On parle au binaire hermes directement.

Pour le chemin MCP (daemon présent) voir agent-session-orchestration-agentproto et light-coder-orchestration. Le présent skill = le fallback CLI.

Quand l'utiliser

• ToolSearch "agentproto agent_start" ne ramène aucun mcp__agentproto__*.
• Tâche déléguable à un modèle pas cher (audit READ-ONLY, recherche,

classification, bulk) — pas du frontier-judgment. Voir feedback_delegate_to_cheap_agentproto.

• Tu veux continuer à bosser pendant que ça tourne → background.

Recette (end-to-end)

0. Pré-vol

which hermes            # ex: ~/.local/bin/hermes  (sinon: stop)
hermes status 2>&1 | grep -iE "openrouter|provider|model"   # provider authed ✓ ?

hermes --help : flags clés = -z PROMPT (headless one-shot), -m MODEL, --provider PROVIDER, --yolo (pas de confirmations), --resume SESSION.

1. VÉRIFIER LE MODÈLE D'ABORD (si l'utilisateur a nommé un modèle précis)

Consigne fréquente : « si tu n'arrives pas à avoir le modèle, tu STOP ». hermes model est juste un sélecteur interactif — il ne liste pas. Le seul test fiable = un probe minimal + lire la colonne model de state.db :

export PATH="$HOME/.local/bin:$PATH"
hermes -z "Reply with exactly: PONG" -m z-ai/glm-5.2 --provider openrouter --yolo 2>&1 | tail -5
sqlite3 ~/.hermes/state.db "select model, estimated_cost_usd from sessions order by rowid desc limit 1;"
# La sortie DOIT montrer model = z-ai/glm-5.2 (pas le défaut deepseek-v4-pro). Sinon → STOP.

Alias modèles courants (OpenRouter, ~$0.01-0.5/run) : z-ai/glm-5.2 (« glm-z2 » / « zlm g2 ») et deepseek/deepseek-v4-pro. hermes IGNORE le model de session ACP mais l'adapter envoie un /model → d'où la vérif via state.db.

2. Écrire le brief dans un fichier (pas inline)

Les prompts longs cassent l'escaping shell. Écris le brief dans le scratchpad, passe-le avec "$(cat …)". Pour un AUDIT, le brief DOIT contenir :

• READ-ONLY explicite (« Do NOT edit, deploy, git-write, DB-write »).
• Le contexte + tes conclusions à CHALLENGER avec preuves (file:line), pas à

gober.

• La liste des fichiers à lire + les livrables (verdict par claim, ce qui

manque, plan rangé).

3. Lancer en background

export PATH="$HOME/.local/bin:$PATH"; cd 
hermes -z "$(cat /brief.md)" -m z-ai/glm-5.2 --provider openrouter --yolo \
  > /audit-out.log 2>&1

→ outil Bash avec run_in_background: true. Tu es notifié à la fin (`). **Ne poll PAS en boucle** (ça crame TON contexte) — attends la notif, puis Read le .log`.

4. Lire le résultat + le coût

sqlite3 ~/.hermes/state.db \
  "select model, estimated_cost_usd, input_tokens, output_tokens from sessions order by rowid desc limit 1;"

Colonnes utiles de sessions : model, estimated_cost_usd, actual_cost_usd, input_tokens, output_tokens, cache_read_tokens, end_reason, tool_call_count.

5. FILET DE VÉRIFICATION (non négociable)

Un modèle léger hallucine des file:line et se trompe sur les calculs. Avant de relayer : re-vérifie toi-même chaque claim actionnable (grep/sed les file:line cités, refais l'arithmétique). Relaye en marquant CONFIRMÉ / corrigé / réfuté.

Gotchas (tous rencontrés en vrai)

• Pas de mcp__agentproto__* → inutile de lancer le daemon en cours de

session pour les récupérer ; les serveurs MCP se chargent au boot. Reste en CLI direct.

• macOS n'a pas timeout (command not found → toute la ligne

court-circuite, hermes ne tourne jamais). N'enrobe PAS avec timeout. hermes -z est one-shot et sort seul ; pour borner, utilise le timeout de l'outil Bash ou run_in_background.

• Le classifier auto-mode bloque les secrets en clair sur la ligne de

commande (clé API inline = « Credential Leakage »). Source depuis un fichier env : export X="$(grep -E '^X=' envs/…/.env | cut -d= -f2-)", jamais la valeur en dur, jamais un echo/cat qui la matérialise dans le transcript.

• state.db s'écrit ~après le turn-end — si la colonne model/coût semble

vide, relire après une courte attente.

• Le modèle par défaut hermes (~/.hermes) est deepseek-v4-pro ; si tu ne

passes pas -m, c'est lui qui tourne. Toujours expliciter -m … --provider ….

• Reprendre une session : hermes -r (id = sessions.id dans

state.db).

Pourquoi

OpenRouter pay-per-token (centimes), séparé de l'abonnement Claude — pour le grunt/audit/recherche, déléguer ici plutôt que brûler un subagent Opus/Sonnet. Réserve le Agent tool / Claude au frontier-judgment et à la passe de vérif.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: agentproto
• Source: agentproto/ts
• License: Apache-2.0
• Homepage: https://agentproto.sh

Install and usage instructions live in the source repository linked above.