Hermes Agent CLI-antatt: Kommandon, flaggor och snedstrecks-genvägar

Skal- och TUI-kommandon för självhostad Hermes-agent.

Sidinnehåll

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 chat CLI:n,
  • den fullskärms hermes --tui-sessionen,
  • en långkörd hermes gateway för Telegram, Discord, Slack och andra plattformar för meddelanden,
  • hermes dashboard fö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.

Hermes Agent CLI-fuskort — terminalreferens

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.

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-migreringhermes 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):

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.

Prenumerera

Få nya inlägg om system, infrastruktur och AI-ingenjörskonst.