Scheda di riferimento CLI di Hermes Agent — comandi, flag e scorciatoie slash

Comandi shell e TUI per l'agente Hermes auto-ospitato.

Indice

L’agente Hermes di Nous Research è un assistente che utilizza strumenti, agnostico rispetto al modello, che puoi eseguire localmente o su un VPS, dalla shell, da un’interfaccia TUI a schermo intero o da un gateway di messaggistica.

Hermes non ti vincola a un’unica interfaccia. Puoi utilizzare:

  • la classica CLI hermes / hermes chat,
  • la sessione a schermo intero hermes --tui,
  • un gateway hermes gateway in esecuzione persistente per Telegram, Discord, Slack e altre piattaforme di messaggistica,
  • hermes dashboard per un’interfaccia UI nel browser locale quando è installato l’extra web.

Questi percorsi condividono la stessa configurazione e dati sotto ~/.hermes; questa pagina elenca i comandi shell rilevanti tra questi modi di utilizzo.

Scheda rapida CLI Hermes Agent — riferimento terminale

Di seguito è riportato un riferimento comandi denso raggruppato per attività, verificato rispetto al riferimento ufficiale dei comandi CLI il 6 ottobre 2026. L’ultimo tag stabile in quella data è v0.21.5 (v2026.9.24).

Installazione di Hermes Agent e comandi CLI del primo avvio

Per l’installazione e la risoluzione dei problemi, inizia con Assistente Hermes AI — Installazione, Configurazione, Flusso di Lavoro e Risoluzione dei Problemi.

L’installer scarica il repository, configura un ambiente Python e collega l’eseguibile hermes. Dopo source ~/.bashrc o ~/.zshrc, il tuo punto di ingresso predefinito per la chat interattiva è semplicemente hermes (stessa famiglia di hermes chat).

Comando Descrizione
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Installazione ufficiale in una riga (Linux, macOS, WSL2).
hermes / hermes chat Avvia la chat interattiva dopo l’installazione (ingresso quotidiano predefinito).
hermes --version / hermes version Stampa le informazioni sulla versione.
hermes completion bash | zsh | fish Emette script di completamento della shell per il completamento con il tasto Tab.
hermes update [--check] [--backup] [--restart-gateway] Recupera l’ultimo codice, reinstalla le dipendenze, opzionale snapshot della home prima dell’aggiornamento o riavvio del gateway.
hermes uninstall [--full] [--yes] Rimuove Hermes; opzionale eliminazione completa dei dati.

Windows nativo non è supportato; usa WSL2. Le installazioni su Android tramite Termux seguono un percorso dedicato nella documentazione upstream.

Flag globali per ogni invocazione di hermes

Questi flag si applicano prima dei sottocomandi e modificano quale profilo, quale sessione o quanta configurazione personale viene caricata.

Flag Descrizione
--profile, -p Seleziona il profilo Hermes per questa esecuzione (sovrascrive il predefinito fisso da hermes profile use).
--resume, -r Riprendi una sessione per ID o titolo.
--continue [name], -c Continua l’ultima sessione, o l’ultima che corrisponde a un titolo.
--worktree, -w Avvia in un worktree Git isolato per agenti paralleli.
--yolo Evita i prompt di approvazione per i comandi pericolosi (usare con cautela).
--pass-session-id Includi l’ID della sessione nel prompt di sistema.
--ignore-user-config Ignora ~/.hermes/config.yaml (solo predefiniti); .env viene ancora caricato.
--ignore-rules Ignora l’iniezione automatica di AGENTS.md, SOUL.md, .cursorrules, memoria, abilità precaricate.
--tui Avvia la TUI (equivalente a HERMES_TUI=1).
--dev Con --tui, esegue le sorgenti TS tramite tsx per lo sviluppo della TUI.

L’automazione isolata spesso accoppia hermes chat --ignore-user-config --ignore-rules con hermes -z per one-shot riproducibili.

hermes chat, prompt one-shot e hermes -z

Comando / pattern Descrizione
hermes chat Chat interattiva o scriptata; superficie principale per -q, -m, --provider, toolset, ripresa, worktree, checkpoint.
hermes chat -q "..." Su un TTY, invia il prompt come primo turno e resta nella sessione. Prima di 0.21 usciva dopo una sola risposta.
hermes chat --oneshot -q "..." Risponde ed esce (il vecchio comportamento di -q). Implicato da -Q e da stdio non-TTY. Usa questo quando hai bisogno dell’output degli strumenti nella trascrizione.
hermes chat --query-file PATH Legge il prompt da un file, o - per lo stdin. Niente viene interpretato dalla shell. Mutuamente esclusivo con -q.
hermes -z "..." One-shot scriptato — solo la risposta finale su stdout, nessun banner o rumore di sessione. Stesso agente e strumenti; ideale per pipe e script.
hermes -z "…" --usage-file PATH Dopo l’esecuzione di -z, scrive un report JSON di utilizzo (token, costo, completed / failed / partial) anche quando l’esecuzione fallisce.
hermes chat -q "…" --format stream-json Eventi JSONL su stdout (system, text, tool_use, tool_result, result). Implica la modalità silenziosa; rifiuta --tui.
hermes chat --quiet, -Q Modalità programmatica più silenziosa (banner e anteprime degli strumenti soppressi). Implica anche oneshot quando combinato con -q.
-m / --model, --provider Sovrascritture di modello e provider per esecuzione; le variabili d’ambiente HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER riflettono il comportamento.
-t / --toolsets Abilita toolset separati da virgola per l’esecuzione.
-s / --skills Preload di abilità (ripetibile o separate da virgola).
--image path Allega un’immagine locale a una singola query.
--checkpoints Abilita i checkpoint del filesystem prima di modifiche distruttive.
--max-turns N Limite alle iterazioni di chiamata agli strumenti per turno (predefinito 500, o agent.max_turns nella configurazione).
--safe-mode Disabilita configurazione utente, regole, memoria, plugin, hook shell e MCP. Implica --ignore-user-config e --ignore-rules.
--source Tag sorgente della sessione (cli vs tool per integrazioni). Le esecuzioni one-shot hanno come predefinito oneshot.

Modello Hermes fuori dalla sessione vs /model all’interno — Esecuzione di hermes model dalla shell è il punto in cui si aggiungono provider, chiavi e OAuth. Slash /model cambia solo tra i provider già configurati. Se vedi solo OpenRouter in /model, esci dalla sessione e completa hermes model.

Codici di uscita. Un’esecuzione di chat --oneshot / -Q esce con 0 quando il turno è completato, 1 quando è fallito, è stato interrotto a metà, ha raggiunto il budget di iterazioni o non è mai iniziato, e 130 in caso di interruzione. hermes -z usa una mappa diversa: 0 completato, 2 fallito o parziale (anche se ha stampato una spiegazione), 1 quando un turno completato non ha prodotto testo, 130 in caso di interruzione. Giudica una pipeline dal codice, non dal fatto che stdout sia vuoto.

Selettore di modelli, pool di credenziali e provider di fallback

Comando Descrizione
hermes model Selettore interattivo di provider e modello; chiavi, OAuth, endpoint personalizzati.
hermes auth Pool di credenziali — add, list, remove, reset per chiavi e OAuth favorevoli alla rotazione.
hermes fallback [list | add | remove | clear] Gestisce i provider di fallback ordinati quando il primario genera errori o limiti di velocità.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Configurazione interattiva sezionale o completa (--quick, --reset, --non-interactive).
hermes setup --portal Login one-shot al Nous Portal: OAuth, impostazione di Nous come provider di inferenza, opzione per il Tool Gateway.
hermes portal [status | open | tools] Stato di autenticazione del Portal e routing del Tool Gateway. Senza sottocomando esegue status.

hermes login è stato rimosso. Usa hermes auth per OAuth e pool di credenziali, hermes model per scegliere un provider, o hermes setup per la procedura guidata completa. hermes auth logout <provider> cancella un login salvato.

La scelta tra endpoint locali compatibili con OpenAI e API hostate per hermes model comporta gli stessi compromessi del hosting di LLM generale (latenza, costi, ops).

Una volta che il tuo predefinito termina con Qwen o Gemma su qualcosa come Ollama, i valori predefiniti del sampler contano quanto l’ID del modello digitato; aggrega i preset di temperatura e penalità orientati agli agenti per l’inferenza in Parametri di inferenza LLM Agentic per Qwen e Gemma.

File di configurazione e comandi hermes config

La configurazione si risolve come sovrascritture CLI → config.yaml → .env → predefiniti. Le chiavi API appartengono a .env; le impostazioni strutturate in config.yaml.

Comando Descrizione
hermes config show Mostra la configurazione effettiva.
hermes config edit Apre config.yaml in $EDITOR.
hermes config set key value Imposta i valori (i segreti vengono instradati a .env, i non-segreti a YAML).
hermes config path / hermes config env-path Stampa i percorsi dei file di configurazione e env.
hermes config check Rileva impostazioni mancanti o obsolete.
hermes config migrate Applica interattivamente le opzioni introdotte di recente.

Dove si trovano i file — Tutto si trova sotto HERMES_HOME (predefinito ~/.hermes) per configurazione, segreti, memorie, abilità, sessioni, stato del gateway e log.

Gestione sessioni e hermes profile

Comando Descrizione
hermes sessions list Elenca le sessioni recenti.
hermes sessions browse Selettore interattivo con ricerca e ripresa.
hermes sessions export Esporta sessioni (es. JSONL).
hermes sessions delete, prune, rename, stats Elimina una sessione, ripulisci quelle vecchie, rinomina i titoli, mostra le statistiche dello store.
hermes profile list | use | create | delete | show | rename Gestisce istanze Hermes isolate su un solo computer.
hermes profile export / import Archivia o ripristina un archivio tarball del profilo.
hermes profile alias Script wrapper brevi per un cambio rapido di profilo.
hermes worktree list Audit dei worktree scratch: età, dimensione e se ciascuno è sicuro da rimuovere. --json per script.
hermes worktree prune Rimuove gli alberi scratch puliti e uniti. --dry-run stampa il piano; --older-than N restringe solo la pulizia. Gli alberi con lavoro non commitato o commit unici vengono mantenuti.

Usa hermes -p work chat -q "..." per esecuzioni ad hoc senza modificare il profilo predefinito fisso. Su un TTY resta nella sessione; aggiungi --oneshot quando l’esecuzione del profilo deve uscire.

Hub abilità, toolset, hook shell e plugin

Per la configurazione basata su profili e abilità tarate su reali flussi di lavoro di produzione per ruolo, consulta Abilità Hermes AI Assistant per Settaggi di Produzione Reali. Per la scrittura e il debug dei file SKILL.md — metadati, divulgazione progressiva e visibilità condizionale — consulta Creazione di Abilità per Hermes Agent — Struttura e Best Practice di SKILL.md.

Comando Descrizione
hermes tools Abilitazione interattiva degli strumenti per piattaforma; --summary stampa le scelte correnti.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Workflow dell’hub abilità incluse le registrazioni e le installazioni da URL.
hermes curator status, run, pause, pin, rollback, … Manutenzione delle abilità in background e rollback sicuro.
hermes hooks list, test, revoke, doctor Hook shell dichiarati e liste di approvazione nella configurazione.
hermes plugins Interfaccia UI composita o sottocomandi per installare, abilitare, disabilitare e rimuovere i plugin.

Memoria integrata e provider hermes memory

Le memorie integrate MEMORY.md / USER.md rimangono attive; i provider esterni aggiungono layer di richiamo facoltativi. Per capire come funziona in pratica quell’architettura, leggi [Sistema di Memoria di Hermes Agent — Come Funziona Realmente la Memoria AI Persistente](https://www.glukhov.org/it/ai-systems/hermes/hermes-agent-memory-system/ “Una guida tecnica approfondita all’architettura di memoria di Hermes Agent — dalla memoria core a 2 file limitata a 8 provider esterni plug-in.”}. Per confrontare i backend esterni e i compromessi di attivazione, consulta Confronto dei Provider di Memoria degli Agenti — Honcho, Mem0, Hindsight e altri cinque.

Comando Descrizione
hermes memory setup Configurazione interattiva del provider di memoria esterno.
hermes memory status Mostra le impostazioni del provider attivo.
hermes memory off Disattiva il provider esterno; i file integrati rimangono.

Quando un provider è attivo può registrare ulteriori sottocomandi top-level specifici del provider — esegui hermes --help per vedere cosa è collegato oggi.

Gateway di messaggistica, abbinamento DM e piattaforme

Comando Descrizione
hermes gateway setup Configurazione interattiva della piattaforma di messaggistica.
hermes gateway run Gateway in primo piano (consigliato su WSL, Docker, Termux).
hermes gateway start | stop | restart | status Controllo del servizio systemd / launchd (--all influisce sul gateway di ogni profilo).
hermes gateway install | uninstall Installa o rimuove il servizio di background a livello utente.
hermes gateway migrate [--dry-run] Raccoglie i gateway per profilo in un unico gateway host. hermes update esegue questo a meno che un preflight non lo blocchi. Non c’è un rollback --standalone.
hermes pairing list | approve | revoke | clear-pending Approvazioni di abbinamento DM per i bot di messaggistica.
hermes whatsapp Flusso di abbinamento del ponte WhatsApp.
hermes slack manifest Genera il manifest dell’app Slack con parità di slash del gateway.

Su WSL, hermes gateway run dentro tmux è il pattern resiliente quando gateway start si comporta male. Per flussi di lavoro telefonici end-to-end che utilizzano quello stesso layer di gateway, consulta Controllo Vocale di Hermes dal Tuo Telefono. Per l’operazione su server dedicati con un client desktop separato, segui Setup di Server Headless e Desktop Remoto per Hermes Agent.

Planner Cron, webhooks e Kanban

Comando Descrizione
hermes cron … Crea, modifica, mette in pausa, riprende, esegue e rimuove prompt pianificati (tick per passaggio manuale del pianificatore).
hermes webhook subscribe, list, remove, test Route webhook dinamiche per esecuzioni guidate da eventi.
hermes kanban … Board di task multi-profilo basata su SQLite; dispatch guida i lavoratori.

Se hai bisogno di pattern di concorrenza pratici per hermes kanban su gateway self-hosted, consulta Kanban in Hermes Agent per Workflow LLM Self-Hosted.

hermes doctor, log, backup e insight sull’utilizzo

Comando Descrizione
hermes doctor [--fix] Diagnostica interattiva e riparazione automatica opzionale.
hermes status [--all] [--deep] Stato conciso; controlli più approfonditi quando necessario.
hermes dump [--show-keys] Riepilogo della configurazione amichevole al copia-incolla per issue Discord o GitHub.
hermes debug share Carica un bundle di debug ridimensionato su un servizio di paste (o --local).
hermes logs [agent | errors | gateway | list] Tail e filtri log sotto la directory di log del profilo.
hermes backup, hermes import Snapshot zip dei dati home e percorsi di ripristino.
hermes insights [--days N] [--source …] Analisi di token, costi e attività.

Quando qualcosa si rompe dopo un upgrade, hermes doctor, hermes status e hermes logs errors -f formano il loop di triage più rapido.

MCP, ACP, dashboard web e migrazione da OpenClaw

Comando Descrizione
hermes mcp serve Esegui Hermes come server MCP.
hermes mcp add, remove, list, test, configure Gestisce le connessioni client MCP da Hermes.
hermes acp Server stdio Agent Client Protocol per editor (potrebbe applicarsi un’installazione extra).
hermes dashboard [--port …] [--host …] Dashboard web locale (pip install hermes-agent[web]).
hermes claw migrate … Migra configurazioni in stile OpenClaw in Hermes (--dry-run, preset, segreti opzionali).
hermes import-agent [claude-code | codex] Importa una configurazione Claude Code (~/.claude) o Codex CLI (~/.codex). Anteprima sempre prima; le chiavi API non vengono mai copiate. --sync riimporta le sorgenti i cui file sono cambiati.

Migrazione da OpenClaw — hermes claw migrate legge directory home legacy OpenClaw; il cutover completo a fasi, inclusa la revisione dry-run, la policy dei conflitti, la gestione dei segreti e il passaggio dei canali, è trattato in Come Migrare da OpenClaw a Hermes Agent in Modo Sicuro. Per come si presentava quell’infrastruttura prima del trasferimento, consulta lo studio di caso OpenClaw.

Comandi slash nella sessione CLI di Hermes

Digita / per l’autocompletamento. I comandi sono insensibili al maiuscolo/minuscolo; le abilità registrano route extra /skill-name. Le tabelle qui sotto sono un sottoinsieme curato; per la registrazione completa consulta la Documentazione ufficiale di Hermes Agent alla fine di questo articolo.

Flusso di sessione, task in background e obiettivi

Comando Descrizione
/new, /reset Nuovo ID di sessione e storia.
/resume [name] Riprendi una sessione denominata.
/compress [focus] Compressione manuale del contesto con argomento di focus opzionale.
/retry, /undo Riprova l’ultimo turno o elimina l’ultimo scambio.
/title … Dà un nome alla sessione per il successivo /resume.
/background …, /queue …, /steer … Esecuzione parallela in background, prompt successivo in coda, spinta a metà loop dopo lo strumento successivo.
/goal … Obiettivo persistente multi-turno con loop di giudizio (status, pause, resume, clear).
/branch, /fork Ramifica la conversazione per esplorazioni alternative.
/btw … Domanda laterale sulla conversazione corrente; non interrompe il turno principale.
/context [all] Ripartizione dell’utilizzo del contesto. all aggiunge costi per abilità e per toolset.
/status Informazioni sulla sessione più un riassunto locale (turni recenti, strumenti, file). Nessuna chiamata al modello.
/sessions Selettore nella sessione: filtro, frecce, Invio per riprendere.

Modelli, interruttori strumenti, abilità e ricarica

Comando Descrizione
/model … [--global] Cambia modelli tra i provider configurati; --global persiste il predefinito.
/tools …, /toolsets Interruttori degli strumenti della sessione e elenco dei toolset.
/skills … Cerca, installa e gestisce abilità dalla chat.
/cron … Interfaccia UI dei task pianificati dalla sessione CLI.
/reload-mcp Ricarica i server MCP dalla configurazione.
/reload Ricarica .env nella sessione in esecuzione senza riavvio.

Utilizzo, aiuto e uscita

Comando Descrizione
/usage, /insights Visibilità di token e costi; snapshot analitico.
/voice on, /voice tts Registrazione vocale CLI (di default Ctrl+B) e riproduzione parlata.
/reasoning high Alza lo sforzo di ragionamento per la sessione.
/help, /quit Aiuto o uscita dalla CLI.

Una riga che inizia con ! viene eseguita nella shell host senza un turno del modello (!git status). Non entra nella conversazione, e i comandi pericolosi incontrano comunque il prompt di approvazione. Ctrl+S mette da parte la bozza del compositore solo per la sessione; nulla viene scritto su disco.

Le app di messaggistica (Telegram, Discord, Slack e altre) espongono un set di slash sovrapposto più /approve, /restart, /commands e helper correlati solo per il gateway — le differenze tra piattaforme sono documentate nel riferimento dei comandi slash sotto la Documentazione ufficiale di Hermes Agent qui sotto.

Ulteriori letture utili

Pagine correlate su questo sito:

Documentazione ufficiale di Hermes Agent

Documentazione upstream su hermes-agent.nousresearch.com:

Suggerimento. Tieni hermes dump e hermes doctor --fix nella memoria muscolare — trasformano i vaghi rapporti di “qualcosa si è rotto” in diff azionabili rispetto a una configurazione nota e funzionante.

Iscriviti

Ricevi nuovi articoli su sistemi, infrastruttura e ingegneria AI.