Snabbguide för Hermes Agent CLI — kommandon, flaggor och snittkommandon

Hermes Agent från Nous Research är en modellagnostisk, verkstugsanvändande assistent som du kör lokalt eller på en VPS.

Hermes låser inte fast dig i ett enda gränssnitt. Du kan använda

• den klassiska hermes / hermes chat kommandoradsgränssnittet (CLI),
• den fullskärmsbaserade hermes --tui sessionen,
• en långkörd hermes gateway för Telegram, Discord, Slack och andra meddelandepattformar,
• hermes dashboard för ett lokalt webbläsargränssnitt när webbtillägget är installerat.

Dessa vägar delar samma konfiguration och data under ~/.hermes; denna sida listar kommandoradsinstruktioner som är viktiga över dessa lägen.

Nedan följer en tätsam kommandoreferens grupperad efter uppgift.

Installera Hermes Agent och första CLI-kommandon

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-körbara filen. Efter source ~/.bashrc eller ~/.zshrc, är din standardingångspunkt för interaktiv chatt helt enkelt hermes (samma familj som hermes chat).

Kommando	Beskrivning
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash	Officiell enkelrad-installation (Linux, macOS, WSL2).
hermes / hermes chat	Starta interaktiv chatt efter installation (standard daglig ingång).
hermes --version / hermes version	Visa versionsinformation.
hermes completion bash | zsh | fish	Generera skript för tabbifullständning i shell.
hermes update [--check] [--backup] [--restart-gateway]	Hämta senaste koden, återinstallera beroenden, valfri förhandsbackup av hemmappen eller gateway-omstart.
hermes uninstall [--full] [--yes]	Avinstallera Hermes; valfri fullständig radering av data.

Inbyggt Windows stöds inte; använd WSL2. Android-installationer via Termux följer en separat väg i upströmsdokumentationen.

Globala flaggor för varje hermes-anrop

Dessa flaggor tillämpas före underkommandon och ändrar vilken profil, vilken session, eller hur mycket personlig konfiguration som laddas.

Flagga	Beskrivning
--profile, -p	Välj Hermes-profil för denna körning (återskriver fast standard från hermes profile use).
--resume, -r	Återuppta en session efter ID eller titel.
--continue [name], -c	Fortsätt den senaste sessionen, eller den senaste som matchar en titel.
--worktree, -w	Starta i ett isolerat Git-arbesträd för parallella agenter.
--yolo	Kringgå godkännandeprompter för farliga kommandon (använd med omsorg).
--pass-session-id	Inkludera sessions-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örinladdade färdigheter.
--tui	Starta TUI (ekvivalent med HERMES_TUI=1).
--dev	Med --tui, kör TS-källkoder via tsx för TUI-utveckling.

Isolerad automation parar ofta ihop hermes chat --ignore-user-config --ignore-rules med hermes -z för reproducerbara engångskörningar.

hermes chat, engångsprompter och hermes -z

Kommando / mönster	Beskrivning
hermes chat	Interaktiv eller skriptad chatt; huvudytan för -q, -m, --provider, verktygsuppsättningar, återupptagning, arbeträd, kontrollpunkter.
hermes chat -q "..."	Engångsprompt (icke-interaktiv); behåller rikare output än -z när verktyg körs.
hermes -z "..."	Skriptad engångskörning — endast slutgiltigt svar på stdout, inget banner eller sessionbrus. Samma agent och verktyg; bäst för rör och skript.
hermes chat --quiet, -Q	Tystare programmatiskt läge (banner och verktygsförhandsvisningar undertryckta).
-m / --model, --provider	Modell- och leverantörsåterskrivningar per körning; miljövariablerna HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER speglar beteendet.
-t / --toolsets	Aktivera kommaseparerade verktygsuppsättningar för körningen.
-s / --skills	Förinladda färdigheter (upprepa eller kommaseparerade).
--image path	Bifoga en lokal bild till en enkel fråga.
--checkpoints	Aktivera filsystemkontrollpunkter före destruktiva ändringar.
--max-turns N	Begränsa verktygsanropstillfällen per tur (standard från konfiguration).
--source	Sessionskälltagg (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. Snutt /model växlar bara mellan redan konfigurerade leverantörer. Om du bara ser OpenRouter i /model, avsluta sessionen och slutför hermes model.

Modellväljare, behörighetspooler och fallback-leverantörer

Kommando	Beskrivning
hermes model	Interaktiv leverantörs- och modellväljare; nycklar, OAuth, anpassade ändpunkter.
hermes auth	Behörighetspooler — add, list, remove, reset för rotationsvänliga nycklar och OAuth.
hermes fallback [list | add | remove | clear]	Hantera sorterade fallback-leverantörer när primären misslyckas eller hastighetsbegränsas.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Avsnittsvis eller full interaktiv inställning (--quick, --reset, --non-interactive).

Utfasede hermes login / hermes logout — använd hermes auth och hermes model istället.

Att välja lokala OpenAI-kompatibla ändpunkter mot hostade API:er för hermes model balanseras på samma sätt som allmän LLM-hostning (latens, kostnad, drift).

Konfigurationsfiler och hermes config-kommandon

Konfiguration löses som CLI-återskrivningar → config.yaml → .env → standardvärden. API-nycklar hör hemma i .env; strukturerade inställningar i config.yaml.

Kommando	Beskrivning
hermes config show	Visa gällande konfiguration.
hermes config edit	Öppna config.yaml i $EDITOR.
hermes config set key value	Sätt värden (hemligheter ruttas till .env, övriga till YAML).
hermes config path / hermes config env-path	Skriv ut sökvägar till konfigurations- och miljö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.

Sessionshantering och hermes profile

Kommando	Beskrivning
hermes sessions list	Lista senaste sessioner.
hermes sessions browse	Interaktiv väljare med sökning och återupptagning.
hermes sessions export	Exportera sessioner (t.ex. JSONL).
hermes sessions delete, prune, rename, stats	Ta bort en session, klipp bort gamla, byt namn på 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 profil-tarball.
hermes profile alias	Korta wrapper-skript för snabb profilväxling.

Använd hermes -p work chat -q "..." för ad hoc-körningar utan att ändra den fasta standardprofilen.

Färdighetshub, verktygsuppsättningar, shell-krokar och plugin

För profil-först-konfiguration och färdigheter anpassade för verkliga produktionsarbetsflöden efter roll, se Hermes AI-assistentfärdigheter för verkliga produktionsmiljöer.

Kommando	Beskrivning
hermes tools	Interaktiv plattformsspecifik verktygsaktivering; --summary skriver ut aktuella val.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config	Färdighetshubbarbetsflöden inklusive register och URL-installationer.
hermes curator status, run, pause, pin, rollback, …	Bakgrundsfärdighetsunderhåll och säker rollback.
hermes hooks list, test, revoke, doctor	Deklarerade shell-krokar och tillåtna listor i konfiguration.
hermes plugins	Kompositt UI eller underkommandon för att installera, aktivera, inaktivera, ta bort plugin.

Inbyggt minne och hermes memory-leverantörer

Inbyggt MEMORY.md / USER.md förblir aktivt; externa leverantörer lägger till valfria minneshanteringslager. För hur denna arkitektur beter sig i praktiken, läs Hermes Agent-minnesystem — Hur persistent AI-minne faktiskt fungerar. För att jämföra externa bakändar och aktiveringsavvägningar, se Agentminnesleverantörer jämförda — Honcho, Mem0, Hindsight och fem till.

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örsspecifika toppnivåunderkommandon — kör hermes --help för att se vad som är kopplat idag.

Meddelandegateway, DM-parning och plattformar

Kommando	Beskrivning
hermes gateway setup	Interaktiv inställning av meddelandepattform.
hermes gateway run	Förgrundsgateway (rekommenderas på WSL, Docker, Termux).
hermes gateway start | stop | restart | status	systemd / launchd tjänstkontroll (--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 meddelandebotar.
hermes whatsapp	WhatsApp-bryggparningsflöde.
hermes slack manifest	Generera Slack-appmanifest med gateway-snutt-jämlikhet.

På WSL, är hermes gateway run inuti tmux det resilenta mönstret när gateway start beter sig felaktigt.

Cron-scheduler, webhooks och Kanban

Kommando	Beskrivning
hermes cron …	Skapa, redigera, pausa, återuppta, köra, ta bort schemalagda prompter (tick för manuell schedulerpass).
hermes webhook subscribe, list, remove, test	Dynamiska webhook-rutter för händelsestyrda körningar.
hermes kanban …	Multi-profil uppgiftsbräda backad av SQLite; dispatch driver workers.

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 vid behov.
hermes dump [--show-keys]	Klistvänlig installations sammanfattning för Discord eller GitHub-ärenden.
hermes debug share	Ladda upp redigerad felsökningsbundle till en paste-tjänst (eller --local).
hermes logs [agent | errors | gateway | list]	Taila och filtrera loggar under profilens loggkatalog.
hermes backup, hermes import	Zip-snapshots av hemdata och återställningsvägar.
hermes insights [--days N] [--source …]	Token-, kostnads- och aktivitetsanalyser.

När något kraschar efter en uppgradering, bildar hermes doctor, hermes status, och hermes logs errors -f den snabbaste triagemcykeln.

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-liknande konfigurationer till Hermes (--dry-run, förinställningar, valfria hemligheter).

OpenClaw-migrering — hermes claw migrate läser äldre OpenClaw-hemmappar; för hur den stacken såg ut innan flytten, se OpenClaw fallstudie.

Snuttkommandon i Hermes CLI-sessionen

Skriv / för automatisk fullständighet. Kommandon är skiftlägesokänsliga; färdigheter registrerar extra /skill-name-rutter. Tabellerna nedan är ett kuraterat urval; 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 sessions-ID och historik.
/resume [name]	Återuppta en namngiven session.
/compress [focus]	Manuell kontextkomprimering med valfritt fokusämne.
/retry, /undo	Försök senaste tur igen eller ta bort senaste utbyte.
/title …	Namnge sessionen för senare /resume.
/background …, /queue …, /steer …	Parallell bakgrundskörning, köad nästa prompt, mid-loop-påhopp efter nästa verktyg.
/goal …	Persistent multi-turn-mål med domarloop (status, pause, resume, clear).
/branch, /fork	Grena conversationen för alternativ utforskning.

Modeller, verktygstoggles, färdigheter och omladdning

Kommando	Beskrivning
/model … [--global]	Växla modeller mellan konfigurerade leverantörer; --global består standard.
/tools …, /toolsets	Sessionsverktygstoggles och verktygsuppsättningslista.
/skills …	Sök, installera och hantera färdigheter från chatten.
/cron …	Schemalagd uppgiftsgränssnitt 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 kostnadsöverskåtlighet; analysnapshot.
/help, /quit	Hjälp eller avsluta CLI.

Meddelandeappar (Telegram, Discord, Slack och andra) exponerar ett överlappande snuttset plus /approve, /restart, /commands, och relaterade gateway-ensamma hjälpmedel — plattforms skillnader är dokumenterade i snuttkommandoreferensen 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 — Självhostade assistenter, RAG och lokal infrastruktur — klusteröversikt och hur assistenter passar in i stacken
• AI-systemminne — minneshub och angränsande guider
• AI-utvecklarverktyg — terminal- och IDE-verktygslandskap
• OpenCode Snabbstart — en annan terminalförst-agent för ergonomisk jämförelse

Officiell Hermes Agent-dokumentation

Upströmsdokumentation på hermes-agent.nousresearch.com:

• Hermes Agent
• CLI-kommandoreferens
• Snuttkommandoreferens

---

Tips. Håll hermes dump och hermes doctor --fix i muskeltminnet — de förvandlar vaga “något kraschade”-rapporter till handlingsbara diffar mot en känd god konfiguration.