Guida rapida alla CLI di Hermes Agent: comandi, flag e scorciatoie con slash

Hermes Agent di Nous Research è un assistente agnostico rispetto al modello e basato su strumenti, che puoi eseguire localmente o su un VPS.

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

• il classico CLI hermes / hermes chat,
• la sessione a schermo intero hermes --tui,
• un hermes gateway in esecuzione continua per Telegram, Discord, Slack e altre piattaforme di messaggistica,
• hermes dashboard per un’interfaccia utente nel browser locale quando è installata l’estensione web.

Questi percorsi condividono la stessa configurazione e i dati sotto ~/.hermes; questa pagina elenca i comandi shell rilevanti per tutte queste modalità.

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

Installazione di Hermes Agent e comandi CLI di prima esecuzione

Per l’installazione e la risoluzione dei problemi, inizia con Hermes AI Assistant — 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 aver eseguito 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 un’unica riga (Linux, macOS, WSL2).
hermes / hermes chat	Avvia la chat interattiva dopo l’installazione (ingresso giornaliero predefinito).
hermes --version / hermes version	Visualizza le informazioni sulla versione.
hermes completion bash | zsh | fish	Genera script di completamento shell per il completamento tramite tab.
hermes update [--check] [--backup] [--restart-gateway]	Scarica l’ultima versione del codice, reinstalla le dipendenze; opzionale snapshot della home pre-aggiornamento o riavvio del gateway.
hermes uninstall [--full] [--yes]	Rimuove Hermes; opzionale cancellazione completa dei dati.

Windows nativo non è supportato; utilizza 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 sotto-comandi 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 valore predefinito fisso da hermes profile use).
--resume, -r	Riprende 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	Ignora le richieste di approvazione per comandi pericolosi (usare con cautela).
--pass-session-id	Includi l’ID della sessione nel prompt di sistema.
--ignore-user-config	Ignora ~/.hermes/config.yaml (usa solo i valori predefiniti); .env viene comunque caricato.
--ignore-rules	Ignora l’iniezione automatica di AGENTS.md, SOUL.md, .cursorrules, memoria e competenze precaricate.
--tui	Avvia l’interfaccia TUI (equivalente a HERMES_TUI=1).
--dev	Con --tui, esegue le sorgenti TS tramite tsx per lo sviluppo della TUI.

L’automazione isolata spesso abbina hermes chat --ignore-user-config --ignore-rules con hermes -z per operazioni una-tantum riproducibili.

hermes chat, prompt one-shot e hermes -z

Comando / pattern	Descrizione
hermes chat	Chat interattiva o scriptata; interfaccia principale per -q, -m, --provider, set di strumenti, ripresa, worktree e checkpoint.
hermes chat -q "..."	Prompt one-shot (non interattivo); mantiene un output più ricco rispetto a -z quando vengono eseguiti strumenti.
hermes -z "..."	One-shot scriptato — solo la risposta finale su stdout, senza banner o rumore della sessione. Stesso agente e strumenti; ideale per pipe e script.
hermes chat --quiet, -Q	Modalità programmatica più silenziosa (banner e anteprime degli strumenti soppressi).
-m / --model, --provider	Sovrascritture del modello e del provider per l’esecuzione; le variabili d’ambiente HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER replicano questo comportamento.
-t / --toolsets	Abilita set di strumenti separati da virgola per l’esecuzione.
-s / --skills	Precarica competenze (ripetibili o separate da virgola).
--image path	Allega un’immagine locale a una singola query.
--checkpoints	Abilita i checkpoint nel filesystem prima di modifiche distruttive.
--max-turns N	Limita le iterazioni di chiamata agli strumenti per turno (predefinito dalla configurazione).
--source	Tag della sorgente della sessione (cli vs tool per le integrazioni).

Modello Hermes fuori dalla sessione vs /model al suo interno — Eseguire hermes model dalla shell è il punto in cui si aggiungono provider, chiavi e OAuth. Il comando 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 modelli; 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]	Gestisci i provider di fallback ordinati quando il provider primario genera errori o limiti di velocità.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configurazione interattiva sezionata o completa (--quick, --reset, --non-interactive).

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

La scelta tra endpoint locali compatibili con OpenAI rispetto ad API ospitate per hermes model si basa sugli stessi compromessi generali dell’hosting LLM (latenza, costi, operazioni).

File di configurazione e comandi hermes config

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

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

Dove risiedono i file — Tutto si trova sotto HERMES_HOME (predefinito ~/.hermes) per configurazione, segreti, memorie, competenze, 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 le sessioni (es. JSONL).
hermes sessions delete, prune, rename, stats	Elimina una sessione, rimuovi quelle vecchie, rinomina i titoli, mostra le statistiche dell’archivio.
hermes profile list | use | create | delete | show | rename	Gestisci istanze Hermes isolate su una singola macchina.
hermes profile export / import	Archivia o ripristina un archivio tar del profilo.
hermes profile alias	Script wrapper brevi per un rapido cambio di profilo.

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

Hub delle competenze, set di strumenti, hook shell e plugin

Per la configurazione basata sul profilo e le competenze ottimizzate per flussi di lavoro di produzione reali per ruolo, consulta Hermes AI Assistant Skills for Real Production Setups.

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

Memoria integrata e provider hermes memory

I file integrati MEMORY.md / USER.md rimangono attivi; i provider esterni aggiungono livelli di richiamo opzionali. Per capire come si comporta questa architettura nella pratica, leggi Hermes Agent Memory System — How Persistent AI Memory Actually Works. Per confrontare i backend esterni e i compromessi di attivazione, vedi Agent Memory Providers Compared — Honcho, Mem0, Hindsight, and Five More.

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

Quando un provider è attivo, può registrare sotto-comandi di livello superiore 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 (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 di utente.
hermes pairing list | approve | revoke | clear-pending	Approvazioni di accoppiamento DM per bot di messaggistica.
hermes whatsapp	Flusso di accoppiamento del ponte WhatsApp.
hermes slack manifest	Genera il manifesto dell’app Slack con parità di slash del gateway.

Su WSL, hermes gateway run all’interno di tmux è il pattern resiliente quando gateway start si comporta in modo anomalo.

Programmatore Cron, webhook e Kanban

Comando	Descrizione
hermes cron …	Crea, modifica, metti in pausa, riprendi, esegui, rimuovi prompt pianificati (tick per il passaggio manuale del programmatore).
hermes webhook subscribe, list, remove, test	Route webhook dinamiche per esecuzioni guidate dagli eventi.
hermes kanban …	Board di task multi-profilo supportata da SQLite; dispatch guida i worker.

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 pronto per il copia-incolla per problemi su Discord o GitHub.
hermes debug share	Carica il pacchetto di debug anonimizzato su un servizio di paste (o --local).
hermes logs [agent | errors | gateway | list]	Tail e filtri dei log nella directory dei log del profilo.
hermes backup, hermes import	Snapshot zip dei dati della home e percorsi di ripristino.
hermes insights [--days N] [--source …]	Analisi di token, costi e attività.

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

MCP, ACP, dashboard web e migrazione OpenClaw

Comando	Descrizione
hermes mcp serve	Esegui Hermes come server MCP.
hermes mcp add, remove, list, test, configure	Gestisci le connessioni client MCP da Hermes.
hermes acp	Server stdio del protocollo Agent Client Protocol per editor (potrebbe essere richiesta un’installazione aggiuntiva).
hermes dashboard [--port …] [--host …]	Dashboard web locale (pip install hermes-agent[web]).
hermes claw migrate …	Migra le configurazioni stile OpenClaw in Hermes (--dry-run, preset, segreti opzionali).

Migrazione OpenClaw — hermes claw migrate legge le directory home legacy di OpenClaw; per vedere com’era quel stack prima del passaggio, consulta lo studio sul caso OpenClaw.

Comandi slash nella sessione CLI di Hermes

Digita / per il completamento automatico. I comandi sono case-insensitive; le competenze registrano route aggiuntive /nome-competenza. Le tabelle seguenti sono un sottoinsieme curato; per il registro completo vedi la Documentazione ufficiale di Hermes Agent alla fine di questo articolo.

Flusso della 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 futuro /resume.
/background …, /queue …, /steer …	Esecuzione parallela in background, prompt successivo in coda, impulso a metà ciclo dopo il prossimo strumento.
/goal …	Obiettivo persistente multi-turno con ciclo di giudizio (status, pause, resume, clear).
/branch, /fork	Ramifica la conversazione per esplorazioni alternative.

Modelli, toggle degli strumenti, competenze e ricarica

Comando	Descrizione
/model … [--global]	Passa tra i modelli tra i provider configurati; --global persiste il valore predefinito.
/tools …, /toolsets	Toggle degli strumenti della sessione e elenco dei set di strumenti.
/skills …	Cerca, installa e gestisci competenze dalla chat.
/cron …	Interfaccia UI per le attività pianificate 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.
/help, /quit	Aiuto o esci dal CLI.

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

Letture utili aggiuntive

Pagine correlate su questo sito (contesto più ampio per Hermes e agenti terminali):

• AI Systems — Self-Hosted Assistants, RAG, and Local Infrastructure — panoramica del cluster e come gli assistenti si integrano nello stack
• AI Systems Memory — hub della memoria e guide correlate
• AI Developer Tools — panorama degli strumenti per terminali e IDE
• OpenCode Quickstart — un altro agente basato su terminale per un confronto ergonomico

Documentazione ufficiale di Hermes Agent

Documentazione upstream su hermes-agent.nousresearch.com:

• Hermes Agent
• Riferimento ai comandi CLI
• Riferimento ai comandi slash

---

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