Wat is de standaardmethode om een interactieve chat met Hermes Agent te starten?

Na installatie voert u hermes of hermes chat uit vanuit uw shell. Dit opent de interactieve agent met uw geconfigureerde standaardmodel, toolsets en profiel.

Hoe voert u een scriptvriendelijke one-shot uit die alleen het eindantwoord afdrukt?

Gebruik hermes -z met je prompt, zodat stdout de pure eindtext bevat zonder banners of sessieregels. Als je tooloutput in het transcript nodig hebt, gebruik dan hermes chat -q.

Hoe verschilt het Terminal Hermes-model van het modelcommando voor sessie-gebaseerde slash-modellen?

Het Hermes-model draait buiten een chatsessie en kan providers, API-sleutels, OAuth-aanmeldingen en aangepaste eindpunten toevoegen. De opdracht /model wisselt alleen tussen providers die u al hebt geconfigureerd.

Waar bewaart Hermes Agent configuratiebestanden en geheimen op de schijf?

De staat wordt bewaard onder HERMES_HOME, doorgaans ~/.hermes, met config.yaml voor instellingen, .env voor geheimen, auth-data waar nodig, en mappen voor sessies, vaardigheden, geheugen, cron en logs.

Welke CLI-commanden zijn nuttig wanneer modellen falen of API-sleutels onjuist lijken?

Voer hermes doctor uit voor oplossingen, hermes status voor een momentopname, hermes dump voor een samenvatting die makkelijk gekopieerd kan worden, en hermes logs met filters of follow-modus om fouten te inspecteren.

Hoe moet u de messaginggateway op WSL2 uitvoeren?

Gebruik de Hermes-gateway bij voorkeur binnen tmux in plaats van te vertrouwen op de achtergrondstart via systemd, omdat het systemd-gedrag in WSL varieert. Configureer de platforms eerst met hermes gateway setup.

Hoe voert u meerdere geïsoleerde Hermes-opstellingen op één machine uit?

Gebruik het Hermes-profiel om aparte huizen te maken en schakel met –profile of hermes profile use, zodat elk profiel zijn eigen configuratie, sessies, vaardigheden en gateway-status behoudt.

Hermes Agent CLI-cheatsheet — commando’s, vlaggen en slash-shortcuts

Shell- en TUI-commando’s voor de zelfgehoste Hermes Agent.

Inhoud

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

Hermes bindt je niet aan één interface. Je kunt gebruiken:

de klassieke hermes / hermes chat CLI,
de volledige scherm hermes --tui-sessie,
een langlopende hermes gateway voor Telegram, Discord, Slack en andere messagingplatforms,
hermes dashboard voor een lokale browser-UI wanneer de web-extra is geïnstalleerd.

Deze methoden delen dezelfde configuratie en data onder ~/.hermes; deze pagina behandelt de shell-commando’s die relevant zijn voor al deze modi.

Hermes Agent CLI-cheatsheet — terminalreferentie

Hieronder vind je 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-assistent — Installeren, Instellen, Werkflow en Probleemoplossing.

De installer haalt de repo op, stelt een Python-omgeving in en koppelt de hermes-executable. Na source ~/.bashrc of ~/.zshrc is je standaard ingangspunt voor interactieve chat simpelweg hermes (dezelfde familie als hermes chat).

Commando	Beschrijving
`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \| bash`	Officiële één-regels installatie (Linux, macOS, WSL2).
`hermes` / `hermes chat`	Start interactieve chat na installatie (standaard dagelijkse ingang).
`hermes --version` / `hermes version`	Toon versie-informatie.
`hermes completion bash` \| `zsh` \| `fish`	Genereer shell-completiesscripts voor tab-completering.
`hermes update [--check] [--backup] [--restart-gateway]`	Haal nieuwste code, herinstalleer afhankelijkheden, optionele pre-update home snapshot of gateway herstart.
`hermes uninstall [--full] [--yes]`	Verwijder Hermes; optionele volledige dataverwijdering.

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 voor subcommando’s en wijzigen welk profiel, welke sessie, of hoeveel persoonlijke configuratie wordt geladen.

Vlag	Beschrijving
`--profile`, `-p`	Selecteer Hermes-profiel voor deze run (overschrijft kleverige standaard van `hermes profile use`).
`--resume`, `-r`	Hervat een sessie op ID of titel.
`--continue [name]`, `-c`	Ga door met de meest recente sessie, of de meest recente die overeenkomt met een titel.
`--worktree`, `-w`	Start in een geïsoleerde Git worktree voor parallelle agenten.
`--yolo`	Omzeil promptvoorkeuren voor gevaarlijke commando’s (gebruik met voorzichtigheid).
`--pass-session-id`	Voeg sessie-ID toe aan de systeem-prompt.
`--ignore-user-config`	Sla `~/.hermes/config.yaml` over (alleen standaarden); `.env` wordt nog steeds geladen.
`--ignore-rules`	Sla automatische injectie van AGENTS.md, SOUL.md, `.cursorrules`, geheugen en voorgevulde vaardigheden over.
`--tui`	Start de TUI (equivalent aan `HERMES_TUI=1`).
`--dev`	Met `--tui`, voer 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 one-shots.

`hermes chat`, one-shot prompts en `hermes -z`

Commando / patroon	Beschrijving
`hermes chat`	Interactieve of gescripte chat; hoofdoppervlak voor `-q`, `-m`, `--provider`, toolsets, hervatten, worktree, checkpoints.
`hermes chat -q "..."`	One-shot prompt (niet-interactief); behoudt rijkere output dan `-z` wanneer tools worden uitgevoerd.
`hermes -z "..."`	Gescripte one-shot — alleen het eindantwoord op stdout, geen banner of sessieruis. Dezelfde agent en tools; het beste voor pipes en scripts.
`hermes chat --quiet`, `-Q`	Stilere programmatische modus (banner en tool previews onderdrukt).
`-m` / `--model`, `--provider`	Per-run model- en provideroverschrijvingen; omgevingsvariabelen `HERMES_INFERENCE_MODEL` / `HERMES_INFERENCE_PROVIDER` spiegelen dit gedrag.
`-t` / `--toolsets`	Schakel komma-gescheiden toolsets in voor de run.
`-s` / `--skills`	Voeg vaardigheden vooraf toe (herhaal of komma-gescheiden).
`--image path`	Voeg een lokale afbeelding toe aan een enkele query.
`--checkpoints`	Schakel bestandssysteemcheckpoints in voordat destructieve bewerkingen worden uitgevoerd.
`--max-turns N`	Beperk het aantal tool-aanroepen 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 je providers, sleutels en OAuth toevoegt. De slash /model wisselt alleen tussen reeds geconfigureerde providers. Als je alleen OpenRouter ziet in /model, verlaat dan de sessie en voltooi hermes model.

Modelkiezer, credential-pools en fallback-providers

Commando	Beschrijving
`hermes model`	Interactieve provider- en modelkiezer; sleutels, OAuth, aangepaste eindpunten.
`hermes auth`	Credential-pools — `add`, `list`, `remove`, `reset` voor rotatie-vriendelijke sleutels en OAuth.
`hermes fallback [list \| add \| remove \| clear]`	Beheer gerangschikte fallback-providers wanneer de primaire faalt of rate-limits.
`hermes setup [model \| tts \| terminal \| gateway \| tools \| agent] [...]`	Gesegmenteerde of volledige interactieve setup (`--quick`, `--reset`, `--non-interactive`).

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

Het kiezen van lokale OpenAI-compatibele eindpunten versus gehoste APIs voor hermes model komt overeen met dezelfde afwegingen als algemene LLM-hosting (latentie, kosten, beheer).

ConfiguratiedBestanden en `hermes config`-commando’s

Configuratie wordt opgelost als CLI-overschrijvingen → config.yaml → .env → standaarden. API-sleutels horen thuis 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`	Stel waarden in (geheimen worden doorverwezen 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 staan — Alles bevindt zich onder HERMES_HOME (standaard ~/.hermes) voor configuratie, geheimen, geheugens, vaardigheden, sessies, gateway-status en logs.

Sessiebeheer en `hermes profile`

Commando	Beschrijving
`hermes sessions list`	Lijst recente sessies op.
`hermes sessions browse`	Interactieve kiezer met zoekfunctie en hervatten.
`hermes sessions export`	Exporteer sessies (bijv. JSONL).
`hermes sessions delete`, `prune`, `rename`, `stats`	Verwijder één sessie, snoei oude, hernoem titels, toon opslagstatistieken.
`hermes profile list` \| `use` \| `create` \| `delete` \| `show` \| `rename`	Beheer geïsoleerde Hermes-instanties op één machine.
`hermes profile export` / `import`	Archiveer of herstel een profiel-tarball.
`hermes profile alias`	Korte wrapper-scripts voor snelle profielwisseling.

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

Vaardighedenhub, toolsets, shell-hooks en plugins

Voor profiel-gerichte configuratie en vaardigheden die zijn afgestemd op echte productiewerkflows per rol, zie Hermes AI-assistent Vaardigheden voor Echte Productie-instellingen.

Commando	Beschrijving
`hermes tools`	Interactieve per-platform toolinschakeling; `--summary` drukt huidige keuzes af.
`hermes skills browse`, `search`, `inspect`, `install`, `list`, `check`, `update`, `audit`, `uninstall`, `publish`, `snapshot`, `tap`, `config`	Vaardighedenhub-workflows inclusief registers en URL-installaties.
`hermes curator status`, `run`, `pause`, `pin`, `rollback`, …	Achtergrondvaardigheidsbeheer en veilige rollback.
`hermes hooks list`, `test`, `revoke`, `doctor`	Gedecreeerde shell-hooks en toewijzingslijsten in configuratie.
`hermes plugins`	Samengestelde UI of subcommando’s om plugins te installeren, inschakelen, uitschakelen, verwijderen.

Ingebouwd geheugen en `hermes memory`-providers

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

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

Wanneer een provider actief is, kan deze extra provider-specifieke hooggeplaatste subcommando’s registreren — voer hermes --help uit om te zien wat er vandaag is aangesloten.

Messaging-gateway, DM-pairing en platforms

Commando	Beschrijving
`hermes gateway setup`	Interactieve messagingplatform-configuratie.
`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-pairing-flow.
`hermes slack manifest`	Genereer Slack-app-manifest met gateway-slash-pariteit.

Op WSL is hermes gateway run binnen tmux het veerzame patroon wanneer gateway start misgedraagt.

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 gebeurtenis-gedreven runs.
`hermes kanban …`	Multi-profiel taakbord achtergrond door SQLite; `dispatch` stuurt workers aan.

`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 wanneer nodig.
`hermes dump [--show-keys]`	Plakvriendelijke setup-overzicht voor Discord of GitHub-issues.
`hermes debug share`	Upload geredigeerd debugbundel naar een paste-service (of `--local`).
`hermes logs [agent \| errors \| gateway \| list]`	Tail en filter logs onder het profiel’s logdirectory.
`hermes backup`, `hermes import`	Zip-snapshots van home-data en herstelpaden.
`hermes insights [--days N] [--source …]`	Token-, kosten- en activiteitsanalyses.

Wanneer er iets breekt na een upgrade, vormen hermes doctor, hermes status en hermes logs errors -f de snelste triage-loop.

MCP, ACP, web-dashboard en OpenClaw-migratie

Commando	Beschrijving
`hermes mcp serve`	Voer Hermes uit als een 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 web-dashboard (`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 voor het verhuizen, zie de OpenClaw-casestudy.

Slash-commando’s in de Hermes CLI-sessie

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

Sessieflow, 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 uitwisseling.
`/title …`	Noem de sessie voor latere `/resume`.
`/background …`, `/queue …`, `/steer …`	Parallelle achtergrondrun, in wachtrij geplaatste volgende prompt, mid-loop nudge na volgende tool.
`/goal …`	Persistent multi-turn doel met judge-loop (`status`, `pause`, `resume`, `clear`).

Modellen, tool-toggles, vaardigheden en herladen

Commando	Beschrijving
`/model … [--global]`	Wissel modellen tussen geconfigureerde providers; `--global` maakt standaard persistent.
`/tools …`, `/toolsets`	Sessie-tool-toggles en toolset-lijst.
`/skills …`	Zoek, installeer en beheer vaardigheden vanuit chat.
`/cron …`	Geplande taken-UI vanuit de CLI-sessie.
`/reload-mcp`	Herlaad MCP-servers vanuit 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 verlaat 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 terminalagenten):

AI-systemen — Zelf-gehoste Assistenten, RAG en Lokale Infrastructuur — clusteroverzicht en hoe assistenten in de stack passen
AI-systemen Geheugen — geheugenhub en aangrenzende gidsen
AI-ontwikkelaarsgereedschap — terminal- en IDE-gereedschapslandschap
OpenCode Quickstart — een andere terminal-first agent voor ergonomische vergelijking

Officiële Hermes Agent-documentatie

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

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