Hermes Agent CLI-cheat sheet — commando’s, vlaggen en slashkortingen

Hermes Agent van Nous Research is een modelagnostische, toolgebruikende assistent die lokaal of op een VPS wordt uitgevoerd.

Hermes sluit je niet op één interface af. Je kunt gebruiken:

• de klassieke hermes / hermes chat CLI,
• de volledig schermvullende hermes --tui-sessie,
• een continu draaiende hermes gateway voor Telegram, Discord, Slack en andere messagingplatforms,
• hermes dashboard voor een lokale browser-UI wanneer de web-extra’s zijn geïnstalleerd.

Deze paden delen dezelfde configuratie en data onder ~/.hermes; deze pagina bevat een overzicht van shell-commando’s die relevant zijn in al deze modi.

Hieronder volgt een geconcentreerde commandoreferentie, gegroepeerd per taak.

Hermes Agent installeren en CLI-commando’s voor de eerste keer

Voor installatie en probleemoplossing begint u bij Hermes AI Assistant — Installatie, Setup, Workflow en Probleemoplossing.

De installer haalt de repository op, stelt een Python-omgeving in en koppelt de hermes-executable. Na source ~/.bashrc of ~/.zshrc is uw standaardinval voor interactieve chat simpelweg hermes (zelfde familie als hermes chat).

Commando	Beschrijving
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash	Officiële één-regelsinstallatie (Linux, macOS, WSL2).
hermes / hermes chat	Start interactieve chat na installatie (standaard dagelijkse inval).
hermes --version / hermes version	Versie-informatie weergeven.
hermes completion bash | zsh | fish	Shell-compleptiescripts genereren voor tab-completiën.
hermes update [--check] [--backup] [--restart-gateway]	Nieuwste code ophalen, afhankelijkheden opnieuw installeren, optionele snapshot van home of gateway herstart voorafgaand aan update.
hermes uninstall [--full] [--yes]	Hermes verwijderen; optionele volledige verwijdering van data.

Native Windows wordt niet ondersteund; gebruik WSL2. Android-installaties via Termux volgen een apart pad in de upstream-documentatie.

Globale vlaggen voor elke hermes-aanroep

Deze vlaggen worden toegepast voordat subcommando’s worden uitgevoerd en beïnvloeden welk profiel, welke sessie of hoeveel persoonlijke configuratie wordt geladen.

Vlag	Beschrijving
--profile, -p	Selecteer het Hermes-profiel voor deze run (overschrijft het sticky-standaardprofiel uit hermes profile use).
--resume, -r	Sessie hervatten op basis van ID of titel.
--continue [name], -c	Ga door met de laatste sessie, of de laatste die overeenkomt met een titel.
--worktree, -w	Start in een geïsoleerde Git-worktree voor parallelle agents.
--yolo	Omzeil goedkeuringsprompts voor gevaarlijke commando’s (met voorzichtigheid gebruiken).
--pass-session-id	Voeg het sessie-ID toe aan de system prompt.
--ignore-user-config	Sla ~/.hermes/config.yaml over (alleen standaarden); .env wordt nog wel geladen.
--ignore-rules	Sla automatische injectie van AGENTS.md, SOUL.md, .cursorrules, geheugen en vooraf geladen vaardigheden over.
--tui	Start de TUI (equivalent aan HERMES_TUI=1).
--dev	Voer bij --tui TS-bronnen uit via tsx voor TUI-ontwikkeling.

Geïsoleerde automatisering combineert vaak hermes chat --ignore-user-config --ignore-rules met hermes -z voor reproduceerbare eenmalige uitvoeringen.

hermes chat, eenmalige prompts en hermes -z

Commando / patroon	Beschrijving
hermes chat	Interactieve of gescripte chat; hoofdinterface voor -q, -m, --provider, toolsets, hervatten, worktree, checkpoints.
hermes chat -q "..."	Eenmalige prompt (niet-interactief); behoudt rijkere uitvoer dan -z wanneer tools worden uitgevoerd.
hermes -z "..."	Gescripte eenmalige uitvoering — alleen het eindantwoord op stdout, geen banner of sessieruis. Dezelfde agent en tools; ideaal voor pipes en scripts.
hermes chat --quiet, -Q	Rustigere programmeermodus (banner en toolvoorbeelden onderdrukt).
-m / --model, --provider	Per-run model- en provideroverschrijvingen; omgevingsvariabelen HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER spiegelen dit gedrag.
-t / --toolsets	Activeer komma-gescheiden toolsets voor de run.
-s / --skills	Vooraf laden van vaardigheden (herhaal of komma-gescheiden).
--image path	Voeg een lokale afbeelding toe aan een enkele query.
--checkpoints	Schakel bestandssysteemcheckpoints in voorafgaand aan destructieve bewerkingen.
--max-turns N	Beperk het aantal tool-calling-iteraties per beurt (standaard uit configuratie).
--source	Sessie-bron-tag (cli vs tool voor integraties).

Hermes-model buiten de sessie vs /model binnenin — Het uitvoeren van hermes model vanuit de shell is waar u providers, sleutels en OAuth toevoegt. Slash /model schakelt alleen tussen reeds geconfigureerde providers. Als u alleen OpenRouter ziet in /model, verlaat dan de sessie en voltooi hermes model.

Modelkiezer, credentieelpools en fallback-providers

Commando	Beschrijving
hermes model	Interactieve provider- en modelkiezer; sleutels, OAuth, aangepaste eindpunten.
hermes auth	Credentieelpools — add, list, remove, reset voor rotatievriendelijke sleutels en OAuth.
hermes fallback [list | add | remove | clear]	Beheer gerangschikte fallback-providers wanneer de primaire provider fouten geeft of rate-limits bereikt.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Gedeeltelijke of volledige interactieve setup (--quick, --reset, --non-interactive).

Verouderd hermes login / hermes logout — gebruik in plaats daarvan hermes auth en hermes model.

Het kiezen tussen lokale OpenAI-compatibele eindpunten en gehoste APIs voor hermes model komt neer op dezelfde afwegingen als algemene LLM-hosting (latentie, kosten, beheer).

Zodra uw standaard eindigt bij Qwen of Gemma op iets als Ollama, zijn sampler-standaarden net zo belangrijk als het model-ID dat u typte; zie de samengestelde agent-gerichte temperatuur- en penality-voorinstellingen in Agentic LLM-inferenteparameters voor Qwen en Gemma.

Configuratiebestanden en hermes config-commando’s

Configuratie wordt opgelost als CLI-overschrijvingen → config.yaml → .env → standaarden. API-sleutels horen in .env; gestructureerde instellingen in config.yaml.

Commando	Beschrijving
hermes config show	Toon effectieve configuratie.
hermes config edit	Open config.yaml in $EDITOR.
hermes config set key value	Waarden instellen (geheimen worden doorgeroeteerd naar .env, niet-geheimen naar YAML).
hermes config path / hermes config env-path	Toon paden naar configuratie- en env-bestanden.
hermes config check	Detecteer ontbrekende of verouderde instellingen.
hermes config migrate	Pas nieuw geïntroduceerde opties interactief toe.

Waar bestanden liggen — Alles bevindt zich onder HERMES_HOME (standaard ~/.hermes) voor configuratie, geheimen, geheugen, vaardigheden, sessies, gateway-status en logs.

Sessiebeheer en hermes profile

Commando	Beschrijving
hermes sessions list	Recentste sessies tonen.
hermes sessions browse	Interactieve kiezer met zoekfunctie en hervatten.
hermes sessions export	Sessies exporteren (bijv. JSONL).
hermes sessions delete, prune, rename, stats	Één sessie verwijderen, oude sessies opruimen, titels hernoemen, store-statistieken tonen.
hermes profile list | use | create | delete | show | rename	Beheer geïsoleerde Hermes-instanties op één machine.
hermes profile export / import	Archiveren of herstellen van een profiel-tarball.
hermes profile alias	Korte wrapper-scripts voor snel schakelen tussen profielen.

Gebruik hermes -p work chat -q "..." voor ad-hoc uitvoeringen zonder het sticky-standaardprofiel te wijzigen.

Skills-hub, toolsets, shell-hooks en plugins

Voor profiel-gerichte configuratie en vaardigheden afgestemd op echte productie-workflows per rol, zie Hermes AI Assistant Skills voor Real Production Setups. Voor het schrijven en debuggen van SKILL.md-bestanden—metadata, progressieve openbaarmaking en conditionele zichtbaarheid—zie Hermes Agent Skill Authoring — SKILL.md Structuur en Best Practices.

Commando	Beschrijving
hermes tools	Interactieve per-platform tool-activatie; --summary toont huidige keuzes.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config	Skills-hub workflows inclusief registers en URL-installaties.
hermes curator status, run, pause, pin, rollback, …	Achtergrondonderhoud van vaardigheden en veilige rollback.
hermes hooks list, test, revoke, doctor	Gedeclearde shell-hooks en allowlists in configuratie.
hermes plugins	Samengestelde UI of subcommando’s om plugins te installeren, activeren, deactiveren, verwijderen.

Ingebouwd geheugen en hermes memory-providers

Ingebouwd MEMORY.md / USER.md blijven actief; externe providers voegen optionele herinneringslagen toe. Voor hoe deze architectuur in de praktijk werkt, lees Hermes Agent Memory System — Hoe Persistent AI Geheugen Echt Werkt. Om externe backends en activatie-afwegingen te vergelijken, zie Agent Memory Providers Compared — Honcho, Mem0, Hindsight en Vijf Meer.

Commando	Beschrijving
hermes memory setup	Interactieve configuratie van externe geheugenprovider.
hermes memory status	Toon actieve provider-instellingen.
hermes memory off	Schakel externe provider uit; ingebouwde bestanden blijven behouden.

Wanneer een provider actief is, kan deze extra providerspecifieke top-level subcommando’s registreren — voer hermes --help uit om te zien wat momenteel is gekoppeld.

Messaging-gateway, DM-pairing en platforms

Commando	Beschrijving
hermes gateway setup	Interactieve messaging-platformsetup.
hermes gateway run	Voorgrondgateway (aanbevolen op WSL, Docker, Termux).
hermes gateway start | stop | restart | status	systemd / launchd-servicebeheer (--all beïnvloedt de gateway van elk profiel).
hermes gateway install | uninstall	Installeer of verwijder gebruikersniveau-achtergrondservice.
hermes pairing list | approve | revoke | clear-pending	DM-pairing-goedkeuringen voor messaging-bots.
hermes whatsapp	WhatsApp-bridge-pairingflow.
hermes slack manifest	Genereer Slack-app-manifest met gateway-slash-pariteit.

Op WSL is hermes gateway run binnen tmux het robuuste patroon wanneer gateway start misgedraagt. Voor end-to-end telefoonworkflows met diezelfde gatewaylaag, zie Hermes Voice Control from Your Phone. Voor dedicated-serverbedrijf met een aparte desktopclient, volg Hermes Agent Headless Server and Remote Desktop Setup.

Cron-scheduler, webhooks en Kanban

Commando	Beschrijving
hermes cron …	Maak, bewerk, pauzeer, hervat, voer uit, verwijder geplande prompts (tick voor handmatige scheduler-pass).
hermes webhook subscribe, list, remove, test	Dynamische webhook-routes voor event-driven runs.
hermes kanban …	Multi-profiel taakbord ondersteund door SQLite; dispatch drijft workers aan.

Als u praktische concurrentiepatronen nodig heeft voor hermes kanban op self-hosted gateways, zie Kanban in Hermes Agent for Self Hosted LLM Workflows.

hermes doctor, logs, backup en gebruiksinzichten

Commando	Beschrijving
hermes doctor [--fix]	Interactieve diagnostiek en optionele automatische reparatie.
hermes status [--all] [--deep]	Beknopte status; diepere controles indien nodig.
hermes dump [--show-keys]	Paste-vriendelijke setupsamenvatting voor Discord of GitHub-issues.
hermes debug share	Upload geredigeerd debugpakket naar een paste-service (of --local).
hermes logs [agent | errors | gateway | list]	Tail en filter logs onder het profiellogboekdirectory.
hermes backup, hermes import	Zip-snapshots van homedata en herstelpaden.
hermes insights [--days N] [--source …]	Token-, kosten- en activiteitsanalyses.

Wanneer er iets kapotgaat na een upgrade, vormen hermes doctor, hermes status en hermes logs errors -f de snelste triagelus.

MCP, ACP, webdashboard en OpenClaw-migratie

Commando	Beschrijving
hermes mcp serve	Voer Hermes uit als MCP-server.
hermes mcp add, remove, list, test, configure	Beheer MCP-clientverbindingen vanuit Hermes.
hermes acp	Agent Client Protocol stdio-server voor editors (extra installatie kan van toepassing zijn).
hermes dashboard [--port …] [--host …]	Lokaal webdashboard (pip install hermes-agent[web]).
hermes claw migrate …	Migreer OpenClaw-stijl configuraties naar Hermes (--dry-run, presets, optionele geheimen).

OpenClaw-migratie — hermes claw migrate leest legacy OpenClaw-home-directories; voor hoe die stack eruitzag voordat het verhuisde, zie de OpenClaw case study.

Slash-commando’s in de Hermes CLI-sessie

Typ / voor autocomplete. Commando’s zijn niet-case-sensitive; vaardigheden registreren extra /skill-name-routes. De onderstaande tabellen zijn een samengesteld subset; voor het volledige register zie Officiële Hermes Agent-documentatie aan het einde van dit artikel.

Sessiestroom, achtergrondtaken en doelen

Commando	Beschrijving
/new, /reset	Nieuw sessie-ID en geschiedenis.
/resume [name]	Hervat een benoemde sessie.
/compress [focus]	Handmatige contextcompressie met optioneel focusonderwerp.
/retry, /undo	Herhaal laatste beurt of verwijder laatste wisselwerking.
/title …	Noem de sessie voor later /resume.
/background …, /queue …, /steer …	Parallelle achtergrondrun, gerangschikte volgende prompt, mid-loop stimulus na volgende tool.
/goal …	Persistent multi-turn doel met judge-lus (status, pause, resume, clear).
/branch, /fork	Vertak het gesprek voor alternatieve verkenning.

Modellen, tool-toggles, vaardigheden en herladen

Commando	Beschrijving
/model … [--global]	Schakel modellen tussen geconfigureerde providers; --global behoudt standaard.
/tools …, /toolsets	Sessie-tool-toggles en toolset-weergave.
/skills …	Zoek, installeer en beheer vaardigheden vanuit chat.
/cron …	Geplande taken-UI vanuit de CLI-sessie.
/reload-mcp	Herlaad MCP-servers uit configuratie.
/reload	Herlaad .env in de lopende sessie zonder herstart.

Gebruik, hulp en afsluiten

Commando	Beschrijving
/usage, /insights	Token- en kostenzichtbaarheid; analysesnapshot.
/help, /quit	Hulp of exit de CLI.

Messaging-apps (Telegram, Discord, Slack en anderen) tonen een overlappende slash-set plus /approve, /restart, /commands en gerelateerde gateway-only helpers — platformverschillen zijn gedocumenteerd in de slash-commandoreferentie onder Officiële Hermes Agent-documentatie hieronder.

Meer nuttige lectuur

Gerelateerde pagina’s op deze site (breder context voor Hermes en terminal-agents):

• AI Systems — Self-Hosted Assistants, RAG, and Local Infrastructure — clusteroverzicht en hoe assistants in de stack passen
• AI Systems Memory — geheugenhub en aangrenzende guides
• AI Developer Tools — terminal- en IDE-toolinglandschap
• OpenCode Quickstart — een andere terminal-first agent voor ergonomische vergelijking

Officiële Hermes Agent-documentatie

Upstream-documentatie op hermes-agent.nousresearch.com:

• Hermes Agent
• CLI-commandoreferentie
• Slash-commandoreferentie

---

Tip. Houd hermes dump en hermes doctor --fix in uw spiergeheugen — ze zetten vaag “iets is kapot” rapporten om in actiegerichte diffs tegen een bekende goede setup.