Scheda di riferimento per Hermes Agent CLI — comandi, flag e scorciatoie con barra

Hermes Agent di Nous Research è un assistente basato su modelli agnostici e con supporto per strumenti, che puoi eseguire in locale o su un VPS.

Hermes non ti vincola a una singola interfaccia. Puoi utilizzare

• la classica CLI hermes / hermes chat,
• la sessione a schermo intero hermes --tui,
• un hermes gateway di lunga durata per Telegram, Discord, Slack e altre piattaforme di messaggistica,
• hermes dashboard per un’interfaccia browser locale quando è installato il modulo web extra.

Questi percorsi condividono la stessa configurazione e i dati sotto ~/.hermes; questa pagina elenca i comandi shell importanti in tutti questi modali.

Di seguito è riportato un riferimento denso ai comandi raggruppati per attività.

Installazione di Hermes Agent e comandi CLI di avvio

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

Lo script di installazione scarica il repository, configura un ambiente Python e collega l’eseguibile hermes. Dopo source ~/.bashrc o ~/.zshrc, il 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 (punto di ingresso giornaliero predefinito).
hermes --version / hermes version	Stampa le informazioni di versione.
hermes completion bash | zsh | fish	Emette script di completamento shell per il completamento con il tasto tab.
hermes update [--check] [--backup] [--restart-gateway]	Ottiene l’ultimo codice, reinstalla le dipendenze, snapshot facoltativo della home prima dell’aggiornamento o riavvio del gateway.
hermes uninstall [--full] [--yes]	Rimuove Hermes; opzionale cancellazione 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 persistente da hermes profile use).
--resume, -r	Riprende una sessione tramite ID o titolo.
--continue [name], -c	Continua l’ultima sessione, o l’ultima corrispondente a un titolo.
--worktree, -w	Avvia in un worktree Git isolato per agenti paralleli.
--yolo	Aggira i prompt di approvazione dei comandi pericolosi (usare con cautela).
--pass-session-id	Include l’ID della sessione nel prompt di sistema.
--ignore-user-config	Salta ~/.hermes/config.yaml (solo predefiniti); .env viene ancora caricato.
--ignore-rules	Salta 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 "..."	Prompt one-shot (non interattivo); mantiene un output più ricco di -z quando gli strumenti vengono eseguiti.
hermes -z "..."	One-shot scriptato — solo la risposta finale su stdout, senza banner o rumore di sessione. Stesso agente e strumenti; ideale per pipe e script.
hermes chat --quiet, -Q	Modalità programmatica più silenziosa (banner e anteprime strumenti soppressi).
-m / --model, --provider	Sovrascritture di modello e provider per esecuzione; le variabili d’ambiente HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER replicano il comportamento.
-t / --toolsets	Abilita toolset separati da virgola per l’esecuzione.
-s / --skills	Pre carica abilità (ripetibili o separate da virgola).
--image path	Allega un’immagine locale a una singola query.
--checkpoints	Abilita checkpoint del file system prima di modifiche distruttive.
--max-turns N	Limita le iterazioni di chiamata a strumenti per turno (predefinito dalla configurazione).
--source	Tag sorgente della sessione (cli vs tool per integrazioni).

Modello Hermes fuori dalla sessione vs /model all’interno — L’esecuzione di hermes model da shell è dove aggiungi provider, chiavi e OAuth. Slash /model passa solo tra i provider già configurati. Se vedi solo OpenRouter in /model, esci dalla sessione e completa hermes model.

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 facili da ruotare.
hermes fallback [list | add | remove | clear]	Gestisce i provider di fallback ordinati quando il primario dà errore o limita i tassi.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configurazione interattiva per sezione o completa (--quick, --reset, --non-interactive).

Deprecated hermes login / hermes logout — usa hermes auth e hermes model invece.

La scelta tra endpoint locali OpenAI-compatible e API hostate per hermes model comporta gli stessi compromessi del LLM hosting generale (latenza, costo, operazioni).

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

File di configurazione e comandi hermes config

La configurazione si risolve come sovrascrizioni CLI → config.yaml → .env → predefiniti. Le chiavi API appartengono a .env; le impostazioni strutturate a 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 valori (segreti instradati a .env, non segreti a YAML).
hermes config path / hermes config env-path	Stampa i percorsi ai file di configurazione e ambiente.
hermes config check	Rileva impostazioni mancanti o obsolete.
hermes config migrate	Applica interattivamente nuove opzioni introdotte.

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 delle 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, pota le vecchie, rinomina titoli, mostra statistiche del archivio.
hermes profile list | use | create | delete | show | rename	Gestisce istanze Hermes isolate su un solo computer.
hermes profile export / import	Archivia o ripristina un tarball del profilo.
hermes profile alias	Script wrapper brevi per un cambio rapido del profilo.

Usa hermes -p work chat -q "..." per esecuzioni ad hoc senza cambiare il profilo predefinito persistente.

Hub delle abilità, toolset, hook shell e plugin

Per una configurazione basata sul profilo e abilità adattate a flussi di lavoro di produzione reali per ruolo, vedi Abilità Assistente AI Hermes per Configurazioni di Produzione Reali. Per la scrittura e il debug dei file SKILL.md—metadati, disclosure progressiva e visibilità condizionale—vedi Creazione di Abilità 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	Flussi di lavoro dell’hub delle abilità inclusi registri e installazioni da URL.
hermes curator status, run, pause, pin, rollback, …	Manutenzione in background delle abilità e rollback sicuro.
hermes hooks list, test, revoke, doctor	Hook shell dichiarati e whitelist nella configurazione.
hermes plugins	Interfaccia composita o sottocomandi per installare, abilitare, disabilitare, rimuovere plugin.

Memoria integrata e provider hermes memory

La MEMORY.md / USER.md integrata resta attiva; i provider esterni aggiungono layer di richiamo opzionali. Per capire come quell’architettura si comporta in pratica, leggi Sistema di Memoria Hermes Agent — Come Funziona Realmente la Memoria AI Persistente. Per confrontare backend esterni e compromessi di attivazione, vedi Provider di Memoria per Agenti Confrontati — 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 restano.

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

Gateway di messaggistica, accoppiamento DM e piattaforme

Comando	Descrizione
hermes gateway setup	Configurazione interattiva della piattaforma di messaggistica.
hermes gateway run	Gateway in primo piano (raccomandato 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 pairing list | approve | revoke | clear-pending	Approvazioni di accoppiamento DM per bot di messaggistica.
hermes whatsapp	Flusso di accoppiamento del bridge 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 end-to-end da telefono che usano lo stesso layer di gateway, vedi Controllo Vocale Hermes dal Telefono. Per il funzionamento su server dedicato con un client desktop separato, segui Configurazione Server Headless e Desktop Remoto per Hermes Agent.

Pianificatore Cron, webhook e Kanban

Comando	Descrizione
hermes cron …	Crea, modifica, metti in pausa, riprendi, esegui, rimuovi prompt pianificati (tick per passaggio manuale del pianificatore).
hermes webhook subscribe, list, remove, test	Rotte dinamiche per webhook per esecuzioni evento-driven.
hermes kanban …	Scheda di attività multi-profilo basata su SQLite; dispatch guida i lavoratori.

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

hermes doctor, log, backup e insight sull’utilizzo

Comando	Descrizione
hermes doctor [--fix]	Diagnostiche interattive e riparazione automatica opzionale.
hermes status [--all] [--deep]	Stato conciso; controlli più approfonditi se necessario.
hermes dump [--show-keys]	Riepilogo della configurazione adatto da incollare per issue Discord o GitHub.
hermes debug share	Carica un bundle di debug censurato su un servizio di paste (o --local).
hermes logs [agent | errors | gateway | list]	Insegue e filtra i log nella directory log del profilo.
hermes backup, hermes import	Snapshot zip dei dati home e percorsi di ripristino.
hermes insights [--days N] [--source …]	Analytics di token, costi e attività.

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

MCP, ACP, dashboard web e migrazione OpenClaw

Comando	Descrizione
hermes mcp serve	Esegue 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 essere necessaria 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).

Migrazione OpenClaw — hermes claw migrate legge directory home legacy OpenClaw; il cambio completo a fasi, incluso riesame dry-run, politica dei conflitti, gestione dei segreti e passaggio dei canali, è coperto in Come Migrare da OpenClaw a Hermes Agent in Sicurezza. Per come era quello stack prima del trasferimento, vedi lo studio di caso OpenClaw.

Comandi slash nella sessione CLI Hermes

Digita / per il completamento automatico. I comandi sono insensibili alle maiuscole/minuscole; le abilità registrano route aggiuntive /skill-name. Le tabelle seguenti sono un sottoinsieme curato; per il registro completo vedi 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 sessione e cronologia.
/resume [name]	Riprendi una sessione nominata.
/compress [focus]	Compressione manuale del contesto con argomento di focus opzionale.
/retry, /undo	Riprova l’ultimo turno o rimuovi l’ultimo scambio.
/title …	Dà un nome alla sessione per un successivo /resume.
/background …, /queue …, /steer …	Esecuzione parallela in background, prompt successivo in coda, sollecitazione a metà ciclo dopo lo strumento successivo.
/goal …	Obiettivo persistente multi-turno con loop di giudice (status, pause, resume, clear).
/branch, /fork	Rami della conversazione per esplorazioni alternative.

Modelli, commutatori strumenti, abilità e ricaricamento

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

Utilizzo, aiuto ed uscita

Comando	Descrizione
/usage, /insights	Visibilità di token e costi; snapshot di analisi.
/help, /quit	Aiuto o uscita dalla CLI.

Le app di messaggistica (Telegram, Discord, Slack e altri) espongono un insieme di slash sovrapposto più /approve, /restart, /commands e helper solo-gateway correlati — le differenze tra le 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 (contesto più ampio per Hermes e agenti terminali):

• Sistemi AI — Assistenti Self-Hosted, RAG e Infrastruttura Locale — panoramica del cluster e come gli assistenti si inseriscono nello stack
• Memoria Sistemi AI — hub di memoria e guide adiacenti
• Strumenti per Sviluppatori AI — panorama di terminali e strumenti IDE
• Quickstart OpenCode — un altro agente terminal-first per confronto ergonomico

Documentazione ufficiale di Hermes Agent

Documentazione upstream su hermes-agent.nousresearch.com:

• Hermes Agent
• Riferimento comandi CLI
• Riferimento comandi slash

---

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