Hermes Agent CLI-antatt: Kommandon, flaggor och snedstrecks-genvägar
Skal- och TUI-kommandon för självhostad Hermes-agent.
Hermes Agent från Nous Research är en modellagnostisk, verktygsanvändande assistent som du kör lokalt eller på en VPS.
Hermes låser inte fast dig till en enda gränssnittsyta. Du kan använda
- den klassiska
hermes/hermes chatCLI:n, - den fullskärms
hermes --tui-sessionen, - en långkörd
hermes gatewayför Telegram, Discord, Slack och andra plattformar för meddelanden, hermes dashboardför en lokal webbläsarbaseras gränssnitt när webbläggadd-onen är installerad.
Dessa vägar delar samma konfiguration och data under ~/.hermes; denna sida listar shellkommandon som är viktiga i alla dessa lägen.

Nedan följer en kompakt kommandoreferens grupperad efter uppgift.
Installera Hermes Agent och första kommandon i CLI
För installation och felsökning, börja med Hermes AI-assistent — Installation, konfiguration, arbetsflöde och felsökning.
Installationsprogrammet hämtar källkoden, ställer upp en Python-miljö och kopplar ihop hermes-exekveringsbara filen. Efter source ~/.bashrc eller ~/.zshrc, är din standardingångspunkt för interaktiv chatt enkelt hermes (samma familj som hermes chat).
| Kommando | Beskrivning |
|---|---|
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash |
Officiell installation i en rad (Linux, macOS, WSL2). |
hermes / hermes chat |
Starta interaktiv chatt efter installation (standard daglig ingång). |
hermes --version / hermes version |
Visar versionsinformation. |
hermes completion bash | zsh | fish |
Generera shell-skript för tabbkomplettering. |
hermes update [--check] [--backup] [--restart-gateway] |
Hämta senaste koden, återinstallera beroenden, valfri snapshot av hemkatalog eller gateway-omstart före uppdatering. |
hermes uninstall [--full] [--yes] |
Avinstallera Hermes; valfri fullständig radering av data. |
Innativ Windows stöds inte; använd WSL2. Installationer på Android via Termux följer en separat väg i upstream-dokumentationen.
Globala flaggor för varje hermes-anrop
Dessa flaggor gäller före subkommandon och ändrar vilken profil, vilken session, eller hur mycket personlig konfiguration som laddas.
| Flagga | Beskrivning |
|---|---|
--profile, -p |
Välj Hermes-profil för detta körning (åverskriver klistrig standard från hermes profile use). |
--resume, -r |
Återuppta en session via ID eller titel. |
--continue [name], -c |
Fortsätt senaste sessionen, eller senaste som matchar en titel. |
--worktree, -w |
Starta i en isolerad Git-worktree för parallella agenter. |
--yolo |
Kringgå godkännandeprompter för farliga kommandon (använd med försiktighet). |
--pass-session-id |
Inkludera session-ID i systemprompten. |
--ignore-user-config |
Hoppa över ~/.hermes/config.yaml (endast standardvärden); .env laddas fortfarande. |
--ignore-rules |
Hoppa över automatisk injektion av AGENTS.md, SOUL.md, .cursorrules, minne, förbelastade färdigheter. |
--tui |
Starta TUI (ekvivalent med HERMES_TUI=1). |
--dev |
Med --tui, kör TS-källkoden via tsx för TUI-utveckling. |
Isolerad automation parar ofta hermes chat --ignore-user-config --ignore-rules med hermes -z för reproducerbara engångskörningar.
hermes chat, engångsprompts och hermes -z
| Kommando / mönster | Beskrivning |
|---|---|
hermes chat |
Interaktiv eller skriptad chatt; huvudytan för -q, -m, --provider, verktygsuppsättningar, återupptagande, worktree, checkpunkter. |
hermes chat -q "..." |
Engångsprompt (icke-interaktiv); behåller rikare output än -z när verktyg kör. |
hermes -z "..." |
Skriptad engångskörning — endast slutlig svar på stdout, ingen banner eller sessionbrus. Samma agent och verktyg; bäst för pipor och skript. |
hermes chat --quiet, -Q |
Tystare programmeringsläge (banner och verktygsförhandsvisningar undertryckta). |
-m / --model, --provider |
Per-körning åverskrivningar av modell och leverantör; miljövariablerna HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER speglar beteendet. |
-t / --toolsets |
Aktivera kommateckensseparatorade verktygsuppsättningar för körningen. |
-s / --skills |
Förbelasta färdigheter (upprepa eller kommateckensseparatorade). |
--image path |
Bifoga en lokal bild till en enda fråga. |
--checkpoints |
Aktivera filsystemcheckpunkter före destruktiva redigeringar. |
--max-turns N |
Kap på antalet verktygsanrop per tur (standard från konfiguration). |
--source |
Sessionens källtag (cli vs tool för integrationer). |
Hermes-modell utanför sessionen vs /model inuti den — Att köra hermes model från shell är där du lägger till leverantörer, nycklar och OAuth. Slash /model byter endast mellan redan konfigurerade leverantörer. Om du bara ser OpenRouter i /model, avsluta sessionen och slutför hermes model.
Modellväljare, kreditpools och fallback-leverantörer
| Kommando | Beskrivning |
|---|---|
hermes model |
Interaktiv leverantörs- och modellväljare; nycklar, OAuth, anpassade ändpunkter. |
hermes auth |
Kreditpools — add, list, remove, reset för rotationsvänliga nycklar och OAuth. |
hermes fallback [list | add | remove | clear] |
Hantera ordnade fallback-leverantörer när primären misslyckas eller rate-limits. |
hermes setup [model | tts | terminal | gateway | tools | agent] [...] |
Seionerad eller full interaktiv installation (--quick, --reset, --non-interactive). |
Avvecklade hermes login / hermes logout — använd hermes auth och hermes model istället.
Att välja lokala OpenAI-kompatibla ändpunkter mot hosted APIs för hermes model har samma avvägningar som generell LLM-hosting.
När din standard termineras vid Qwen eller Gemma på något som Ollama, spelar sampler-standardvärden lika stor roll som vilken modell-ID du skrev; aggregera agentorienterade temperatur- och penaltetsförinställningar i Agentic LLM-inferensparametrar för Qwen och Gemma.
Konfigurationsfiler och hermes config-kommandon
Konfigurationen löses som CLI-åverskrivningar → config.yaml → .env → standardvärden. API-nycklar hör hemma i .env; strukturerade inställningar i config.yaml.
| Kommando | Beskrivning |
|---|---|
hermes config show |
Visa effektiv konfiguration. |
hermes config edit |
Öppna config.yaml i $EDITOR. |
hermes config set key value |
Sätt värden (hemligheter routas till .env, icke-hemligheter till YAML). |
hermes config path / hermes config env-path |
Visa sökvägar till konfigurations- och env-filer. |
hermes config check |
Detektera saknade eller föråldrade inställningar. |
hermes config migrate |
Tillämpa nyligen introducerade alternativ interaktivt. |
Var filerna finns — Allt sitter under HERMES_HOME (standard ~/.hermes) för konfiguration, hemligheter, minnen, färdigheter, sessioner, gateway-status och loggar.
Sessionhantering och hermes profile
| Kommando | Beskrivning |
|---|---|
hermes sessions list |
Lista senaste sessioner. |
hermes sessions browse |
Interaktiv väljare med sökning och återupptagande. |
hermes sessions export |
Exportera sessioner (t.ex. JSONL). |
hermes sessions delete, prune, rename, stats |
Radera en session, ta bort gamla, byt titlar, visa lagringsstatistik. |
hermes profile list | use | create | delete | show | rename |
Hantera isolerade Hermes-instanser på en maskin. |
hermes profile export / import |
Arkivera eller återställ en profiltarball. |
hermes profile alias |
Korta wrapper-skript för snabb profilbyte. |
Använd hermes -p arbete chat -q "..." för ad hoc-körningar utan att ändra den klistriga standardprofilen.
Färdighetshub, verktygsuppsättningar, shell-hooks och plugins
För profil-först-konfiguration och färdigheter anpassade för verkliga produktionsarbetsflöden efter roll, se Hermes AI-assistent Färdigheter för Verkliga Produktionsmiljöer. För att skriva och felsöka SKILL.md-filer—metadata, progressiv avslöjning och villkorlig synlighet—se Hermes Agent Färdighetsautorskap — SKILL.md Struktur och Bästa Praxen.
| Kommando | Beskrivning |
|---|---|
hermes tools |
Interaktiv per-plattform verktygsaktivering; --summary skriver ut nuvarande val. |
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config |
Färdighetshub-arbetsflöden inklusive register och URL-installationer. |
hermes curator status, run, pause, pin, rollback, … |
Bakgrundsunderhåll av färdigheter och säker rollback. |
hermes hooks list, test, revoke, doctor |
Deklarerade shell-hooks och tillåtlistor i konfiguration. |
hermes plugins |
Komposit UI eller subkommandon för att installera, aktivera, inaktivera, ta bort plugins. |
Inbyggt minne och hermes memory-leverantörer
Inbyggt MEMORY.md / USER.md förblir aktivt; externa leverantörer lägger till valbara minneslager. För hur den arkitekturen beter sig i praktiken, läs Hermes Agent Minnessystem — Hur Persistenta AI-minne Faktiskt Fungerar. För att jämföra externa backends och aktiveringsavvägningar, se Agent Minnesleverantörer Jämförda — Honcho, Mem0, Hindsight och Fler.
| Kommando | Beskrivning |
|---|---|
hermes memory setup |
Interaktiv konfiguration av extern minnesleverantör. |
hermes memory status |
Visa aktiva leverantörsinställningar. |
hermes memory off |
Inaktivera extern leverantör; inbyggda filer förblir. |
När en leverantör är aktiv kan den registrera extra leverantörspecifika toppnivåsubkommandon — kör hermes --help för att se vad som är kopplat idag.
Meddelandegateway, DM-parning och plattformar
| Kommando | Beskrivning |
|---|---|
hermes gateway setup |
Interaktiv konfiguration av meddelandeplattform. |
hermes gateway run |
Förgrundsgateway (rekommenderas på WSL, Docker, Termux). |
hermes gateway start | stop | restart | status |
systemd / launchd servicekontroll (--all påverkar varje profils gateway). |
hermes gateway install | uninstall |
Installera eller ta bort användarnivå bakgrundstjänst. |
hermes pairing list | approve | revoke | clear-pending |
DM-parningsgodkännanden för meddelanderobots. |
hermes whatsapp |
WhatsApp-bryggningsparningsflöde. |
hermes slack manifest |
Generera Slack-appmanifest med gateway-slash-paritet. |
På WSL, är hermes gateway run inuti tmux det resilenta mönstret när gateway start beter sig fel. För end-to-end telefonarbetsflöden som använder samma gateway-lager, se Hermes Röstkontroll från Din Telefon.
För dedikerad serverdrift med en separat skrivbordsklient, följ Hermes Agent Headless Server och Fjärrskrivbordskonfiguration.
Cron-schemaläggare, webhooks och Kanban
| Kommando | Beskrivning |
|---|---|
hermes cron … |
Skapa, redigera, pausa, återuppta, köra, ta bort schemalagda prompts (tick för manuell schemaläggarpass). |
hermes webhook subscribe, list, remove, test |
Dynamiska webhook-rutter för händelsedrivna körningar. |
hermes kanban … |
Multi-profil-uppgiftsbräda backad av SQLite; dispatch driver workers. |
Om du behöver praktiska konkurrensmönster för hermes kanban på self-hosted gateways, se Kanban i Hermes Agent för Self-Hosted LLM-Arbetsflöden.
hermes doctor, loggar, backup och användningsinsikter
| Kommando | Beskrivning |
|---|---|
hermes doctor [--fix] |
Interaktiv diagnostik och valfri automatisk reparation. |
hermes status [--all] [--deep] |
Koncis status; djupare kontroller när behövt. |
hermes dump [--show-keys] |
Paste-vänlig installationssummering för Discord eller GitHub-issues. |
hermes debug share |
Ladda upp redigerad debug-bundle till en paste-tjänst (eller --local). |
hermes logs [agent | errors | gateway | list] |
Taila och filtrera loggar under profilens logdkatalog. |
hermes backup, hermes import |
Zip-snapskott av hemdata och återställningsvägar. |
hermes insights [--days N] [--source …] |
Token-, kostnads- och aktivitetsanalyser. |
När något går sönder efter en uppgradering, utgör hermes doctor, hermes status och hermes logs errors -f den snabbaste triage-loopen.
MCP, ACP, webbdashboard och OpenClaw-migrering
| Kommando | Beskrivning |
|---|---|
hermes mcp serve |
Kör Hermes som en MCP-server. |
hermes mcp add, remove, list, test, configure |
Hantera MCP-klientanslutningar från Hermes. |
hermes acp |
Agent Client Protocol stdio-server för redigerare (extra installation kan gälla). |
hermes dashboard [--port …] [--host …] |
Lokal webbdashboard (pip install hermes-agent[web]). |
hermes claw migrate … |
Migrera OpenClaw-stilade konfigurationer in i Hermes (--dry-run, förinställningar, valbara hemligheter). |
OpenClaw-migrering — hermes claw migrate läser legacy OpenClaw-hemkataloger; för hur den stacken såg ut innan flytten, se OpenClaw fallstudie.
Slash-kommandon i Hermes CLI-sessionen
Skriv / för autokomplettering. Kommandon är storlek-känsliga; färdigheter registrerar extra /skill-name-rutter. Tabellerna nedan är ett kuraterat underavsnitt; för hela registret se Officiell Hermes Agent-dokumentation i slutet av denna artikel.
Sessionsflöde, bakgrundsuppgifter och mål
| Kommando | Beskrivning |
|---|---|
/new, /reset |
Ny session-ID och historik. |
/resume [name] |
Återuppta en namngiven session. |
/compress [focus] |
Manuell kontextkompression med valbart fokustäm. |
/retry, /undo |
Försök senaste tur eller kasta senaste utbyte. |
/title … |
Namnge sessionen för senare /resume. |
/background …, /queue …, /steer … |
Parallell bakgrundskörning, köad nästa prompt, mid-loop nudge efter nästa verktyg. |
/goal … |
Persistenta multi-turn-mål med domarloop (status, pause, resume, clear). |
/branch, /fork |
Grena konversationen för alternativ utforskning. |
Modeller, verktygstogglar, färdigheter och omladdning
| Kommando | Beskrivning |
|---|---|
/model … [--global] |
Byt modeller mellan konfigurerade leverantörer; --global persistar standard. |
/tools …, /toolsets |
Sessionverktygstogglar och verktygsuppsättningslista. |
/skills … |
Sök, installera och hantera färdigheter från chatten. |
/cron … |
Schemalägningsuppgifts UI från CLI-sessionen. |
/reload-mcp |
Omladda MCP-servrar från konfiguration. |
/reload |
Omladda .env i den körande sessionen utan omstart. |
Användning, hjälp och avslut
| Kommando | Beskrivning |
|---|---|
/usage, /insights |
Token- och kostnadssynlighet; analysnapshot. |
/help, /quit |
Hjälp eller avsluta CLI. |
Meddelandeappar (Telegram, Discord, Slack och andra) exponerar ett överlappande slash-set plus /approve, /restart, /commands, och relaterade gateway-endast-hjälpmedel — plattforms skillnader dokumenteras i slash-kommandoreferensen under Officiell Hermes Agent-dokumentation nedan.
Mer användbar läsning
Relaterade sidor på denna webbplats (bredare kontext för Hermes och terminalagenter):
- AI System — Self-Hosted Assistenter, RAG och Lokal Infrastruktur — översikt över klustret och hur assistenter passar in i stacken
- AI System Minne — minnescentral och intilliggande guider
- AI Utvecklarverktyg — terminal- och IDE-verktygslandskap
- OpenCode Snabbstart — en annan terminal-först-agent för ergonomisk jämförelse
Officiell Hermes Agent-dokumentation
Upstream-dokumentation på hermes-agent.nousresearch.com:
Tips. Håll hermes dump och hermes doctor --fix i muskellminnet — de förvagar vaga “något slog sönder”-rapporter till agerbara diffs mot en känd bra konfiguration.