Scheda rapida per la CLI di Hermes Agent — comandi, flag e scorciatoie con slash

Hermes Agent di Nous Research è un assistente basato su modelli, agnostico e utilizzatore di strumenti, che puoi eseguire in locale 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 l’estensione web è installata.

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

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

Installazione di Hermes Agent e comandi CLI di primo 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 recupera 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 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 sulla versione.
hermes completion bash | zsh | fish	Genera script di completamento del shell per il completamento con il tasto Tab.
hermes update [--check] [--backup] [--restart-gateway]	Scarica l’ultimo codice, reinstalla le dipendenze, snapshot opzionale della home prima dell’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 predefinito “sticky” da hermes profile use).
--resume, -r	Riprende una sessione per 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	Ignora le richieste di approvazione per 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 valori predefiniti); .env viene comunque caricato.
--ignore-rules	Salta 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 dell’interfaccia TUI.

L’automazione isolata spesso combina hermes chat --ignore-user-config --ignore-rules con hermes -z per esecuzioni 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, set di strumenti, ripresa, worktree, 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 di sessione. Stesso agente e strumenti; ideale per pipe e script.
hermes chat --quiet, -Q	Modalità programmatica più silenziosa (banner e anteprime degli strumenti soppresse).
-m / --model, --provider	Sovrascritture del modello e del provider per la singola esecuzione; le variabili d’ambiente HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER replicano il 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 checkpoint nel filesystem prima di modifiche distruttive.
--max-turns N	Limite massimo di iterazioni di chiamata degli strumenti per turno (predefinito dalla configurazione).
--source	Tag di origine della sessione (cli vs tool per integrazioni).

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

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

La scelta tra endpoint locali compatibili con OpenAI e API ospitate per hermes model presenta gli stessi compromessi del generale ospitaggio di LLM. (latenza, costo, operazioni).

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

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	Apri config.yaml in $EDITOR.
hermes config set key value	Imposta valori (secret indirizzati a .env, non-secret a YAML).
hermes config path / hermes config env-path	Stampa i percorsi ai file di configurazione e env.
hermes config check	Rileva impostazioni mancanti o obsolete.
hermes config migrate	Applica interattivamente le nuove opzioni introdotte.

Dove si trovano i file — Tutto risiede sotto HERMES_HOME (predefinito ~/.hermes) per configurazione, secret, 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 sessioni (es. JSONL).
hermes sessions delete, prune, rename, stats	Elimina una sessione, rimuovi quelle vecchie, rinomina i titoli, mostra statistiche dello store.
hermes profile list | use | create | delete | show | rename	Gestisci istanze Hermes isolate su una 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 cambiare il profilo predefinito “sticky”.

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

Per la configurazione incentrata sul profilo e le competenze ottimizzate per flussi di lavoro di produzione reali per ruolo, vedi Competenze dell’Assistente AI Hermes per Configurazioni di Produzione Reali. Per scrivere e debuggare file SKILL.md—metadata, disclosure progressiva e visibilità condizionale—vedi Autore di Competenze Hermes Agent — Struttura e Best Practices di SKILL.md.

Comando	Descrizione
hermes tools	Abilitazione interattiva degli strumenti per piattaforma; --summary stampa le scelte attuali.
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 del shell dichiarati e allowlist nella configurazione.
hermes plugins	Interfaccia utente composita o sotto-comandi per installare, abilitare, disabilitare, rimuovere plugin.

Memoria integrata e provider hermes memory

I file integrati MEMORY.md / USER.md rimangono attivi; i provider esterni aggiungono livelli di recall opzionali. Per capire come questa architettura si comporta nella pratica, leggi Sistema di Memoria di Hermes Agent — Come Funziona Realmente la Memoria AI Persistente. Per confrontare i backend esterni e i comprometti di attivazione, vedi Provider di Memoria degli Agenti Confrontati — Honcho, Mem0, Hindsight e altri cinque.

Comando	Descrizione
hermes memory setup	Configurazione interattiva del provider di memoria esterna.
hermes memory status	Mostra 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 è configurato 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 ponte WhatsApp.
hermes slack manifest	Genera il manifest 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 male. Per flussi di lavoro end-to-end dal telefono utilizzando lo stesso livello di gateway, vedi Controllo Vocale Hermes dal tuo Telefono. Per l’operazione su server dedicati con un client desktop separato, segui Configurazione Server Headless Hermes Agent e Desktop Remoto.

Programmatore Cron, webhook e Kanban

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

Se hai bisogno di pattern di concorrenza pratici per hermes kanban su gateway auto-ospitati, vedi Kanban in Hermes Agent per Flussi di Lavoro LLM Auto-Ospitati.

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ù profondi quando necessario.
hermes dump [--show-keys]	Riassunto di configurazione facile da incollare per Discord o issue GitHub.
hermes debug share	Carica bundle di debug redatto su un servizio di paste (o --local).
hermes logs [agent | errors | gateway | list]	Tail e filtri dei log nella directory di log del profilo.
hermes backup, hermes import	Snapshot zip dei dati home e percorsi di ripristino.
hermes insights [--days N] [--source …]	Analitiche su 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ù 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 necessaria un’installazione extra).
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, secret opzionali).

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

Comandi slash nella sessione CLI di Hermes

Digita / per il completamento automatico. I comandi sono case-insensitive; le competenze registrano route extra /skill-name. Le tabelle seguenti sono un sottoinsieme curato; per il registro completo vedi Documentazione Ufficiale Hermes Agent alla fine di questo articolo.

Flusso della sessione, attività 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 scarta l’ultimo scambio.
/title …	Nomina la sessione per un futuro /resume.
/background …, /queue …, /steer …	Esecuzione parallela in background, prossimo prompt in coda, spinta a metà ciclo dopo il prossimo strumento.
/goal …	Obiettivo persistente multi-turno con loop di giudizio (status, pause, resume, clear).
/branch, /fork	Ramifica la conversazione per esplorazione alternativa.

Modelli, toggle degli strumenti, competenze e ricarica

Comando	Descrizione
/model … [--global]	Passa tra i modelli tra i provider configurati; --global persiste il predefinito.
/tools …, /toolsets	Toggle degli strumenti della sessione e elenco dei set di strumenti.
/skills …	Cerca, installa e gestisci competenze dalla chat.
/cron …	UI delle attività programmate 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 set di slash sovrapposto più /approve, /restart, /commands e helper solo gateway correlati — le differenze di piattaforma sono documentate nel riferimento dei comandi slash sotto Documentazione Ufficiale Hermes Agent di seguito.

Lettura ulteriore utile

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

• Sistemi AI — Assistenti Auto-Ospitati, RAG e Infrastruttura Locale — panoramica del cluster e come gli assistenti si inseriscono nello stack
• Memoria Sistemi AI — hub della memoria e guide correlate
• Strumenti per Sviluppatori AI — panorama degli strumenti terminali e IDE
• Quickstart OpenCode — un altro agente incentrato sul terminale per un confronto ergonomico

Documentazione Ufficiale 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 i vaghi report di “qualcosa si è rotto” in diff azionabili rispetto a una configurazione nota buona.