hermes chat / -z în Hermes Agent CLI

hermes chat [opțiuni] [-q "<cerință>" [--oneshot]]   |   hermes -z "<cerință>"

Ce face hermes chat / -z

hermes chat pornește sesiunea interactivă și primește opțiuni pentru model, furnizor, toolset-uri și skill-uri. Cu -q / --query, pe un terminal real promptul devine prima tură a unei sesiuni interactive, care rămâne deschisă. Ca să răspundă și să iasă, adaugă --oneshot sau -Q; fără TTY (pipe, cron) modul one-shot este implicit. Înainte de 0.21, -q răspundea și ieșea; acum acel comportament cere --oneshot.

hermes -z este intrarea pentru scripturi: un prompt intră, iar pe stdout iese doar textul răspunsului final, fără banner, spinner sau previzualizări de unelte. Coduri de ieșire: 0 tură încheiată, 2 eșec sau oprire parțială (și erori de utilizare), 130 întrerupere, 1 tură încheiată fără niciun text. --usage-file scrie un raport JSON de consum (tokeni, cost estimat), chiar și când rularea eșuează.

--format stream-json emite câte un obiect JSON pe linie (evenimente system, text, tool_use, tool_result, result), pentru programe care urmăresc progresul. --safe-mode este un mod de depanare: dezactivează toate personalizările (config, reguli, memorie, pluginuri, hook-uri, servere MCP) și cere un --model explicit. Nu filtrează unelte periculoase.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
-q, --query "..."	Prompt inițial. Pe TTY deschide o sesiune interactivă; cu --oneshot, -Q sau fără TTY răspunde și iese.
--query-file PATH	Citește promptul dintr-un fișier (- = stdin), fără interpretare shell. Exclusiv cu -q.
--oneshot	Cu -q / --query-file: răspunde și iese.
-m, --model <model>	Modelul pentru această rulare (acceptă și aliasurile din model_aliases).
--provider <furnizor>	Forțează furnizorul: auto, openrouter, nous, openai-codex, anthropic, gemini, deepseek, xai, ollama-cloud, lmstudio, bedrock și alții; custom pentru un endpoint propriu.
-t, --toolsets <csv>	Toolset-urile activate, separate prin virgulă.
-s, --skills <nume>	Preîncarcă skill-uri (repetabil sau separate prin virgulă).
-v, --verbose	Ieșire detaliată.
-Q, --quiet	Mod programatic: fără banner, spinner și previzualizări de unelte.
--format stream-json	JSONL structurat pentru o rulare cu -q; implică --quiet, incompatibil cu --tui.
--image <cale>	Atașează o imagine locală la o singură cerere.
--resume <sesiune> / --continue [nume]	Reia o sesiune direct din chat.
--worktree	Creează un git worktree izolat pentru această rulare.
--checkpoints	Activează checkpoint-urile înaintea modificărilor distructive (pentru /rollback).
--yolo	Sare peste confirmări.
--pass-session-id	Trece ID-ul sesiunii în promptul de sistem.
--ignore-user-config / --ignore-rules	Ignoră config-ul utilizatorului / injectarea regulilor, memoriei și skill-urilor.
--safe-mode	Dezactivează toate personalizările; cere --model.
--base-url <url> / --api-key <cheie>	Endpoint compatibil OpenAI pentru --provider custom. Cheia rămâne doar în memoria gateway-ului.
--source <etichetă>	Sursa sesiunii (implicit cli; one-shot: oneshot). tool ascunde sesiunea din listele utilizatorului.
--max-turns <N>	Iterații maxime de unelte per tură (implicit 500 sau agent.max_turns).
--usage-file <cale>	Cu -z / --oneshot: raport JSON de consum după rulare.

Exemple practice

Exemplul 1: One-shot pentru scripturi

Exemplul din documentația oficială.

hermes -z "What's the capital of France?"

Rezultat

Paris.

Exemplul 2: Capturarea răspunsului într-o variabilă

answer=$(hermes -z "rezumă acest fișier" < README.md)

Exemplul 3: Răspuns și ieșire, cu model și furnizor fixate

hermes chat --oneshot -q "Rezumă ultimele PR-uri" --provider openrouter --model anthropic/claude-sonnet-4.6

Exemplul 4: Raport de consum pentru pipeline-uri

hermes -z "rezumă repo-ul" --usage-file ~/.hermes/cache/scratch/usage.json
jq .total_including_auxiliary.estimated_cost_usd ~/.hermes/cache/scratch/usage.json

Greșeli frecvente și bune practici

• Te bazezi pe -q ca să iasă după răspuns. Pe un terminal interactiv sesiunea rămâne deschisă; adaugă --oneshot.
• Judeci succesul unui hermes -z după stdout. Documentația cere să folosești codul de ieșire sau câmpurile din --usage-file.
• Aștepți ca o cerere one-shot să ruleze comenzi periculoase. Implicit sunt refuzate (approvals.single_query_mode: deny), pentru că nu e nimeni să le aprobe.

Comenzi înrudite

• hermes
• hermes-resume
• hermes-yolo
• hermes-custom-providers