- generic - region "Skip to main content" [ref=e1] - link "Skip to main content" [ref=e3] - navigation "Main" [ref=e2] - link "Hermes Agent Hermes Agent" [ref=e4] - image "Hermes Agent" - StaticText "Hermes Agent" - link "Docs" [ref=e5] - link "Skills" [ref=e6] - link "Download (opens in new tab)" [ref=e7] - StaticText "Download" - image "(opens in new tab)" - generic - button "English" [expanded=false, ref=e12] - StaticText "English" - link "Home (opens in new tab)" [ref=e8] - StaticText "Home" - image "(opens in new tab)" - link "GitHub (opens in new tab)" [ref=e9] - StaticText "GitHub" - image "(opens in new tab)" - link "Discord (opens in new tab)" [ref=e10] - StaticText "Discord" - image "(opens in new tab)" - button "Switch between dark and light mode (currently system mode)" [ref=e11] - generic - textbox "Search" [ref=e13] - generic - StaticText "ctrl" - StaticText "K" - complementary - navigation "Docs sidebar" [ref=e16] - list - listitem [level=1] - link "User Stories & Use Cases" [ref=e1318] - StaticText "User Stories & Use Cases" - listitem [level=1] - button "Getting Started" [expanded=false, ref=e1451] - StaticText "Getting Started" - listitem [level=1] - button "Using Hermes" [expanded=false, ref=e1452] - StaticText "Using Hermes" - listitem [level=1] - button "Features" [expanded=false, ref=e1453] - StaticText "Features" - listitem [level=1] - button "Messaging Platforms" [expanded=false, ref=e1454] - StaticText "Messaging Platforms" - listitem [level=1] - button "Integrations" [expanded=false, ref=e1455] - StaticText "Integrations" - listitem [level=1] - button "Guides & Tutorials" [expanded=false, ref=e1456] - StaticText "Guides & Tutorials" - listitem [level=1] - button "Developer Guide" [expanded=false, ref=e1457] - StaticText "Developer Guide" - listitem [level=1] - button "Reference" [expanded=true, ref=e1458] - StaticText "Reference" - list - listitem [level=2] - button "Command Reference" [expanded=true, ref=e1483] - StaticText "Command Reference" - list - listitem [level=3] - link "CLI Commands Reference" [ref=e1486] - listitem [level=3] - link "Slash Commands Reference" [ref=e1487] - listitem [level=3] - link "Profile Commands Reference" [ref=e1488] - listitem [level=2] - button "Configuration Reference" [expanded=false, ref=e1484] - listitem [level=2] - button "Tools & Skills Reference" [expanded=false, ref=e1485] - listitem [level=2] - link "FAQ & Troubleshooting" [ref=e1482] - button "Collapse sidebar" [ref=e17] - main - article - navigation "Breadcrumbs" [ref=e18] - list - listitem [level=1] - link "Home page" [ref=e1319] - StaticText " " - listitem [level=1] - StaticText "Reference" - StaticText " " - listitem [level=1] - StaticText "Command Reference" - StaticText " " - listitem [level=1] - StaticText "CLI Commands Reference" - sectionheader - heading "CLI Commands Reference" [level=1, ref=e112] - paragraph - StaticText "This page covers the " - strong - StaticText "terminal commands" - StaticText " you run from your shell." - paragraph - StaticText "For in-chat slash commands, see " - link "Slash Commands Reference" [ref=e113] - StaticText "." - heading "Global entrypoint Direct link to Global entrypoint" [level=2, ref=e19] - StaticText "Global entrypoint" - link "Direct link to Global entrypoint" [ref=e114] - StaticText "#" - generic - generic [ref=e115] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e310] - heading "Global options Direct link to Global options" [level=3, ref=e20] - StaticText "Global options" - link "Direct link to Global options" [ref=e116] - StaticText "#" - table - rowgroup - row - columnheader "Option" [ref=e1320] - columnheader "Description" [ref=e1321] - row - cell "--version, -V" [ref=e311] - code - StaticText ", " - code - cell "Show version and exit." [ref=e312] - row - cell "--profile , -p " [ref=e313] - code - StaticText ", " - code - cell "Select which Hermes profile to use for this invocation. Overrides the sticky default set by hermes profile use." [ref=e314] - StaticText "Select which Hermes profile to use for this invocation. Overrides the sticky default set by " - code - StaticText "." - row - cell "--resume , -r " [ref=e315] - code - StaticText ", " - code - cell "Resume a previous session by ID or title." [ref=e316] - row - cell "--continue [name], -c [name]" [ref=e317] - code - StaticText ", " - code - cell "Resume the most recent session, or the most recent session matching a title." [ref=e318] - row - cell "--worktree, -w" [ref=e319] - code - StaticText ", " - code - cell "Start in an isolated git worktree for parallel-agent workflows." [ref=e320] - row - cell "--yolo" [ref=e321] - code - cell "Bypass dangerous-command approval prompts." [ref=e322] - row - cell "--pass-session-id" [ref=e323] - code - cell "Include the session ID in the agent's system prompt." [ref=e324] - row - cell "--ignore-user-config" [ref=e325] - code - cell "Ignore ~/.hermes/config.yaml and fall back to built-in defaults. Credentials in .env are still loaded." [ref=e326] - StaticText "Ignore " - code - StaticText " and fall back to built-in defaults. Credentials in " - code - StaticText " are still loaded." - row - cell "--ignore-rules" [ref=e327] - code - cell "Skip auto-injection of AGENTS.md, SOUL.md, .cursorrules, memory, and preloaded skills." [ref=e328] - StaticText "Skip auto-injection of " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", memory, and preloaded skills." - row - cell "--tui" [ref=e329] - code - cell "Launch the TUI instead of the classic CLI. Equivalent to HERMES_TUI=1. Always wins over display.interface." [ref=e330] - StaticText "Launch the " - link "TUI" [ref=e1322] - StaticText " instead of the classic CLI. Equivalent to " - code - StaticText ". Always wins over " - code - StaticText "." - row - cell "--cli" [ref=e331] - code - cell "Force the classic prompt_toolkit REPL. Use this to override display.interface: tui for a single invocation." [ref=e332] - StaticText "Force the classic prompt_toolkit REPL. Use this to override " - code - StaticText "display.interface: tui" - StaticText " for a single invocation." - row - cell "--dev" [ref=e333] - code - cell "With --tui: run the TypeScript sources directly via tsx instead of the prebuilt bundle (for TUI contributors)." [ref=e334] - StaticText "With " - code - StaticText ": run the TypeScript sources directly via " - code - StaticText " instead of the prebuilt bundle (for TUI contributors)." - heading "Top-level commands Direct link to Top-level commands" [level=2, ref=e21] - StaticText "Top-level commands" - link "Direct link to Top-level commands" [ref=e117] - StaticText "#" - table - rowgroup - row - columnheader "Command" [ref=e1323] - columnheader "Purpose" [ref=e1324] - row - cell "hermes chat" [ref=e335] - code - cell "Interactive or one-shot chat with the agent." [ref=e336] - row - cell "hermes model" [ref=e337] - code - cell "Interactively choose the default provider and model." [ref=e338] - row - cell "hermes moa" [ref=e339] - code - cell "Configure named Mixture of Agents presets selectable from the model picker." [ref=e340] - row - cell "hermes fallback" [ref=e341] - code - cell "Manage fallback providers tried when the primary model errors." [ref=e342] - row - cell "hermes gateway" [ref=e343] - code - cell "Run or manage the messaging gateway service." [ref=e344] - row - cell "hermes proxy" [ref=e345] - code - cell "Local OpenAI-compatible proxy that attaches OAuth provider credentials. See Subscription Proxy." [ref=e346] - StaticText "Local OpenAI-compatible proxy that attaches OAuth provider credentials. See " - link "Subscription Proxy" [ref=e1325] - StaticText "." - row - cell "hermes egress" [ref=e347] - code - cell "Outbound credential-injection firewall for remote terminal sandboxes (iron-proxy). Disabled by default. See Egress proxy." [ref=e348] - StaticText "Outbound credential-injection firewall for remote terminal sandboxes (iron-proxy). Disabled by default. See " - link "Egress proxy" [ref=e1326] - StaticText "." - row - cell "hermes lsp" [ref=e349] - code - cell "Manage Language Server Protocol integration (semantic diagnostics for write_file/patch)." [ref=e350] - row - cell "hermes setup" [ref=e351] - code - cell "Interactive setup wizard for all or part of the configuration." [ref=e352] - row - cell "hermes whatsapp" [ref=e353] - code - cell "Configure and pair the WhatsApp bridge." [ref=e354] - row - cell "hermes whatsapp-cloud" [ref=e355] - code - cell "Configure the official Meta WhatsApp Business Cloud API adapter (Business account + public webhook required). Distinct from hermes whatsapp (Baileys personal-account bridge)." [ref=e356] - StaticText "Configure the official Meta WhatsApp Business Cloud API adapter (Business account + public webhook required). Distinct from " - code - StaticText " (Baileys personal-account bridge)." - row - cell "hermes slack" [ref=e357] - code - cell "Slack helpers (currently: generate the app manifest with every command as a native slash)." [ref=e358] - row - cell "hermes auth" [ref=e359] - code - cell "Manage credentials — add, list, remove, reset, status, logout. Handles OAuth flows for Codex/Nous/Anthropic." [ref=e360] - row - cell "hermes login / logout" [ref=e361] - code - StaticText " / " - code - cell "Deprecated — use hermes auth instead." [ref=e362] - strong - StaticText " — use " - code - StaticText " instead." - row - cell "hermes send" [ref=e363] - code - cell "Send a one-shot message to a configured messaging platform (Telegram, Discord, Slack, Signal, SMS, …). Useful from shell scripts, cron jobs, CI hooks, and monitoring daemons — no agent loop, no LLM." [ref=e364] - row - cell "hermes secrets" [ref=e365] - code - cell "Manage external secret sources (currently Bitwarden Secrets Manager) for pulling API keys at process startup instead of from ~/.hermes/.env." [ref=e366] - StaticText "Manage external secret sources (currently Bitwarden Secrets Manager) for pulling API keys at process startup instead of from " - code - StaticText "." - row - cell "hermes migrate" [ref=e367] - code - cell "Diagnose and (optionally) rewrite config.yaml to replace references to retired models or deprecated settings (e.g. migrate xai)." [ref=e368] - StaticText "Diagnose and (optionally) rewrite " - code - StaticText " to replace references to retired models or deprecated settings (e.g. " - code - StaticText ")." - row - cell "hermes status" [ref=e369] - code - cell "Show agent, auth, and platform status." [ref=e370] - row - cell "hermes cron" [ref=e371] - code - cell "Inspect and tick the cron scheduler." [ref=e372] - row - cell "hermes kanban" [ref=e373] - code - cell "Multi-profile collaboration board (tasks, links, dispatcher)." [ref=e374] - row - cell "hermes project" [ref=e375] - code - cell "Manage named, multi-folder workspaces (projects). Anchors desktop session grouping and, when bound to a kanban board, gives tasks a deterministic worktree + branch convention. State is per-profile." [ref=e376] - row - cell "hermes webhook" [ref=e377] - code - cell "Manage dynamic webhook subscriptions for event-driven activation." [ref=e378] - row - cell "hermes hooks" [ref=e379] - code - cell "Inspect, approve, or remove shell-script hooks declared in config.yaml." [ref=e380] - StaticText "Inspect, approve, or remove shell-script hooks declared in " - code - StaticText "." - row - cell "hermes doctor" [ref=e381] - code - cell "Diagnose config and dependency issues." [ref=e382] - row - cell "hermes security audit" [ref=e383] - code - cell "On-demand supply-chain audit (OSV.dev) for the venv, plugin requirements, and pinned MCP servers." [ref=e384] - row - cell "hermes approvals" [ref=e385] - code - cell "Approval-prompt tools — mine approval history into allowlist proposals." [ref=e386] - row - cell "hermes dump" [ref=e387] - code - cell "Copy-pasteable setup summary for support/debugging." [ref=e388] - row - cell "hermes prompt-size" [ref=e389] - code - cell "Show a byte breakdown of the system prompt + tool schemas (skills index, memory, profile). Runs offline." [ref=e390] - row - cell "hermes debug" [ref=e391] - code - cell "Debug tools — upload logs and system info for support." [ref=e392] - row - cell "hermes backup" [ref=e393] - code - cell "Back up Hermes home directory to a zip file." [ref=e394] - row - cell "hermes checkpoints" [ref=e395] - code - cell "Inspect / prune / clear ~/.hermes/checkpoints/ (the shadow store used by /rollback). Run with no args for a status overview." [ref=e396] - StaticText "Inspect / prune / clear " - code - StaticText " (the shadow store used by " - code - StaticText "). Run with no args for a status overview." - row - cell "hermes import" [ref=e397] - code - cell "Restore a Hermes backup from a zip file." [ref=e398] - row - cell "hermes logs" [ref=e399] - code - cell "View, tail, and filter agent/gateway/error log files." [ref=e400] - row - cell "hermes config" [ref=e401] - code - cell "Show, edit, migrate, and query configuration files." [ref=e402] - row - cell "hermes skin" [ref=e403] - code - cell "List, switch, and tweak display skins." [ref=e404] - row - cell "hermes console" [ref=e405] - code - cell "Open the safe Hermes command console." [ref=e406] - row - cell "hermes pairing" [ref=e407] - code - cell "Approve or revoke messaging pairing codes." [ref=e408] - row - cell "hermes skills" [ref=e409] - code - cell "Browse, install, publish, audit, and configure skills." [ref=e410] - row - cell "hermes bundles" [ref=e411] - code - cell "Group several skills under a single / slash command. See Skill Bundles." [ref=e412] - StaticText "Group several skills under a single " - code - StaticText " slash command. See " - link "Skill Bundles" [ref=e1327] - StaticText "." - row - cell "hermes curator" [ref=e413] - code - cell "Background skill maintenance — status, run, pause, pin. See Curator." [ref=e414] - StaticText "Background skill maintenance — status, run, pause, pin. See " - link "Curator" [ref=e1328] - StaticText "." - row - cell "hermes journey (aliases learning, memory-graph)" [ref=e415] - code - StaticText " (aliases " - code - StaticText ", " - code - StaticText ")" - cell "Timeline of learned skills + memories over time." [ref=e416] - row - cell "hermes memory" [ref=e417] - code - cell "Configure external memory provider. Plugin-specific subcommands (e.g. hermes honcho) register automatically when their provider is active." [ref=e418] - StaticText "Configure external memory provider. Plugin-specific subcommands (e.g. " - code - StaticText ") register automatically when their provider is active." - row - cell "hermes acp" [ref=e419] - code - cell "Run Hermes as an ACP server for editor integration." [ref=e420] - row - cell "hermes mcp" [ref=e421] - code - cell "Manage MCP server configurations and run Hermes as an MCP server." [ref=e422] - row - cell "hermes plugins" [ref=e423] - code - cell "Manage Hermes Agent plugins (install, enable, disable, remove)." [ref=e424] - row - cell "hermes portal" [ref=e425] - code - cell "Nous Portal status, subscription link, and Tool Gateway routing. See Tool Gateway." [ref=e426] - StaticText "Nous Portal status, subscription link, and Tool Gateway routing. See " - link "Tool Gateway" [ref=e1329] - StaticText "." - row - cell "hermes tools" [ref=e427] - code - cell "Configure enabled tools per platform." [ref=e428] - row - cell "hermes computer-use" [ref=e429] - code - cell "Install or check the Computer Use (cua-driver) backend (macOS/Windows/Linux)." [ref=e430] - row - cell "hermes pets" [ref=e431] - code - cell "Browse, install, and select petdex animated pets shown across the CLI, TUI, and desktop app. Subcommands: list, install, select, show, off, scale, remove, doctor." [ref=e432] - StaticText "Browse, install, and select " - link "petdex" [ref=e1330] - StaticText " animated pets shown across the CLI, TUI, and desktop app. Subcommands: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "hermes sessions" [ref=e433] - code - cell "Browse, export, prune, rename, and delete sessions." [ref=e434] - row - cell "hermes insights" [ref=e435] - code - cell "Show token/cost/activity analytics." [ref=e436] - row - cell "hermes claw" [ref=e437] - code - cell "OpenClaw migration helpers." [ref=e438] - row - cell "hermes import-agent" [ref=e439] - code - cell "Import a Claude Code (~/.claude) or Codex CLI (~/.codex) setup." [ref=e440] - StaticText "Import a Claude Code (" - code - StaticText ") or Codex CLI (" - code - StaticText ") setup." - row - cell "hermes dashboard" [ref=e441] - code - cell "Launch the web dashboard for managing config, API keys, and sessions." [ref=e442] - row - cell "hermes serve" [ref=e443] - code - cell "Start the Hermes backend server (headless; powers the desktop app and remote backends)." [ref=e444] - row - cell "hermes desktop (alias gui)" [ref=e445] - code - StaticText " (alias " - code - StaticText ")" - cell "Build and launch the native Electron desktop app." [ref=e446] - row - cell "hermes profile" [ref=e447] - code - cell "Manage profiles — multiple isolated Hermes instances." [ref=e448] - row - cell "hermes completion" [ref=e449] - code - cell "Print shell completion scripts (bash/zsh/fish)." [ref=e450] - row - cell "hermes version" [ref=e451] - code - cell "Show version information." [ref=e452] - row - cell "hermes update" [ref=e453] - code - cell "Pull latest code and reinstall dependencies. --check previews without installing; --backup takes a pre-pull HERMES_HOME snapshot." [ref=e454] - StaticText "Pull latest code and reinstall dependencies. " - code - StaticText " previews without installing; " - code - StaticText " takes a pre-pull " - code - StaticText " snapshot." - row - cell "hermes uninstall" [ref=e455] - code - cell "Remove Hermes from the system." [ref=e456] - heading "hermes chat Direct link to hermes-chat" [level=2, ref=e22] - code - StaticText "hermes chat" - link "Direct link to hermes-chat" [ref=e118] - StaticText "#" - generic - generic [ref=e119] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e457] - paragraph - StaticText "Common options:" - table - rowgroup - row - columnheader "Option" [ref=e1331] - columnheader "Description" [ref=e1332] - row - cell "-q, --query \"...\"" [ref=e458] - code - StaticText ", " - code - cell "One-shot, non-interactive prompt." [ref=e459] - row - cell "-m, --model " [ref=e460] - code - StaticText ", " - code - cell "Override the model for this run." [ref=e461] - row - cell "-t, --toolsets " [ref=e462] - code - StaticText ", " - code - cell "Enable a comma-separated set of toolsets." [ref=e463] - row - cell "--provider " [ref=e464] - code - cell "Force a provider: auto, openrouter, nous, openai-codex, copilot-acp, copilot, anthropic, gemini, huggingface, novita (aliases novita-ai, novitaai), openai-api, zai, kimi-coding, kimi-coding-cn, minimax, minimax-cn, minimax-oauth, kilocode, xiaomi, arcee, gmi, upstage (alias solar), alibaba, alibaba-coding-plan (alias alibaba_coding), deepseek, nvidia, ollama-cloud, xai (alias grok), " [ref=e465] - StaticText "Force a provider: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (aliases " - code - StaticText ", " - code - StaticText "), " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (alias " - code - StaticText "), " - code - StaticText ", " - code - StaticText " (alias " - code - StaticText "), " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (alias " - code - StaticText "), " - code - StaticText " (alias " - code - StaticText "), " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (alias " - code - StaticText ", " - code - StaticText ")." - row - cell "-s, --skills " [ref=e466] - code - StaticText ", " - code - cell "Preload one or more skills for the session (can be repeated or comma-separated)." [ref=e467] - row - cell "-v, --verbose" [ref=e468] - code - StaticText ", " - code - cell "Verbose output." [ref=e469] - row - cell "-Q, --quiet" [ref=e470] - code - StaticText ", " - code - cell "Programmatic mode: suppress banner/spinner/tool previews." [ref=e471] - row - cell "--image " [ref=e472] - code - cell "Attach a local image to a single query." [ref=e473] - row - cell "--resume / --continue [name]" [ref=e474] - code - StaticText " / " - code - cell "Resume a session directly from chat." [ref=e475] - StaticText "Resume a session directly from " - code - StaticText "." - row - cell "--worktree" [ref=e476] - code - cell "Create an isolated git worktree for this run." [ref=e477] - row - cell "--checkpoints" [ref=e478] - code - cell "Enable filesystem checkpoints before destructive file changes." [ref=e479] - row - cell "--yolo" [ref=e480] - code - cell "Skip approval prompts." [ref=e481] - row - cell "--pass-session-id" [ref=e482] - code - cell "Pass the session ID into the system prompt." [ref=e483] - row - cell "--ignore-user-config" [ref=e484] - code - cell "Ignore ~/.hermes/config.yaml and use built-in defaults. Credentials in .env are still loaded. Useful for isolated CI runs, reproducible bug reports, and third-party integrations." [ref=e485] - StaticText "Ignore " - code - StaticText " and use built-in defaults. Credentials in " - code - StaticText " are still loaded. Useful for isolated CI runs, reproducible bug reports, and third-party integrations." - row - cell "--ignore-rules" [ref=e486] - code - cell "Skip auto-injection of AGENTS.md, SOUL.md, .cursorrules, persistent memory, and preloaded skills. Combine with --ignore-user-config for a fully isolated run." [ref=e487] - StaticText "Skip auto-injection of " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", persistent memory, and preloaded skills. Combine with " - code - StaticText " for a fully isolated run." - row - cell "--safe-mode" [ref=e488] - code - cell "Troubleshooting mode: disable ALL customizations — user config, rules/memory injection, plugins, shell hooks, and MCP servers (implies --ignore-user-config and --ignore-rules). Use to isolate whether a problem comes from your setup or from Hermes itself." [ref=e489] - StaticText "Troubleshooting mode: disable ALL customizations — user config, rules/memory injection, plugins, shell hooks, and MCP servers (implies " - code - StaticText " and " - code - StaticText "). Use to isolate whether a problem comes from your setup or from Hermes itself." - row - cell "--source " [ref=e490] - code - cell "Session source tag for filtering (default: cli). Use tool for third-party integrations that should not appear in user session lists." [ref=e491] - StaticText "Session source tag for filtering (default: " - code - StaticText "). Use " - code - StaticText " for third-party integrations that should not appear in user session lists." - row - cell "--max-turns " [ref=e492] - code - cell "Maximum tool-calling iterations per conversation turn (default: 500, or agent.max_turns in config)." [ref=e493] - StaticText "Maximum tool-calling iterations per conversation turn (default: 500, or " - code - StaticText " in config)." - paragraph - StaticText "Examples:" - generic - generic [ref=e120] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e494] - button "Copy code to clipboard" [ref=e495] - heading "hermes -z — scripted one-shot Direct link to hermes--z-prompt--scripted-one-shot" [level=3, ref=e23] - code - StaticText "hermes -z " - StaticText " — scripted one-shot" - link "Direct link to hermes--z-prompt--scripted-one-shot" [ref=e121] - StaticText "#" - paragraph - StaticText "For programmatic callers (shell scripts, CI, cron, parent processes piping in a prompt), " - code - StaticText "hermes -z" - StaticText " is the purest one-shot entry point: " - strong - StaticText "single prompt in, final response text out, nothing else on stdout or stderr." - StaticText " No banner, no spinner, no tool previews, no " - code - StaticText "Session:" - StaticText " line — just the agent's final reply as plain text." - generic - generic [ref=e122] focusable [tabindex] - code - generic - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e496] - paragraph - StaticText "Per-run overrides (no mutation to " - code - StaticText "~/.hermes/config.yaml" - StaticText "):" - table - rowgroup - row - columnheader "Flag" [ref=e1333] - columnheader "Equivalent env var" [ref=e1334] - columnheader "Purpose" [ref=e1335] - row - cell "-m / --model " [ref=e497] - code - StaticText " / " - code - cell "HERMES_INFERENCE_MODEL" [ref=e498] - code - cell "Override the model for this run" [ref=e499] - row - cell "--provider " [ref=e500] - code - cell "(none)" [ref=e501] - emphasis - cell "Override the provider for this run" [ref=e502] - row - cell "--usage-file " [ref=e503] - code - cell "(none)" [ref=e504] - emphasis - cell "Write a JSON usage report after the run (see below)" [ref=e505] - generic - generic [ref=e123] focusable [tabindex] - code - generic - generic - generic - button "Copy code to clipboard" [ref=e506] - paragraph - StaticText "Same agent, same tools, same skills — just strips every interactive / cosmetic layer. If you need tool output in the transcript too, use " - code - StaticText "hermes chat -q" - StaticText " instead; " - code - StaticText "-z" - StaticText " is explicitly for \"I only want the final answer\"." - heading "--usage-file — JSON usage report for pipelines Direct link to --usage-file--json-usage-report-for-pipelines" [level=4, ref=e24] - code - StaticText "--usage-file" - StaticText " — JSON usage report for pipelines" - link "Direct link to --usage-file--json-usage-report-for-pipelines" [ref=e124] - StaticText "#" - paragraph - code - StaticText "hermes -z \"…\" --usage-file /path/report.json" - StaticText " writes a machine-readable usage report after the run: " - code - StaticText "estimated_cost_usd" - StaticText ", " - code - StaticText "input_tokens" - StaticText " / " - code - StaticText "output_tokens" - StaticText " / " - code - StaticText "cache_read_tokens" - StaticText " / " - code - StaticText "cache_write_tokens" - StaticText " / " - code - StaticText "reasoning_tokens" - StaticText " / " - code - StaticText "total_tokens" - StaticText ", " - code - StaticText "api_calls" - StaticText ", " - code - StaticText "model" - StaticText ", " - code - StaticText "provider" - StaticText ", " - code - StaticText "session_id" - StaticText ", " - code - StaticText "service_tier" - StaticText ", and " - code - StaticText "completed" - StaticText " / " - code - StaticText "failed" - StaticText " flags. The report is written " - strong - StaticText "even when the run fails" - StaticText ", so batch pipelines can always account for spend. It has no effect outside " - code - StaticText "-z" - StaticText "/" - code - StaticText "--oneshot" - StaticText ", and a broken usage write never masks the run's own outcome." - generic - generic [ref=e125] focusable [tabindex] - code - generic - generic - button "Copy code to clipboard" [ref=e507] - heading "hermes model Direct link to hermes-model" [level=2, ref=e25] - code - StaticText "hermes model" - link "Direct link to hermes-model" [ref=e126] - StaticText "#" - paragraph - StaticText "Interactive provider + model selector. " - strong - StaticText "This is the command for adding new providers, setting up API keys, and running OAuth flows." - StaticText " Run it from your terminal — not from inside an active Hermes chat session." - generic - generic [ref=e127] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e508] - paragraph - StaticText "Use this when you want to:" - list - listitem [level=1] - ListMarker "• " - strong - StaticText "add a new provider" - StaticText " (OpenRouter, Anthropic, Copilot, DeepSeek, custom, etc.)" - listitem [level=1] - ListMarker "• " - StaticText "log into OAuth-backed providers (Anthropic, Copilot, Codex, Nous Portal)" - listitem [level=1] - ListMarker "• " - StaticText "enter or update API keys" - listitem [level=1] - ListMarker "• " - StaticText "pick from provider-specific model lists" - listitem [level=1] - ListMarker "• " - StaticText "configure a custom/self-hosted endpoint" - listitem [level=1] - ListMarker "• " - StaticText "save the new default into config" - generic - image - StaticText "HERMES MODEL VS /MODEL — KNOW THE DIFFERENCE" - paragraph - strong - code - StaticText "hermes model" - StaticText " (run from your terminal, outside any Hermes session) is the " - strong - StaticText "full provider setup wizard" - StaticText ". It can add new providers, run OAuth flows, prompt for API keys, and configure endpoints." - paragraph - strong - code - StaticText "/model" - StaticText " (typed inside an active Hermes chat session) can only " - strong - StaticText "switch between providers and models you've already set up" - StaticText ". It cannot add new providers, run OAuth, or prompt for API keys." - paragraph - strong - StaticText "If you need to add a new provider:" - StaticText " Exit your Hermes session first (" - code - StaticText "Ctrl+C" - StaticText " or " - code - StaticText "/quit" - StaticText "), then run " - code - StaticText "hermes model" - StaticText " from your terminal prompt." - heading "/model slash command (mid-session) Direct link to model-slash-command-mid-session" [level=3, ref=e26] - code - StaticText "/model" - StaticText " slash command (mid-session)" - link "Direct link to model-slash-command-mid-session" [ref=e128] - StaticText "#" - paragraph - StaticText "Switch between already-configured models without leaving a session:" - generic - generic [ref=e129] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e509] - button "Copy code to clipboard" [ref=e510] - paragraph - StaticText "By default, " - code - StaticText "/model" - StaticText " changes apply " - strong - StaticText "to the current session only" - StaticText ". Add " - code - StaticText "--global" - StaticText " to persist the change to " - code - StaticText "config.yaml" - StaticText " (or set " - code - StaticText "model.persist_switch_by_default: true" - StaticText " to make every switch persist):" - generic - generic [ref=e130] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e511] - generic - image - StaticText "WHAT IF I ONLY SEE OPENROUTER MODELS?" - paragraph - StaticText "If you've only configured OpenRouter, " - code - StaticText "/model" - StaticText " will only show OpenRouter models. To add another provider (Anthropic, DeepSeek, Copilot, etc.), exit your session and run " - code - StaticText "hermes model" - StaticText " from the terminal." - paragraph - StaticText "On a " - code - StaticText "--global" - StaticText " switch, provider and base URL changes are persisted to " - code - StaticText "config.yaml" - StaticText " alongside the model. When switching away from a custom endpoint, the stale base URL is cleared to prevent it leaking into other providers." - heading "hermes gateway Direct link to hermes-gateway" [level=2, ref=e27] - code - StaticText "hermes gateway" - link "Direct link to hermes-gateway" [ref=e131] - StaticText "#" - generic - generic [ref=e132] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e512] - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1336] - columnheader "Description" [ref=e1337] - row - cell "run" [ref=e513] - code - cell "Run the gateway in the foreground. Recommended for WSL, Docker, and Termux." [ref=e514] - row - cell "start" [ref=e515] - code - cell "Start the installed systemd/launchd background service." [ref=e516] - row - cell "stop" [ref=e517] - code - cell "Stop the service (or foreground process)." [ref=e518] - row - cell "restart" [ref=e519] - code - cell "Restart the service." [ref=e520] - row - cell "status" [ref=e521] - code - cell "Show service status." [ref=e522] - row - cell "list" [ref=e523] - code - cell "List all profiles and whether each profile's gateway is currently running (with PID where available). Handy when you run multiple profiles side-by-side and want a single overview." [ref=e524] - StaticText "List " - strong - StaticText " and whether each profile's gateway is currently running (with PID where available). Handy when you run multiple profiles side-by-side and want a single overview." - row - cell "install" [ref=e525] - code - cell "Install as a systemd (Linux) or launchd (macOS) background service." [ref=e526] - row - cell "uninstall" [ref=e527] - code - cell "Remove the installed service." [ref=e528] - row - cell "setup" [ref=e529] - code - cell "Interactive messaging-platform setup." [ref=e530] - row - cell "migrate-legacy" [ref=e531] - code - cell "Remove legacy hermes.service units left over from pre-rename installs. Profile units (hermes-gateway-.service) and unrelated services are never touched. Flags: --dry-run, -y/--yes." [ref=e532] - StaticText "Remove legacy " - code - StaticText " units left over from pre-rename installs. Profile units (" - code - StaticText ") and unrelated services are never touched. Flags: " - code - StaticText ", " - code - StaticText "/" - code - StaticText "." - row - cell "enroll" [ref=e533] - code - cell "Experimental: enroll this gateway with a relay connector and save relay credentials for connector-backed platforms. See Hermes Relay." [ref=e534] - StaticText "Experimental: enroll this gateway with a relay connector and save relay credentials for connector-backed platforms. See " - link "Hermes Relay" [ref=e1338] - StaticText "." - paragraph - StaticText "Options:" - table - rowgroup - row - columnheader "Option" [ref=e1339] - columnheader "Description" [ref=e1340] - row - cell "--all" [ref=e535] - code - cell "On start / restart / stop: act on every profile's gateway, not just the active HERMES_HOME. Useful if you run multiple profiles side-by-side and want to restart them all after hermes update." [ref=e536] - StaticText "On " - code - StaticText " / " - code - StaticText " / " - code - StaticText ": act on " - strong - StaticText " gateway, not just the active " - code - StaticText ". Useful if you run multiple profiles side-by-side and want to restart them all after " - code - StaticText "." - row - cell "--no-supervise" [ref=e537] - code - cell "On run: inside the s6-overlay Docker image, opt out of auto-supervision and use pre-s6 foreground semantics — gateway runs as the container's main process with no auto-restart. No-op outside the s6 image. Equivalent to setting HERMES_GATEWAY_NO_SUPERVISE=1." [ref=e538] - StaticText "On " - code - StaticText ": inside the s6-overlay Docker image, opt out of auto-supervision and use pre-s6 foreground semantics — gateway runs as the container's main process with no auto-restart. No-op outside the s6 image. Equivalent to setting " - code - StaticText "." - row - cell "--external-supervisor" [ref=e539] - code - cell "On run: declare that a wrapper-provided process manager owns the foreground gateway. Use this when sudo, env -i, or another wrapper strips launchd/systemd's native environment marker. In-chat restarts and updates exit back to that manager instead of spawning a detached replacement." [ref=e540] - StaticText "On " - code - StaticText ": declare that a wrapper-provided process manager owns the foreground gateway. Use this when " - code - StaticText ", " - code - StaticText ", or another wrapper strips launchd/systemd's native environment marker. In-chat restarts and updates exit back to that manager instead of spawning a detached replacement." - paragraph - code - StaticText "--external-supervisor" - StaticText " is a restart-policy contract: an in-chat restart or service-restart update exits with status " - code - StaticText "75" - StaticText ", so the wrapper's supervisor must relaunch the gateway after that nonzero exit. For systemd, use " - code - StaticText "Restart=on-failure" - StaticText " or " - code - StaticText "Restart=always" - StaticText " and do not include " - code - StaticText "75" - StaticText " in " - code - StaticText "RestartPreventExitStatus" - StaticText "; for launchd, configure " - code - StaticText "KeepAlive" - StaticText " to relaunch after unsuccessful exits. Without that policy, a requested restart leaves the gateway stopped." - paragraph - code - StaticText "hermes gateway enroll" - StaticText " accepts " - code - StaticText "--token" - StaticText ", " - code - StaticText "--connector-url" - StaticText ", " - code - StaticText "--gateway-id" - StaticText ", and " - code - StaticText "--wake-url" - StaticText ". It exchanges the enrollment token with the connector and writes the resulting " - code - StaticText "GATEWAY_RELAY_ID" - StaticText ", " - code - StaticText "GATEWAY_RELAY_SECRET" - StaticText ", " - code - StaticText "GATEWAY_RELAY_DELIVERY_KEY" - StaticText ", optional " - code - StaticText "GATEWAY_RELAY_URL" - StaticText ", and (when " - code - StaticText "--wake-url" - StaticText " is given) " - code - StaticText "GATEWAY_RELAY_WAKE_URL" - StaticText " values to the active profile's " - code - StaticText ".env" - StaticText "." - generic - image - StaticText "WSL USERS" - paragraph - StaticText "Use " - code - StaticText "hermes gateway run" - StaticText " instead of " - code - StaticText "hermes gateway start" - StaticText " — WSL's systemd support is unreliable. Wrap it in tmux for persistence: " - code - StaticText "tmux new -s hermes 'hermes gateway run'" - StaticText ". See " - link "WSL FAQ" [ref=e133] - StaticText " for details." - heading "hermes lsp Direct link to hermes-lsp" [level=2, ref=e28] - code - StaticText "hermes lsp" - link "Direct link to hermes-lsp" [ref=e134] - StaticText "#" - generic - generic [ref=e135] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e541] - paragraph - StaticText "Manage the Language Server Protocol integration. LSP runs real language servers (pyright, gopls, rust-analyzer, …) in the background and feeds their diagnostics into the post-write check used by " - code - StaticText "write_file" - StaticText " and " - code - StaticText "patch" - StaticText ". Gated on git workspace detection — LSP only runs when the cwd or edited file is inside a git worktree." - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1341] - columnheader "Description" [ref=e1342] - row - cell "status" [ref=e542] - code - cell "Show service state, configured servers, install status." [ref=e543] - row - cell "list" [ref=e544] - code - cell "Print the registry of supported servers. Pass --installed-only to skip missing ones." [ref=e545] - StaticText "Print the registry of supported servers. Pass " - code - StaticText " to skip missing ones." - row - cell "install " [ref=e546] - code - cell "Eagerly install one server's binary." [ref=e547] - row - cell "install-all" [ref=e548] - code - cell "Install every server with a known auto-install recipe." [ref=e549] - row - cell "restart" [ref=e550] - code - cell "Tear down running clients so the next edit re-spawns." [ref=e551] - row - cell "which " [ref=e552] - code - cell "Print the resolved binary path for one server." [ref=e553] - paragraph - StaticText "See " - link "LSP — Semantic Diagnostics" [ref=e136] - StaticText " for the full guide, supported languages, and configuration knobs." - heading "hermes setup Direct link to hermes-setup" [level=2, ref=e29] - code - StaticText "hermes setup" - link "Direct link to hermes-setup" [ref=e137] - StaticText "#" - generic - generic [ref=e138] focusable [tabindex] - code - generic - generic - button "Toggle word wrap" [ref=e554] - button "Copy code to clipboard" [ref=e555] - paragraph - strong - StaticText "Easiest path:" - StaticText " " - code - StaticText "hermes setup --portal" - StaticText " — OAuth into Nous Portal and opt into the " - link "Tool Gateway" [ref=e139] - StaticText " in one shot." - paragraph - strong - StaticText "First run:" - StaticText " launches the first-time wizard." - paragraph - strong - StaticText "Returning user (already configured):" - StaticText " drops straight into the full reconfigure wizard — every prompt shows your current value as its default, press Enter to keep or type a new value. No menu." - paragraph - StaticText "Jump into one section instead of the full wizard:" - table - rowgroup - row - columnheader "Section" [ref=e1343] - columnheader "Description" [ref=e1344] - row - cell "model" [ref=e556] - code - cell "Provider and model setup." [ref=e557] - row - cell "terminal" [ref=e558] - code - cell "Terminal backend and sandbox setup." [ref=e559] - row - cell "gateway" [ref=e560] - code - cell "Messaging platform setup." [ref=e561] - row - cell "tools" [ref=e562] - code - cell "Enable/disable tools per platform." [ref=e563] - row - cell "agent" [ref=e564] - code - cell "Agent behavior settings." [ref=e565] - paragraph - StaticText "Options:" - table - rowgroup - row - columnheader "Option" [ref=e1345] - columnheader "Description" [ref=e1346] - row - cell "--quick" [ref=e566] - code - cell "On returning-user runs: only prompt for items that are missing or unset. Skip items you already have configured." [ref=e567] - row - cell "--non-interactive" [ref=e568] - code - cell "Use defaults / environment values without prompts." [ref=e569] - row - cell "--reset" [ref=e570] - code - cell "Reset configuration to defaults before setup." [ref=e571] - row - cell "--reconfigure" [ref=e572] - code - cell "Backwards-compat alias — bare hermes setup on an existing install now does this by default." [ref=e573] - StaticText "Backwards-compat alias — bare " - code - StaticText " on an existing install now does this by default." - row - cell "--portal" [ref=e574] - code - cell "One-shot Nous Portal setup: log in via OAuth, set Nous as the inference provider, and opt into the Tool Gateway. Skips the rest of the wizard." [ref=e575] - StaticText "One-shot Nous Portal setup: log in via OAuth, set Nous as the inference provider, and opt into the " - link "Tool Gateway" [ref=e1347] - StaticText ". Skips the rest of the wizard." - heading "hermes portal Direct link to hermes-portal" [level=2, ref=e30] - code - StaticText "hermes portal" - link "Direct link to hermes-portal" [ref=e140] - StaticText "#" - generic - generic [ref=e141] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e576] - paragraph - StaticText "Inspect Nous Portal auth, Tool Gateway routing, and reach the subscription page. Subcommand-less invocation runs " - code - StaticText "status" - StaticText "." - table - rowgroup - row - columnheader "Subcommand" [ref=e1348] - columnheader "Description" [ref=e1349] - row - cell "status (default)" [ref=e577] - code - StaticText " (default)" - cell "Portal auth state + per-tool Tool Gateway routing summary. Also shown when no subcommand is given." [ref=e578] - row - cell "open" [ref=e579] - code - cell "Open portal.nousresearch.com/manage-subscription in your default browser." [ref=e580] - StaticText "Open " - code - StaticText " in your default browser." - row - cell "tools" [ref=e581] - code - cell "List every Tool Gateway partner (Firecrawl, FAL, OpenAI TTS, Browser Use, Modal) and which are routed via Nous." [ref=e582] - paragraph - StaticText "For configuration of the gateway itself, see " - link "Tool Gateway" [ref=e142] - StaticText ". For the one-shot setup path, see " - code - StaticText "hermes setup --portal" - StaticText " above." - heading "hermes whatsapp Direct link to hermes-whatsapp" [level=2, ref=e31] - code - StaticText "hermes whatsapp" - link "Direct link to hermes-whatsapp" [ref=e143] - StaticText "#" - generic - generic [ref=e144] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e583] - paragraph - StaticText "Runs the WhatsApp pairing/setup flow, including mode selection and QR-code pairing." - heading "hermes slack Direct link to hermes-slack" [level=2, ref=e32] - code - StaticText "hermes slack" - link "Direct link to hermes-slack" [ref=e145] - StaticText "#" - generic - generic [ref=e146] focusable [tabindex] - code - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e584] - button "Copy code to clipboard" [ref=e585] - paragraph - StaticText "Generates a Slack app manifest that registers every gateway command in " - code - StaticText "COMMAND_REGISTRY" - StaticText " (" - code - StaticText "/btw" - StaticText ", " - code - StaticText "/stop" - StaticText ", " - code - StaticText "/model" - StaticText ", …) as a first-class Slack slash command — matching Discord and Telegram parity. Paste the output into your Slack app config at " - link "https://api.slack.com/apps" [ref=e147] - StaticText " → your app → " - strong - StaticText "Features → App Manifest → Edit" - StaticText ", then " - strong - StaticText "Save" - StaticText ". Slack prompts for reinstall if scopes or slash commands changed." - table - rowgroup - row - columnheader "Flag" [ref=e1350] - columnheader "Default" [ref=e1351] - columnheader "Purpose" [ref=e1352] - row - cell "--write [PATH]" [ref=e586] - code - cell "stdout" [ref=e587] - cell "Write to a file instead of stdout. Bare --write writes $HERMES_HOME/slack-manifest.json." [ref=e588] - StaticText "Write to a file instead of stdout. Bare " - code - StaticText " writes " - code - StaticText "." - row - cell "--name NAME" [ref=e589] - code - cell "Hermes" [ref=e590] - code - cell "Bot display name in Slack." [ref=e591] - row - cell "--description DESC" [ref=e592] - code - cell "default blurb" [ref=e593] - cell "Bot description shown in the Slack app directory." [ref=e594] - row - cell "--long-description TEXT" [ref=e595] - code - cell "unset" [ref=e596] - cell "Set display_information.long_description inline (175–4,000 characters). Incompatible with --slashes-only." [ref=e597] - StaticText "Set " - code - StaticText " inline (175–4,000 characters). Incompatible with " - code - StaticText "." - row - cell "--long-description-file PATH" [ref=e598] - code - cell "unset" [ref=e599] - cell "Read the long description from a UTF-8 text file, preserving its contents exactly. Mutually exclusive with --long-description and incompatible with --slashes-only." [ref=e600] - StaticText "Read the long description from a UTF-8 text file, preserving its contents exactly. Mutually exclusive with " - code - StaticText " and incompatible with " - code - StaticText "." - row - cell "--slashes-only" [ref=e601] - code - cell "off" [ref=e602] - cell "Emit only features.slash_commands for merging into a manually-maintained manifest." [ref=e603] - StaticText "Emit only " - code - StaticText " for merging into a manually-maintained manifest." - paragraph - StaticText "Run " - code - StaticText "hermes slack manifest --write" - StaticText " again after " - code - StaticText "hermes update" - StaticText " to pick up any new commands." - heading "hermes send Direct link to hermes-send" [level=2, ref=e33] - code - StaticText "hermes send" - link "Direct link to hermes-send" [ref=e148] - StaticText "#" - generic - generic [ref=e149] focusable [tabindex] - code - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e604] - paragraph - StaticText "Send a one-shot message to a configured messaging platform without spinning up an agent or gateway loop. Reuses the gateway's already-configured credentials (" - code - StaticText "~/.hermes/.env" - StaticText " + " - code - StaticText "~/.hermes/config.yaml" - StaticText ") so ops scripts, cron jobs, CI hooks, and monitoring daemons can post status updates without reimplementing each platform's REST client." - paragraph - StaticText "For bot-token platforms (Telegram, Discord, Slack, Signal, SMS, WhatsApp-CloudAPI) no running gateway is required — " - code - StaticText "hermes send" - StaticText " talks directly to the platform's REST endpoint. Plugin platforms that need a persistent adapter still require a live gateway." - table - rowgroup - row - columnheader "Option" [ref=e1353] - columnheader "Description" [ref=e1354] - row - cell "-t, --to " [ref=e605] - code - StaticText ", " - code - cell "Delivery target. Formats: platform (uses home channel), platform:chat_id, platform:chat_id:thread_id, or platform:#channel-name. Examples: telegram, telegram:-1001234567890, discord:#ops, slack:C0123ABCD, signal:+155****4567." [ref=e606] - StaticText "Delivery target. Formats: " - code - StaticText " (uses home channel), " - code - StaticText ", " - code - StaticText ", or " - code - StaticText ". Examples: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "-f, --file " [ref=e607] - code - StaticText ", " - code - cell "Read the message body from PATH (text files only — logs, reports, markdown). Pass - to force reading from stdin. To send an image or other binary file, use MEDIA: (see below)." [ref=e608] - StaticText "Read the message body from " - code - StaticText " (text files only — logs, reports, markdown). Pass " - code - StaticText " to force reading from stdin. To send an image or other binary file, use " - code - StaticText " (see below)." - row - cell "-s, --subject " [ref=e609] - code - StaticText ", " - code - cell "Prepend a subject/header line before the message body." [ref=e610] - row - cell "-l, --list [platform]" [ref=e611] - code - StaticText ", " - code - cell "List configured targets across all platforms (or only the given platform)." [ref=e612] - row - cell "-q, --quiet" [ref=e613] - code - StaticText ", " - code - cell "Suppress stdout on success — useful in scripts (rely on exit code only)." [ref=e614] - row - cell "--json" [ref=e615] - code - cell "Emit raw JSON result instead of human-readable output." [ref=e616] - paragraph - StaticText "If neither a positional " - code - StaticText "message" - StaticText " argument nor " - code - StaticText "--file" - StaticText " is provided, " - code - StaticText "hermes send" - StaticText " reads from stdin when it is not a TTY. Exit codes: " - code - StaticText "0" - StaticText " on success, " - code - StaticText "1" - StaticText " on delivery/backend failure, " - code - StaticText "2" - StaticText " on usage errors." - heading "Sending images and other media Direct link to Sending images and other media" [level=3, ref=e34] - StaticText "Sending images and other media" - link "Direct link to Sending images and other media" [ref=e150] - StaticText "#" - paragraph - code - StaticText "--file" - StaticText " is for " - emphasis - StaticText "text" - StaticText " bodies only. To deliver an image, document, video, or audio file as a native platform attachment, reference it inside the message text with the " - code - StaticText "MEDIA:" - StaticText " directive:" - generic - generic [ref=e151] focusable [tabindex] - code - generic - generic - generic - generic - button "Toggle word wrap" [ref=e617] - button "Copy code to clipboard" [ref=e618] - paragraph - StaticText "By default, image files are sent as photos (platforms like Telegram recompress these). Add " - code - StaticText "[[as_document]]" - StaticText " to the message to deliver them as uncompressed file attachments instead:" - generic - generic [ref=e152] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e619] - paragraph - StaticText "Examples:" - generic - generic [ref=e153] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e620] - heading "hermes secrets Direct link to hermes-secrets" [level=2, ref=e35] - code - StaticText "hermes secrets" - link "Direct link to hermes-secrets" [ref=e154] - StaticText "#" - generic - generic [ref=e155] focusable [tabindex] - code - generic - generic - button "Copy code to clipboard" [ref=e621] - paragraph - StaticText "Pull API keys from an external secret manager at process startup instead of storing them in " - code - StaticText "~/.hermes/.env" - StaticText ". Currently supports " - strong - StaticText "Bitwarden Secrets Manager" - StaticText ". See the full guide: " - link "Bitwarden integration" [ref=e156] - StaticText "." - paragraph - code - StaticText "bitwarden" - StaticText " (alias " - code - StaticText "bw" - StaticText ") subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1355] - columnheader "Description" [ref=e1356] - row - cell "setup" [ref=e622] - code - cell "Interactive wizard: install the pinned bws binary, store an access token, and pick a project. Accepts --project-id, --access-token, and --server-url for non-interactive use." [ref=e623] - StaticText "Interactive wizard: install the pinned " - code - StaticText " binary, store an access token, and pick a project. Accepts " - code - StaticText ", " - code - StaticText ", and " - code - StaticText " for non-interactive use." - row - cell "status" [ref=e624] - code - cell "Show current config, binary path/version, and token validation status." [ref=e625] - row - cell "token" [ref=e626] - code - cell "Rotate the access token: validates the new token against Bitwarden before storing it in .env (a rejected token changes nothing). Accepts --access-token for non-interactive use and --no-verify to skip the probe." [ref=e627] - StaticText "Rotate the access token: validates the new token against Bitwarden before storing it in " - code - StaticText " (a rejected token changes nothing). Accepts " - code - StaticText " for non-interactive use and " - code - StaticText " to skip the probe." - row - cell "sync" [ref=e628] - code - cell "Fetch secrets now and report what changed. Add --apply to actually export the secrets into the current shell's environment (default is dry-run)." [ref=e629] - StaticText "Fetch secrets now and report what changed. Add " - code - StaticText " to actually export the secrets into the current shell's environment (default is dry-run)." - row - cell "install" [ref=e630] - code - cell "Download and verify the pinned bws binary. --force re-downloads even if a managed copy already exists." [ref=e631] - StaticText "Download and verify the pinned " - code - StaticText " binary. " - code - StaticText " re-downloads even if a managed copy already exists." - row - cell "disable" [ref=e632] - code - cell "Turn off the Bitwarden integration." [ref=e633] - heading "hermes migrate Direct link to hermes-migrate" [level=2, ref=e36] - code - StaticText "hermes migrate" - link "Direct link to hermes-migrate" [ref=e157] - StaticText "#" - generic - generic [ref=e158] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e634] - paragraph - StaticText "Diagnose and (optionally) rewrite the active " - code - StaticText "config.yaml" - StaticText " to replace references to retired models or deprecated settings. A timestamped backup of the original " - code - StaticText "config.yaml" - StaticText " is taken before any rewrite (skip with " - code - StaticText "--no-backup" - StaticText ")." - table - rowgroup - row - columnheader "Subcommand" [ref=e1357] - columnheader "Description" [ref=e1358] - row - cell "xai" [ref=e635] - code - cell "Scan config.yaml for references to xAI models scheduled for retirement on May 15, 2026 and (with --apply) rewrite them in-place to the official replacements per the xAI migration guide. Defaults to dry-run." [ref=e636] - StaticText "Scan " - code - StaticText " for references to xAI models scheduled for retirement on May 15, 2026 and (with " - code - StaticText ") rewrite them in-place to the official replacements per the xAI migration guide. Defaults to dry-run." - paragraph - StaticText "Common flags for migration subcommands:" - table - rowgroup - row - columnheader "Flag" [ref=e1359] - columnheader "Description" [ref=e1360] - row - cell "--apply" [ref=e637] - code - cell "Rewrite config.yaml in-place (default: dry-run, no writes)." [ref=e638] - StaticText "Rewrite " - code - StaticText " in-place (default: dry-run, no writes)." - row - cell "--no-backup" [ref=e639] - code - cell "Skip the timestamped backup of config.yaml when applying." [ref=e640] - StaticText "Skip the timestamped backup of " - code - StaticText " when applying." - blockquote - paragraph - StaticText "Not to be confused with " - code - StaticText "hermes claw migrate" - StaticText " (one-shot import of OpenClaw configuration into Hermes) — " - code - StaticText "hermes migrate" - StaticText " is the top-level config-rewrite command." - heading "hermes proxy Direct link to hermes-proxy" [level=2, ref=e37] - code - StaticText "hermes proxy" - link "Direct link to hermes-proxy" [ref=e159] - StaticText "#" - generic - generic [ref=e160] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e641] - paragraph - StaticText "Run a local OpenAI-compatible HTTP server that forwards requests to an OAuth-authenticated upstream provider (e.g. Nous Portal, xAI). External apps can point at the proxy with any bearer token; the proxy attaches your real OAuth credentials on the way out. See " - link "Subscription Proxy" [ref=e161] - StaticText " for the full guide." - table - rowgroup - row - columnheader "Subcommand" [ref=e1361] - columnheader "Description" [ref=e1362] - row - cell "start" [ref=e642] - code - cell "Run the proxy in the foreground. Flags: --provider (default nous), --host (default 127.0.0.1; use 0.0.0.0 to expose on LAN), --port (default 8645)." [ref=e643] - StaticText "Run the proxy in the foreground. Flags: " - code - StaticText " (default " - code - StaticText "), " - code - StaticText " (default " - code - StaticText "; use " - code - StaticText " to expose on LAN), " - code - StaticText " (default " - code - StaticText ")." - row - cell "status" [ref=e644] - code - cell "Show which proxy upstreams are ready (credentials present, OAuth valid)." [ref=e645] - row - cell "providers" [ref=e646] - code - cell "List available proxy upstream providers." [ref=e647] - heading "hermes security Direct link to hermes-security" [level=2, ref=e38] - code - StaticText "hermes security" - link "Direct link to hermes-security" [ref=e162] - StaticText "#" - generic - generic [ref=e163] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e648] - paragraph - StaticText "On-demand vulnerability scan against " - link "OSV.dev" [ref=e164] - StaticText ". Covers the Hermes venv (installed PyPI distributions), Python dependencies declared by plugins under " - code - StaticText "~/.hermes/plugins/" - StaticText ", and pinned " - code - StaticText "npx" - StaticText "/" - code - StaticText "uvx" - StaticText " MCP servers in " - code - StaticText "config.yaml" - StaticText ". Does NOT scan globally-installed packages or editor/browser extensions." - table - rowgroup - row - columnheader "Subcommand" [ref=e1363] - columnheader "Description" [ref=e1364] - row - cell "audit" [ref=e649] - code - cell "Run a one-shot supply-chain audit." [ref=e650] - paragraph - code - StaticText "audit" - StaticText " flags:" - table - rowgroup - row - columnheader "Flag" [ref=e1365] - columnheader "Default" [ref=e1366] - columnheader "Description" [ref=e1367] - row - cell "--json" [ref=e651] - code - cell "off" [ref=e652] - cell "Emit machine-readable JSON instead of human-readable text." [ref=e653] - row - cell "--fail-on " [ref=e654] - code - cell "critical" [ref=e655] - code - cell "Exit non-zero when any finding meets this severity (low, moderate, high, critical)." [ref=e656] - StaticText "Exit non-zero when any finding meets this severity (" - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ")." - row - cell "--skip-venv" [ref=e657] - code - cell "off" [ref=e658] - cell "Skip scanning the Hermes Python venv." [ref=e659] - row - cell "--skip-plugins" [ref=e660] - code - cell "off" [ref=e661] - cell "Skip scanning plugin requirements files." [ref=e662] - row - cell "--skip-mcp" [ref=e663] - code - cell "off" [ref=e664] - cell "Skip scanning pinned MCP servers in config.yaml." [ref=e665] - StaticText "Skip scanning pinned MCP servers in " - code - StaticText "." - heading "hermes login / hermes logout (Deprecated) Direct link to hermes-login--hermes-logout-deprecated" [level=2, ref=e39] - code - StaticText "hermes login" - StaticText " / " - code - StaticText "hermes logout" - StaticText " " - emphasis - StaticText "(Deprecated)" - link "Direct link to hermes-login--hermes-logout-deprecated" [ref=e165] - StaticText "#" - generic - image - StaticText "CAUTION" - paragraph - code - StaticText "hermes login" - StaticText " has been removed. Use " - code - StaticText "hermes auth" - StaticText " to manage OAuth credentials, " - code - StaticText "hermes model" - StaticText " to select a provider, or " - code - StaticText "hermes setup" - StaticText " for full interactive setup." - heading "hermes auth Direct link to hermes-auth" [level=2, ref=e40] - code - StaticText "hermes auth" - link "Direct link to hermes-auth" [ref=e166] - StaticText "#" - paragraph - StaticText "Manage credential pools for same-provider key rotation. See " - link "Credential Pools" [ref=e167] - StaticText " for full documentation." - generic - generic [ref=e168] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e666] - button "Copy code to clipboard" [ref=e667] - paragraph - StaticText "Subcommands: " - code - StaticText "add" - StaticText ", " - code - StaticText "list" - StaticText ", " - code - StaticText "remove" - StaticText ", " - code - StaticText "reset" - StaticText ", " - code - StaticText "status" - StaticText ", " - code - StaticText "logout" - StaticText ", " - code - StaticText "spotify" - StaticText ". When called with no subcommand, launches the interactive management wizard." - heading "hermes status Direct link to hermes-status" [level=2, ref=e41] - code - StaticText "hermes status" - link "Direct link to hermes-status" [ref=e169] - StaticText "#" - generic - generic [ref=e170] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e668] - table - rowgroup - row - columnheader "Option" [ref=e1368] - columnheader "Description" [ref=e1369] - row - cell "--all" [ref=e669] - code - cell "Show all details in a shareable redacted format." [ref=e670] - row - cell "--deep" [ref=e671] - code - cell "Run deeper checks that may take longer." [ref=e672] - heading "hermes cron Direct link to hermes-cron" [level=2, ref=e42] - code - StaticText "hermes cron" - link "Direct link to hermes-cron" [ref=e171] - StaticText "#" - generic - generic [ref=e172] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e673] - table - rowgroup - row - columnheader "Subcommand" [ref=e1370] - columnheader "Description" [ref=e1371] - row - cell "list" [ref=e674] - code - cell "Show scheduled jobs." [ref=e675] - row - cell "create / add" [ref=e676] - code - StaticText " / " - code - cell "Create a scheduled job from a prompt, optionally attaching one or more skills via repeated --skill." [ref=e677] - StaticText "Create a scheduled job from a prompt, optionally attaching one or more skills via repeated " - code - StaticText "." - row - cell "edit" [ref=e678] - code - cell "Update a job's schedule, prompt, name, delivery, repeat count, or attached skills. Supports --clear-skills, --add-skill, and --remove-skill." [ref=e679] - StaticText "Update a job's schedule, prompt, name, delivery, repeat count, or attached skills. Supports " - code - StaticText ", " - code - StaticText ", and " - code - StaticText "." - row - cell "pause" [ref=e680] - code - cell "Pause a job without deleting it." [ref=e681] - row - cell "resume" [ref=e682] - code - cell "Resume a paused job and compute its next future run." [ref=e683] - row - cell "run" [ref=e684] - code - cell "Trigger a job on the next scheduler tick." [ref=e685] - row - cell "remove" [ref=e686] - code - cell "Delete a scheduled job." [ref=e687] - row - cell "status" [ref=e688] - code - cell "Check whether the cron scheduler is running." [ref=e689] - row - cell "tick" [ref=e690] - code - cell "Run due jobs once and exit." [ref=e691] - paragraph - StaticText "The cron " - strong - StaticText "trigger" - StaticText " is pluggable via the " - code - StaticText "cron.provider" - StaticText " config key. Empty (the default) uses the built-in in-process ticker. Set it to " - code - StaticText "chronos" - StaticText " (the NAS-managed provider for scale-to-zero hosted gateways) — configured via the " - code - StaticText "cron.chronos.*" - StaticText " keys (" - code - StaticText "portal_url" - StaticText ", " - code - StaticText "callback_url" - StaticText ", " - code - StaticText "expected_audience" - StaticText ", " - code - StaticText "nas_jwks_url" - StaticText ") — or name a custom provider under " - code - StaticText "plugins/cron//" - StaticText " or " - code - StaticText "$HERMES_HOME/plugins//" - StaticText ". An unknown or unavailable provider falls back to the built-in, so cron is never left without a trigger. See the " - link "cron internals" [ref=e173] - StaticText " doc." - heading "hermes kanban Direct link to hermes-kanban" [level=2, ref=e43] - code - StaticText "hermes kanban" - link "Direct link to hermes-kanban" [ref=e174] - StaticText "#" - generic - generic [ref=e175] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e692] - paragraph - StaticText "Multi-profile, multi-project collaboration board. Each install can host many boards (one per project, repo, or domain); each board is a standalone queue with its own SQLite DB and dispatcher scope. New installs start with one board called " - code - StaticText "default" - StaticText ", whose DB is " - code - StaticText "~/.hermes/kanban.db" - StaticText " for back-compat; additional boards live at " - code - StaticText "~/.hermes/kanban/boards//kanban.db" - StaticText ". The gateway-embedded dispatcher sweeps every board per tick." - paragraph - strong - StaticText "Global flags (apply to every action below):" - table - rowgroup - row - columnheader "Flag" [ref=e1372] - columnheader "Purpose" [ref=e1373] - row - cell "--board " [ref=e693] - code - cell "Operate on a specific board. Defaults to the current board (set via hermes kanban boards switch, the HERMES_KANBAN_BOARD env var, or default)." [ref=e694] - StaticText "Operate on a specific board. Defaults to the current board (set via " - code - StaticText ", the " - code - StaticText " env var, or " - code - StaticText ")." - paragraph - strong - StaticText "This is the human / scripting surface." - StaticText " Agent workers spawned by the dispatcher drive the board through a dedicated " - code - StaticText "kanban_*" - StaticText " " - link "toolset" [ref=e176] - StaticText " (" - code - StaticText "kanban_show" - StaticText ", " - code - StaticText "kanban_complete" - StaticText ", " - code - StaticText "kanban_block" - StaticText ", " - code - StaticText "kanban_create" - StaticText ", " - code - StaticText "kanban_link" - StaticText ", " - code - StaticText "kanban_comment" - StaticText ", " - code - StaticText "kanban_heartbeat" - StaticText "; orchestrator profiles also get " - code - StaticText "kanban_list" - StaticText " and " - code - StaticText "kanban_unblock" - StaticText ") instead of shelling to " - code - StaticText "hermes kanban" - StaticText ". Workers have " - code - StaticText "HERMES_KANBAN_BOARD" - StaticText " pinned in their env so they physically cannot see other boards." - table - rowgroup - row - columnheader "Action" [ref=e1374] - columnheader "Purpose" [ref=e1375] - row - cell "init" [ref=e695] - code - cell "Create kanban.db if missing. Idempotent." [ref=e696] - StaticText "Create " - code - StaticText " if missing. Idempotent." - row - cell "boards list / boards ls" [ref=e697] - code - StaticText " / " - code - cell "List all boards with task counts. --json, --all (include archived)." [ref=e698] - StaticText "List all boards with task counts. " - code - StaticText ", " - code - StaticText " (include archived)." - row - cell "boards create " [ref=e699] - code - cell "Create a new board. Flags: --name, --description, --icon, --color, --switch (make active). Slug is kebab-case, auto-downcased." [ref=e700] - StaticText "Create a new board. Flags: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (make active). Slug is kebab-case, auto-downcased." - row - cell "boards switch / boards use" [ref=e701] - code - StaticText " / " - code - cell "Persist as the active board (writes ~/.hermes/kanban/current)." [ref=e702] - StaticText "Persist " - code - StaticText " as the active board (writes " - code - StaticText ")." - row - cell "boards show / boards current" [ref=e703] - code - StaticText " / " - code - cell "Print the currently-active board's name, DB path, and task counts." [ref=e704] - row - cell "boards rename \"\"" [ref=e705] - code - cell "Change a board's display name. Slug is immutable." [ref=e706] - row - cell "boards rm " [ref=e707] - code - cell "Archive (default) or hard-delete a board. --delete skips the archive step. Archived boards move to boards/_archived/-/. Refused for default." [ref=e708] - StaticText "Archive (default) or hard-delete a board. " - code - StaticText " skips the archive step. Archived boards move to " - code - StaticText ". Refused for " - code - StaticText "." - row - cell "create \"\"" [ref=e709] - code - cell "Create a new task on the active board. Flags: --body, --assignee, --parent (repeatable), --workspace scratch|worktree|dir:<path>, --tenant, --priority, --triage, --idempotency-key, --max-runtime, --max-retries, --skill (repeatable)." [ref=e710] - StaticText "Create a new task on the active board. Flags: " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (repeatable), " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText " (repeatable)." - row - cell "list / ls" [ref=e711] - code - StaticText " / " - code - cell "List tasks on the active board. Filter with --mine, --assignee, --status, --tenant, --archived, --json." [ref=e712] - StaticText "List tasks on the active board. Filter with " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "show <id>" [ref=e713] - code - cell "Show a task with comments and events. --json for machine output." [ref=e714] - StaticText "Show a task with comments and events. " - code - StaticText " for machine output." - row - cell "assign <id> <profile>" [ref=e715] - code - cell "Assign or reassign. Use none to unassign. Refused while task is running." [ref=e716] - StaticText "Assign or reassign. Use " - code - StaticText " to unassign. Refused while task is running." - row - cell "link <parent> <child>" [ref=e717] - code - cell "Add a dependency. Cycle-detected. Both tasks must be on the same board." [ref=e718] - row - cell "unlink <parent> <child>" [ref=e719] - code - cell "Remove a dependency." [ref=e720] - row - cell "claim <id>" [ref=e721] - code - cell "Atomically claim a ready task. Prints resolved workspace path." [ref=e722] - row - cell "comment <id> \"<text>\"" [ref=e723] - code - cell "Append a comment. The next worker that claims the task reads it as part of its kanban_show() response." [ref=e724] - StaticText "Append a comment. The next worker that claims the task reads it as part of its " - code - StaticText " response." - row - cell "complete <id>" [ref=e725] - code - cell "Mark task done. Flags: --result, --summary, --metadata." [ref=e726] - StaticText "Mark task done. Flags: " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "block <id> \"<reason>\"" [ref=e727] - code - cell "Mark task blocked for human input. Also appends the reason as a comment." [ref=e728] - row - cell "schedule <id> \"<reason>\"" [ref=e729] - code - cell "Park time-delay/follow-up work in scheduled so it is not shown as a human blocker." [ref=e730] - StaticText "Park time-delay/follow-up work in " - code - StaticText " so it is not shown as a human blocker." - row - cell "unblock <id>" [ref=e731] - code - cell "Return a blocked or scheduled task to ready (or todo if dependencies are still open)." [ref=e732] - StaticText "Return a blocked or scheduled task to ready (or " - code - StaticText " if dependencies are still open)." - row - cell "archive <id>" [ref=e733] - code - cell "Hide from default list. gc will remove scratch workspaces." [ref=e734] - StaticText "Hide from default list. " - code - StaticText " will remove scratch workspaces." - row - cell "tail <id>" [ref=e735] - code - cell "Follow a task's event stream." [ref=e736] - row - cell "dispatch" [ref=e737] - code - cell "One dispatcher pass on the active board. Flags: --dry-run, --max N, --failure-limit N, --json." [ref=e738] - StaticText "One dispatcher pass on the active board. Flags: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "context <id>" [ref=e739] - code - cell "Print the full context a worker would see (title + body + parent results + comments)." [ref=e740] - row - cell "specify <id> / specify --all" [ref=e741] - code - StaticText " / " - code - cell "Flesh out a triage-column task into a concrete spec (title + body with goal, approach, acceptance criteria) via the auxiliary LLM, then promote it to todo. Flags: --tenant (scope --all to one tenant), --author, --json. Configure the model under auxiliary.triage_specifier in config.yaml." [ref=e742] - StaticText "Flesh out a triage-column task into a concrete spec (title + body with goal, approach, acceptance criteria) via the auxiliary LLM, then promote it to " - code - StaticText ". Flags: " - code - StaticText " (scope " - code - StaticText " to one tenant), " - code - StaticText ", " - code - StaticText ". Configure the model under " - code - StaticText " in " - code - StaticText "." - row - cell "decompose <id> / decompose --all" [ref=e743] - code - StaticText " / " - code - cell "Fan a triage-column task out into a graph of child tasks routed to specialist profiles by description. Falls back to specify-style single-task promotion when the LLM decides the task doesn't benefit from fan-out. Same flags as specify. Configure the decomposer model under auxiliary.kanban_decomposer in config.yaml; kanban.orchestrator_profile only controls who owns the root/orchestration task after fan-out. Also runs automatically every dispatcher tick when kanban.auto_decompose: true (the default). See Auto vs Manual orchestration." [ref=e744] - StaticText "Fan a triage-column task out into a graph of child tasks routed to specialist profiles by description. Falls back to specify-style single-task promotion when the LLM decides the task doesn't benefit from fan-out. Same flags as " - code - StaticText ". Configure the decomposer model under " - code - StaticText " in " - code - StaticText "; " - code - StaticText " only controls who owns the root/orchestration task after fan-out. Also runs automatically every dispatcher tick when " - code - StaticText "kanban.auto_decompose: true" - StaticText " (the default). See " - link "Auto vs Manual orchestration" [ref=e1376] - StaticText "." - row - cell "gc" [ref=e745] - code - cell "Remove scratch workspaces for archived tasks." [ref=e746] - paragraph - StaticText "Examples:" - generic - generic [ref=e177] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e747] - paragraph - StaticText "Board resolution order (highest precedence first): " - code - StaticText "--board <slug>" - StaticText " flag → " - code - StaticText "HERMES_KANBAN_BOARD" - StaticText " env var → " - code - StaticText "~/.hermes/kanban/current" - StaticText " file → " - code - StaticText "default" - StaticText "." - paragraph - StaticText "All actions are also available as a slash command in the gateway (" - code - StaticText "/kanban …" - StaticText "), with the same argument surface — including " - code - StaticText "boards" - StaticText " subcommands and the " - code - StaticText "--board" - StaticText " flag." - paragraph - StaticText "For the full design — comparison with Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise, eight collaboration patterns, four user stories, concurrency correctness proof — see " - code - StaticText "docs/hermes-kanban-v1-spec.pdf" - StaticText " in the repository or the " - link "Kanban user guide" [ref=e178] - StaticText "." - heading "hermes egress Direct link to hermes-egress" [level=2, ref=e44] - code - StaticText "hermes egress" - link "Direct link to hermes-egress" [ref=e179] - StaticText "#" - paragraph - StaticText "Outbound credential-injection firewall for remote terminal sandboxes. Wraps the " - link "iron-proxy" [ref=e180] - StaticText " daemon — a TLS-intercepting proxy that swaps opaque proxy tokens for real upstream API credentials at the network boundary, so sandboxes never hold real keys. Disabled by default; see the full " - link "Egress proxy" [ref=e181] - StaticText " page for setup + architecture." - generic - generic [ref=e182] focusable [tabindex] - code - generic - generic - generic - generic - StaticText "hermes egress setup # interactive wizard: CA, mappings, config" - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - StaticText "hermes egress status --show-tokens # print proxy tokens in full (default: redacted)" - generic - generic - generic - generic - button "Toggle word wrap" [ref=e748] - button "Copy code to clipboard" [ref=e749] - heading "Common flows Direct link to Common flows" [level=3, ref=e45] - StaticText "Common flows" - link "Direct link to Common flows" [ref=e183] - StaticText "#" - generic - generic [ref=e184] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - StaticText "# Edit ~/.hermes/config.yaml proxy.extra_allowed_hosts: [api.example.com]" - generic - generic - generic - button "Toggle word wrap" [ref=e750] - button "Copy code to clipboard" [ref=e751] - heading "Diagnostic shortcuts Direct link to Diagnostic shortcuts" [level=3, ref=e46] - StaticText "Diagnostic shortcuts" - link "Direct link to Diagnostic shortcuts" [ref=e185] - StaticText "#" - generic - generic [ref=e186] focusable [tabindex] - code - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e752] - button "Copy code to clipboard" [ref=e753] - paragraph - StaticText "Common failure modes + recovery are covered in " - link "Egress proxy → Troubleshooting" [ref=e187] - StaticText "." - heading "hermes project Direct link to hermes-project" [level=2, ref=e47] - code - StaticText "hermes project" - link "Direct link to hermes-project" [ref=e188] - StaticText "#" - generic - generic [ref=e189] focusable [tabindex] - code - generic - generic - button "Toggle word wrap" [ref=e754] - button "Copy code to clipboard" [ref=e755] - paragraph - StaticText "Projects are human-named workspaces that can span multiple folders / repos. They anchor desktop session grouping and, when bound to a kanban board, give tasks a deterministic worktree + branch convention. State is per-profile." - table - rowgroup - row - columnheader "Subcommand" [ref=e1377] - columnheader "Description" [ref=e1378] - row - cell "create" [ref=e756] - code - cell "Create a new project." [ref=e757] - row - cell "list (alias ls)" [ref=e758] - code - StaticText " (alias " - code - StaticText ")" - cell "List projects." [ref=e759] - row - cell "show" [ref=e760] - code - cell "Show a project's details." [ref=e761] - row - cell "add-folder" [ref=e762] - code - cell "Add a folder / repo to a project." [ref=e763] - row - cell "remove-folder" [ref=e764] - code - cell "Remove a folder from a project." [ref=e765] - row - cell "rename" [ref=e766] - code - cell "Rename a project." [ref=e767] - row - cell "set-primary" [ref=e768] - code - cell "Set the primary folder." [ref=e769] - row - cell "use" [ref=e770] - code - cell "Set the active project." [ref=e771] - row - cell "archive" [ref=e772] - code - cell "Archive a project (recoverable)." [ref=e773] - row - cell "restore" [ref=e774] - code - cell "Restore an archived project." [ref=e775] - row - cell "bind-board" [ref=e776] - code - cell "Bind a kanban board to this project." [ref=e777] - heading "hermes webhook Direct link to hermes-webhook" [level=2, ref=e48] - code - StaticText "hermes webhook" - link "Direct link to hermes-webhook" [ref=e190] - StaticText "#" - generic - generic [ref=e191] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e778] - paragraph - StaticText "Manage dynamic webhook subscriptions for event-driven agent activation. Requires the webhook platform to be enabled in config — if not configured, prints setup instructions." - table - rowgroup - row - columnheader "Subcommand" [ref=e1379] - columnheader "Description" [ref=e1380] - row - cell "subscribe / add" [ref=e779] - code - StaticText " / " - code - cell "Create a webhook route. Returns the URL and HMAC secret to configure on your service." [ref=e780] - row - cell "list / ls" [ref=e781] - code - StaticText " / " - code - cell "Show all agent-created subscriptions." [ref=e782] - row - cell "remove / rm" [ref=e783] - code - StaticText " / " - code - cell "Delete a dynamic subscription. Static routes from config.yaml are not affected." [ref=e784] - row - cell "test" [ref=e785] - code - cell "Send a test POST to verify a subscription is working." [ref=e786] - heading "hermes webhook subscribe Direct link to hermes-webhook-subscribe" [level=3, ref=e49] - code - StaticText "hermes webhook subscribe" - link "Direct link to hermes-webhook-subscribe" [ref=e192] - StaticText "#" - generic - generic [ref=e193] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e787] - table - rowgroup - row - columnheader "Option" [ref=e1381] - columnheader "Description" [ref=e1382] - row - cell "--prompt" [ref=e788] - code - cell "Prompt template with {dot.notation} payload references." [ref=e789] - StaticText "Prompt template with " - code - StaticText " payload references." - row - cell "--events" [ref=e790] - code - cell "Comma-separated event types to accept (e.g. issues,pull_request). Empty = all." [ref=e791] - StaticText "Comma-separated event types to accept (e.g. " - code - StaticText "). Empty = all." - row - cell "--description" [ref=e792] - code - cell "Human-readable description." [ref=e793] - row - cell "--skills" [ref=e794] - code - cell "Comma-separated skill names to load for the agent run." [ref=e795] - row - cell "--deliver" [ref=e796] - code - cell "Delivery target: log (default), telegram, discord, slack, github_comment." [ref=e797] - StaticText "Delivery target: " - code - StaticText " (default), " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "--deliver-chat-id" [ref=e798] - code - cell "Target chat/channel ID for cross-platform delivery." [ref=e799] - row - cell "--secret" [ref=e800] - code - cell "Custom HMAC secret. Auto-generated if omitted." [ref=e801] - row - cell "--deliver-only" [ref=e802] - code - cell "Skip the agent — deliver the rendered --prompt as the literal message. Zero LLM cost, sub-second delivery. Requires --deliver to be a real target (not log)." [ref=e803] - StaticText "Skip the agent — deliver the rendered " - code - StaticText " as the literal message. Zero LLM cost, sub-second delivery. Requires " - code - StaticText " to be a real target (not " - code - StaticText ")." - row - cell "--script" [ref=e804] - code - cell "Filter/transform script under ~/.hermes/scripts/. The webhook payload is passed as JSON on stdin; JSON stdout replaces the payload, and empty stdout, [SILENT], or a nonzero exit code ignores the webhook. See Script Filters and Transforms." [ref=e805] - StaticText "Filter/transform script under " - code - StaticText ". The webhook payload is passed as JSON on stdin; JSON stdout replaces the payload, and empty stdout, " - code - StaticText ", or a nonzero exit code ignores the webhook. See " - link "Script Filters and Transforms" [ref=e1383] - StaticText "." - paragraph - StaticText "Subscriptions persist to " - code - StaticText "~/.hermes/webhook_subscriptions.json" - StaticText " and are hot-reloaded by the webhook adapter without a gateway restart." - heading "hermes doctor Direct link to hermes-doctor" [level=2, ref=e50] - code - StaticText "hermes doctor" - link "Direct link to hermes-doctor" [ref=e194] - StaticText "#" - generic - generic [ref=e195] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e806] - table - rowgroup - row - columnheader "Option" [ref=e1384] - columnheader "Description" [ref=e1385] - row - cell "--fix" [ref=e807] - code - cell "Attempt automatic repairs where possible." [ref=e808] - heading "hermes dump Direct link to hermes-dump" [level=2, ref=e51] - code - StaticText "hermes dump" - link "Direct link to hermes-dump" [ref=e196] - StaticText "#" - generic - generic [ref=e197] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e809] - paragraph - StaticText "Outputs a compact, plain-text summary of your entire Hermes setup. Designed to be copy-pasted into Discord, GitHub issues, or Telegram when asking for support — no ANSI colors, no special formatting, just data." - table - rowgroup - row - columnheader "Option" [ref=e1386] - columnheader "Description" [ref=e1387] - row - cell "--show-keys" [ref=e810] - code - cell "Show redacted API key prefixes (first and last 4 characters) instead of just set/not set." [ref=e811] - StaticText "Show redacted API key prefixes (first and last 4 characters) instead of just " - code - StaticText "/" - code - StaticText "." - heading "What it includes Direct link to What it includes" [level=3, ref=e52] - StaticText "What it includes" - link "Direct link to What it includes" [ref=e198] - StaticText "#" - table - rowgroup - row - columnheader "Section" [ref=e1388] - columnheader "Details" [ref=e1389] - row - cell "Header" [ref=e812] - strong - cell "Hermes version, release date, git commit hash" [ref=e813] - row - cell "Environment" [ref=e814] - strong - cell "OS, Python version, OpenAI SDK version" [ref=e815] - row - cell "Identity" [ref=e816] - strong - cell "Active profile name, HERMES_HOME path" [ref=e817] - row - cell "Model" [ref=e818] - strong - cell "Configured default model and provider" [ref=e819] - row - cell "Terminal" [ref=e820] - strong - cell "Backend type (local, docker, ssh, etc.)" [ref=e821] - row - cell "API keys" [ref=e822] - strong - cell "Presence check for all 22 provider/tool API keys" [ref=e823] - row - cell "Features" [ref=e824] - strong - cell "Enabled toolsets, MCP server count, memory provider" [ref=e825] - row - cell "Services" [ref=e826] - strong - cell "Gateway status, configured messaging platforms" [ref=e827] - row - cell "Workload" [ref=e828] - strong - cell "Cron job counts, installed skill count" [ref=e829] - row - cell "Config overrides" [ref=e830] - strong - cell "Any config values that differ from defaults" [ref=e831] - heading "Example output Direct link to Example output" [level=3, ref=e53] - StaticText "Example output" - link "Direct link to Example output" [ref=e199] - StaticText "#" - generic - generic [ref=e200] focusable [tabindex] - code - generic - generic - StaticText "version: 0.8.0 (2026.4.8) [af4abd2f]" - generic - StaticText "os: Linux 6.14.0-37-generic x86_64" - generic - StaticText "python: 3.11.14" - generic - StaticText "openai_sdk: 2.24.0" - generic - StaticText "profile: default" - generic - StaticText "hermes_home: ~/.hermes" - generic - StaticText "model: anthropic/claude-opus-4.6" - generic - StaticText "provider: openrouter" - generic - StaticText "terminal: local" - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - StaticText " toolsets: all" - generic - StaticText " mcp_servers: 0" - generic - StaticText " memory_provider: built-in" - generic - StaticText " gateway: running (systemd)" - generic - StaticText " platforms: telegram, discord" - generic - StaticText " cron_jobs: 3 active / 5 total" - generic - StaticText " skills: 42" - generic - generic - generic - StaticText " agent.max_turns: 250" - generic - StaticText " compression.threshold: 0.85" - generic - StaticText " display.streaming: True" - generic - button "Copy code to clipboard" [ref=e832] - heading "When to use Direct link to When to use" [level=3, ref=e54] - StaticText "When to use" - link "Direct link to When to use" [ref=e201] - StaticText "#" - list - listitem [level=1] - ListMarker "• " - StaticText "Reporting a bug on GitHub — paste the dump into your issue" - listitem [level=1] - ListMarker "• " - StaticText "Asking for help in Discord — share it in a code block" - listitem [level=1] - ListMarker "• " - StaticText "Comparing your setup to someone else's" - listitem [level=1] - ListMarker "• " - StaticText "Quick sanity check when something isn't working" - generic - image - StaticText "TIP" - paragraph - code - StaticText "hermes dump" - StaticText " is specifically designed for sharing. For interactive diagnostics, use " - code - StaticText "hermes doctor" - StaticText ". For a visual overview, use " - code - StaticText "hermes status" - StaticText "." - heading "hermes debug Direct link to hermes-debug" [level=2, ref=e55] - code - StaticText "hermes debug" - link "Direct link to hermes-debug" [ref=e202] - StaticText "#" - generic - generic [ref=e203] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e833] - paragraph - StaticText "Upload a debug report (system info + recent logs) to a paste service and get a shareable URL. Useful for quick support requests — includes everything a helper needs to diagnose your issue." - table - rowgroup - row - columnheader "Option" [ref=e1390] - columnheader "Description" [ref=e1391] - row - cell "--lines <N>" [ref=e834] - code - cell "Number of log lines to include per log file (default: 200)." [ref=e835] - row - cell "--expire <days>" [ref=e836] - code - cell "Paste expiry in days (default: 7)." [ref=e837] - row - cell "--nous" [ref=e838] - code - cell "Upload to Nous-internal diagnostics storage instead of a public paste service. Use this when Nous support asks for a private diagnostic bundle." [ref=e839] - row - cell "--local" [ref=e840] - code - cell "Print the report locally instead of uploading." [ref=e841] - row - cell "--no-redact" [ref=e842] - code - cell "Disable upload-time secret redaction. By default, uploads are redacted." [ref=e843] - paragraph - StaticText "The report includes system info (OS, Python version, Hermes version), recent agent, gateway, GUI/dashboard, and desktop logs (512 KB limit per file), and redacted API key status. By default, uploads are redacted so secrets are not included." - paragraph - StaticText "Default uploads use public paste services tried in order: paste.rs, dpaste.com. " - code - StaticText "--nous" - StaticText " uploads the same debug bundle to private Nous diagnostics storage instead; the returned viewer link is for the Nous team and auto-deletes after 14 days." - heading "Examples Direct link to Examples" [level=3, ref=e56] - StaticText "Examples" - link "Direct link to Examples" [ref=e204] - StaticText "#" - generic - generic [ref=e205] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e844] - button "Copy code to clipboard" [ref=e845] - heading "hermes backup Direct link to hermes-backup" [level=2, ref=e57] - code - StaticText "hermes backup" - link "Direct link to hermes-backup" [ref=e206] - StaticText "#" - generic - generic [ref=e207] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e846] - paragraph - StaticText "Create a zip archive of your Hermes configuration, skills, sessions, and data. The backup excludes the hermes-agent codebase itself." - table - rowgroup - row - columnheader "Option" [ref=e1392] - columnheader "Description" [ref=e1393] - row - cell "-o, --output <path>" [ref=e847] - code - StaticText ", " - code - cell "Output path for the zip file (default: ~/hermes-backup-<timestamp>.zip)." [ref=e848] - StaticText "Output path for the zip file (default: " - code - StaticText ")." - row - cell "-q, --quick" [ref=e849] - code - StaticText ", " - code - cell "Quick snapshot: only critical state files (config.yaml, state.db, .env, auth, cron jobs). Much faster than a full backup." [ref=e850] - row - cell "-l, --label <name>" [ref=e851] - code - StaticText ", " - code - cell "Label for the snapshot (only used with --quick)." [ref=e852] - StaticText "Label for the snapshot (only used with " - code - StaticText ")." - paragraph - StaticText "The backup uses SQLite's " - code - StaticText "backup()" - StaticText " API for safe copying, so it works correctly even when Hermes is running (WAL-mode safe)." - paragraph - strong - StaticText "What's excluded from the zip:" - list - listitem [level=1] - ListMarker "• " - code - StaticText "*.db-wal" - StaticText ", " - code - StaticText "*.db-shm" - StaticText ", " - code - StaticText "*.db-journal" - StaticText " — SQLite's WAL / shared-memory / journal sidecars. The " - code - StaticText "*.db" - StaticText " file already got a consistent snapshot via " - code - StaticText "sqlite3.backup()" - StaticText "; shipping the live sidecars alongside it would let a restore see a half-committed state." - listitem [level=1] - ListMarker "• " - code - StaticText "checkpoints/" - StaticText " — per-session trajectory caches. Hash-keyed and regenerated per session; wouldn't port cleanly to another install anyway." - listitem [level=1] - ListMarker "• " - StaticText "The " - code - StaticText "hermes-agent" - StaticText " code itself (this is a user-data backup, not a repo snapshot)." - heading "Examples Direct link to Examples" [level=3, ref=e58] - StaticText "Examples" - link "Direct link to Examples" [ref=e208] - StaticText "#" - generic - generic [ref=e209] focusable [tabindex] - code - generic - generic - generic - generic - generic - button "Toggle word wrap" [ref=e853] - button "Copy code to clipboard" [ref=e854] - heading "hermes checkpoints Direct link to hermes-checkpoints" [level=2, ref=e59] - code - StaticText "hermes checkpoints" - link "Direct link to hermes-checkpoints" [ref=e210] - StaticText "#" - generic - generic [ref=e211] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e855] - paragraph - StaticText "Inspect and manage the shadow git store at " - code - StaticText "~/.hermes/checkpoints/" - StaticText " — the storage layer behind the in-session " - code - StaticText "/rollback" - StaticText " command. Safe to run any time; does not require the agent to be running." - table - rowgroup - row - columnheader "Subcommand" [ref=e1394] - columnheader "Description" [ref=e1395] - row - cell "status (default)" [ref=e856] - code - StaticText " (default)" - cell "Show total size, project count, and per-project breakdown. Bare hermes checkpoints is equivalent." [ref=e857] - StaticText "Show total size, project count, and per-project breakdown. Bare " - code - StaticText " is equivalent." - row - cell "list" [ref=e858] - code - cell "Alias for status." [ref=e859] - StaticText "Alias for " - code - StaticText "." - row - cell "prune" [ref=e860] - code - cell "Force a cleanup sweep — delete orphan and stale projects, GC the store, enforce the size cap. Ignores the 24h idempotency marker." [ref=e861] - row - cell "clear" [ref=e862] - code - cell "Delete the entire checkpoint base. Irreversible; asks for confirmation unless -f." [ref=e863] - StaticText "Delete the entire checkpoint base. Irreversible; asks for confirmation unless " - code - StaticText "." - row - cell "clear-legacy" [ref=e864] - code - cell "Delete only the legacy-<timestamp>/ archives produced by the v1→v2 migration." [ref=e865] - StaticText "Delete only the " - code - StaticText " archives produced by the v1→v2 migration." - heading "Options Direct link to Options" [level=3, ref=e60] - StaticText "Options" - link "Direct link to Options" [ref=e212] - StaticText "#" - table - rowgroup - row - columnheader "Option" [ref=e1396] - columnheader "Subcommand" [ref=e1397] - columnheader "Description" [ref=e1398] - row - cell "--limit N" [ref=e866] - code - cell "status, list" [ref=e867] - code - StaticText ", " - code - cell "Max projects to list (default 20)." [ref=e868] - row - cell "--retention-days N" [ref=e869] - code - cell "prune" [ref=e870] - code - cell "Drop projects whose last_touch is older than N days (default 7)." [ref=e871] - StaticText "Drop projects whose " - code - StaticText " is older than N days (default 7)." - row - cell "--max-size-mb N" [ref=e872] - code - cell "prune" [ref=e873] - code - cell "After the orphan/stale pass, drop the oldest commit per project until total store size ≤ N MB (default 500)." [ref=e874] - row - cell "--keep-orphans" [ref=e875] - code - cell "prune" [ref=e876] - code - cell "Skip deleting projects whose working directory no longer exists." [ref=e877] - row - cell "-f, --force" [ref=e878] - code - StaticText ", " - code - cell "clear, clear-legacy" [ref=e879] - code - StaticText ", " - code - cell "Skip the confirmation prompt." [ref=e880] - heading "Examples Direct link to Examples" [level=3, ref=e61] - StaticText "Examples" - link "Direct link to Examples" [ref=e213] - StaticText "#" - generic - generic [ref=e214] focusable [tabindex] - code - generic - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e881] - paragraph - StaticText "See " - link "Checkpoints and /rollback" [ref=e215] - StaticText "Checkpoints and " - code - StaticText "/rollback" - StaticText " for the full architecture and the in-session commands." - heading "hermes import Direct link to hermes-import" [level=2, ref=e62] - code - StaticText "hermes import" - link "Direct link to hermes-import" [ref=e216] - StaticText "#" - generic - generic [ref=e217] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e882] - paragraph - StaticText "Restore a previously created Hermes backup into your Hermes home directory. All files in the archive overwrite existing files in your Hermes home; " - code - StaticText "--force" - StaticText " only skips the confirmation prompt that fires when the target already has a Hermes installation." - table - rowgroup - row - columnheader "Option" [ref=e1399] - columnheader "Description" [ref=e1400] - row - cell "-f, --force" [ref=e883] - code - StaticText ", " - code - cell "Skip the existing-installation confirmation prompt." [ref=e884] - generic - image - StaticText "WARNING" - paragraph - StaticText "Stop the gateway before importing to avoid conflicts with running processes." - heading "Examples Direct link to Examples" [level=3, ref=e63] - StaticText "Examples" - link "Direct link to Examples" [ref=e218] - StaticText "#" - generic - generic [ref=e219] focusable [tabindex] - code - generic - generic - generic - button "Toggle word wrap" [ref=e885] - button "Copy code to clipboard" [ref=e886] - heading "hermes logs Direct link to hermes-logs" [level=2, ref=e64] - code - StaticText "hermes logs" - link "Direct link to hermes-logs" [ref=e220] - StaticText "#" - generic - generic [ref=e221] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e887] - paragraph - StaticText "View, tail, and filter Hermes log files. All logs are stored in " - code - StaticText "~/.hermes/logs/" - StaticText " (or " - code - StaticText "<profile>/logs/" - StaticText " for non-default profiles)." - heading "Log files Direct link to Log files" [level=3, ref=e65] - StaticText "Log files" - link "Direct link to Log files" [ref=e222] - StaticText "#" - table - rowgroup - row - columnheader "Name" [ref=e1401] - columnheader "File" [ref=e1402] - columnheader "What it captures" [ref=e1403] - row - cell "agent (default)" [ref=e888] - code - StaticText " (default)" - cell "agent.log" [ref=e889] - code - cell "All agent activity — API calls, tool dispatch, session lifecycle (INFO and above)" [ref=e890] - row - cell "errors" [ref=e891] - code - cell "errors.log" [ref=e892] - code - cell "Warnings and errors only — a filtered subset of agent.log" [ref=e893] - row - cell "gateway" [ref=e894] - code - cell "gateway.log" [ref=e895] - code - cell "Messaging gateway activity — platform connections, message dispatch, webhook events" [ref=e896] - row - cell "gui" [ref=e897] - code - cell "gui.log" [ref=e898] - code - cell "Dashboard / TUI-gateway / PTY-bridge / websocket events" [ref=e899] - row - cell "desktop" [ref=e900] - code - cell "desktop.log" [ref=e901] - code - cell "Electron desktop app — boot, backend spawn output, and recent Python tracebacks" [ref=e902] - heading "Options Direct link to Options" [level=3, ref=e66] - StaticText "Options" - link "Direct link to Options" [ref=e223] - StaticText "#" - table - rowgroup - row - columnheader "Option" [ref=e1404] - columnheader "Description" [ref=e1405] - row - cell "log_name" [ref=e903] - code - cell "Which log to view: agent (default), errors, gateway, or list to show available files with sizes." [ref=e904] - StaticText "Which log to view: " - code - StaticText " (default), " - code - StaticText ", " - code - StaticText ", or " - code - StaticText " to show available files with sizes." - row - cell "-n, --lines <N>" [ref=e905] - code - StaticText ", " - code - cell "Number of lines to show (default: 50)." [ref=e906] - row - cell "-f, --follow" [ref=e907] - code - StaticText ", " - code - cell "Follow the log in real time, like tail -f. Press Ctrl+C to stop." [ref=e908] - StaticText "Follow the log in real time, like " - code - StaticText ". Press Ctrl+C to stop." - row - cell "--level <LEVEL>" [ref=e909] - code - cell "Minimum log level to show: DEBUG, INFO, WARNING, ERROR, CRITICAL." [ref=e910] - StaticText "Minimum log level to show: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - row - cell "--session <ID>" [ref=e911] - code - cell "Filter lines containing a session ID substring." [ref=e912] - row - cell "--since <TIME>" [ref=e913] - code - cell "Show lines from a relative time ago: 30m, 1h, 2d, etc. Supports s (seconds), m (minutes), h (hours), d (days)." [ref=e914] - StaticText "Show lines from a relative time ago: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", etc. Supports " - code - StaticText " (seconds), " - code - StaticText " (minutes), " - code - StaticText " (hours), " - code - StaticText " (days)." - row - cell "--component <NAME>" [ref=e915] - code - cell "Filter by component: gateway, agent, tools, cli, cron." [ref=e916] - StaticText "Filter by component: " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText "." - heading "Examples Direct link to Examples" [level=3, ref=e67] - StaticText "Examples" - link "Direct link to Examples" [ref=e224] - StaticText "#" - generic - generic [ref=e225] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e917] - heading "Filtering Direct link to Filtering" [level=3, ref=e68] - StaticText "Filtering" - link "Direct link to Filtering" [ref=e226] - StaticText "#" - paragraph - StaticText "Filters can be combined. When multiple filters are active, a log line must pass " - strong - StaticText "all" - StaticText " of them to be shown:" - generic - generic [ref=e227] focusable [tabindex] - code - generic - generic - button "Copy code to clipboard" [ref=e918] - paragraph - StaticText "Lines without a parseable timestamp are included when " - code - StaticText "--since" - StaticText " is active (they may be continuation lines from a multi-line log entry). Lines without a detectable level are included when " - code - StaticText "--level" - StaticText " is active." - heading "Log rotation Direct link to Log rotation" [level=3, ref=e69] - StaticText "Log rotation" - link "Direct link to Log rotation" [ref=e228] - StaticText "#" - paragraph - StaticText "Hermes uses Python's " - code - StaticText "RotatingFileHandler" - StaticText ". Old logs are rotated automatically — look for " - code - StaticText "agent.log.1" - StaticText ", " - code - StaticText "agent.log.2" - StaticText ", etc. The " - code - StaticText "hermes logs list" - StaticText " subcommand shows all log files including rotated ones." - heading "hermes prompt-size Direct link to hermes-prompt-size" [level=2, ref=e70] - code - StaticText "hermes prompt-size" - link "Direct link to hermes-prompt-size" [ref=e229] - StaticText "#" - generic - generic [ref=e230] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e919] - paragraph - StaticText "Reports the fixed prompt budget for a fresh session — what gets sent on every API call " - emphasis - StaticText "before" - StaticText " any conversation content. Useful when a downstream adapter or proxy has a tighter prompt budget than the model's context window, or when you want to see which block (skills index, memory, profile) dominates." - paragraph - StaticText "It builds the same system prompt the agent would, then breaks it down:" - list - listitem [level=1] - ListMarker "• " - strong - StaticText "System prompt total" - StaticText " — full assembled prompt (identity, guidance, skills index, context files, memory, profile, timestamp)." - listitem [level=1] - ListMarker "• " - strong - StaticText "Skills index" - StaticText " — the " - code - StaticText "<available_skills>" - StaticText " block. This is often the largest single block when many skills are installed." - listitem [level=1] - ListMarker "• " - strong - StaticText "Memory" - StaticText " and " - strong - StaticText "user profile" - StaticText " — your " - code - StaticText "MEMORY.md" - StaticText " / " - code - StaticText "USER.md" - StaticText " snapshots." - listitem [level=1] - ListMarker "• " - strong - StaticText "Prompt tiers" - StaticText " — stable / context / volatile, matching how Hermes layers the prompt for cache-friendliness." - listitem [level=1] - ListMarker "• " - strong - StaticText "Tool schemas" - StaticText " — the JSON for all enabled tools (the other half of the fixed per-call payload)." - paragraph - StaticText "Runs entirely offline — no API call, works with no credentials configured." - generic - generic [ref=e231] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - button "Copy code to clipboard" [ref=e920] - generic - image - StaticText "TIP" - paragraph - StaticText "The skills index and tool schemas scale with how many skills and tools you have enabled. To shrink the prompt, disable unused toolsets (" - code - StaticText "hermes tools" - StaticText ") or uninstall skills you don't need (" - code - StaticText "hermes skills" - StaticText "). Context files (AGENTS.md, .cursorrules) in your current directory also count toward the total." - heading "hermes config Direct link to hermes-config" [level=2, ref=e71] - code - StaticText "hermes config" - link "Direct link to hermes-config" [ref=e232] - StaticText "#" - generic - generic [ref=e233] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e921] - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1406] - columnheader "Description" [ref=e1407] - row - cell "show" [ref=e922] - code - cell "Show current config values." [ref=e923] - row - cell "edit" [ref=e924] - code - cell "Open config.yaml in your editor." [ref=e925] - StaticText "Open " - code - StaticText " in your editor." - row - cell "get <key> [--json]" [ref=e926] - code - cell "Print a single config value by dotted key (e.g. hermes config get model.default). --json emits machine-readable output." [ref=e927] - StaticText "Print a single config value by dotted key (e.g. " - code - StaticText "). " - code - StaticText " emits machine-readable output." - row - cell "set <key> <value>" [ref=e928] - code - cell "Set a config value." [ref=e929] - row - cell "unset <key>" [ref=e930] - code - cell "Remove a config key, reverting it to the built-in default." [ref=e931] - row - cell "path" [ref=e932] - code - cell "Print the config file path." [ref=e933] - row - cell "env-path" [ref=e934] - code - cell "Print the .env file path." [ref=e935] - StaticText "Print the " - code - StaticText " file path." - row - cell "check" [ref=e936] - code - cell "Check for missing or stale config." [ref=e937] - row - cell "migrate" [ref=e938] - code - cell "Add newly introduced options interactively." [ref=e939] - heading "hermes pairing Direct link to hermes-pairing" [level=2, ref=e72] - code - StaticText "hermes pairing" - link "Direct link to hermes-pairing" [ref=e234] - StaticText "#" - generic - generic [ref=e235] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e940] - table - rowgroup - row - columnheader "Subcommand" [ref=e1408] - columnheader "Description" [ref=e1409] - row - cell "list" [ref=e941] - code - cell "Show pending and approved users." [ref=e942] - row - cell "approve <platform> <code>" [ref=e943] - code - cell "Approve a pairing code." [ref=e944] - row - cell "revoke <platform> <user-id>" [ref=e945] - code - cell "Revoke a user's access." [ref=e946] - row - cell "clear-pending" [ref=e947] - code - cell "Clear pending pairing codes." [ref=e948] - heading "hermes skills Direct link to hermes-skills" [level=2, ref=e73] - code - StaticText "hermes skills" - link "Direct link to hermes-skills" [ref=e236] - StaticText "#" - generic - generic [ref=e237] focusable [tabindex] - code - generic - button "Copy code to clipboard" [ref=e949] - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1410] - columnheader "Description" [ref=e1411] - row - cell "browse" [ref=e950] - code - cell "Paginated browser for skill registries." [ref=e951] - row - cell "search" [ref=e952] - code - cell "Search skill registries." [ref=e953] - row - cell "install" [ref=e954] - code - cell "Install a skill." [ref=e955] - row - cell "inspect" [ref=e956] - code - cell "Preview a skill without installing it." [ref=e957] - row - cell "list" [ref=e958] - code - cell "List installed skills." [ref=e959] - row - cell "check" [ref=e960] - code - cell "Check installed hub skills for upstream updates." [ref=e961] - row - cell "update" [ref=e962] - code - cell "Reinstall hub skills with upstream changes when available." [ref=e963] - row - cell "audit" [ref=e964] - code - cell "Re-scan installed hub skills." [ref=e965] - row - cell "uninstall" [ref=e966] - code - cell "Remove a hub-installed skill." [ref=e967] - row - cell "reset" [ref=e968] - code - cell "Un-stick a bundled skill flagged as user_modified by clearing its manifest entry. With --restore, also replaces the user copy with the bundled version." [ref=e969] - StaticText "Un-stick a bundled skill flagged as " - code - StaticText " by clearing its manifest entry. With " - code - StaticText ", also replaces the user copy with the bundled version." - row - cell "opt-out" [ref=e970] - code - cell "Stop bundled skills from being seeded into the active profile. Writes a .no-bundled-skills marker so the installer, hermes update, and any sync skip bundled-skill seeding. Safe by default — nothing on disk is touched. With --remove, also deletes already-present bundled skills that are unmodified (user-edited, hub-installed, and hand-written skills are never removed; previews and confirms first, --yes to skip)." [ref=e971] - StaticText "Stop bundled skills from being seeded into the active profile. Writes a " - code - StaticText " marker so the installer, " - code - StaticText ", and any sync skip bundled-skill seeding. Safe by default — nothing on disk is touched. With " - code - StaticText ", also deletes already-present bundled skills that are " - strong - StaticText " (user-edited, hub-installed, and hand-written skills are never removed; previews and confirms first, " - code - StaticText " to skip)." - row - cell "opt-in" [ref=e972] - code - cell "Undo opt-out by removing the .no-bundled-skills marker so bundled skills are seeded again on the next hermes update. With --sync, re-seed immediately." [ref=e973] - StaticText "Undo " - code - StaticText " by removing the " - code - StaticText " marker so bundled skills are seeded again on the next " - code - StaticText ". With " - code - StaticText ", re-seed immediately." - row - cell "publish" [ref=e974] - code - cell "Publish a skill to a registry." [ref=e975] - row - cell "snapshot" [ref=e976] - code - cell "Export/import skill configurations." [ref=e977] - row - cell "tap" [ref=e978] - code - cell "Manage custom skill sources." [ref=e979] - row - cell "config" [ref=e980] - code - cell "Interactive enable/disable configuration for skills by platform." [ref=e981] - paragraph - StaticText "Common examples:" - generic - generic [ref=e238] focusable [tabindex] - code - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - generic - StaticText "hermes skills opt-in --sync # undo: remove marker and re-seed now" - generic - button "Toggle word wrap" [ref=e982] - button "Copy code to clipboard" [ref=e983] - paragraph - StaticText "Notes:" - list - listitem [level=1] - ListMarker "• " - code - StaticText " can override non-dangerous policy blocks for third-party/community skills." - listitem [level=1] - ListMarker "• " - code - StaticText " does not override a " - code - StaticText " scan verdict." - listitem [level=1] - ListMarker "• " - code - StaticText " searches the public " - code - StaticText " directory." - listitem [level=1] - ListMarker "• " - code - StaticText " lets you point Hermes at a site exposing " - code - StaticText "." - listitem [level=1] - ListMarker "• " - code - StaticText " searches " - link "browse.sh" [ref=e984] - StaticText "'s catalog of 200+ site-specific browser-automation skills. Identifiers look like " - code - StaticText "." - listitem [level=1] - ListMarker "• " - StaticText "Passing an " - code - StaticText " URL installs " - code - StaticText " plus explicitly referenced files under " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", " - code - StaticText ", and " - code - StaticText ". When frontmatter has no " - code - StaticText " and the URL slug isn't a valid identifier, an interactive terminal prompts for a name; non-interactive surfaces (" - code - StaticText " inside the TUI, gateway platforms) require " - code - StaticText " instead." - heading "hermes bundles Direct link to hermes-bundles" [level=2, ref=e74] - code - StaticText "hermes bundles" - link "Direct link to hermes-bundles" [ref=e239] - StaticText "#" - generic - generic [ref=e240] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e985] - paragraph - StaticText "Skill bundles group several skills under one " - code - StaticText "/<bundle-name>" - StaticText " slash command. Invoking the bundle loads every referenced skill into a single combined user message. Storage: " - code - StaticText "~/.hermes/skill-bundles/<slug>.yaml" - StaticText ". See " - link "Skill Bundles" [ref=e241] - StaticText " for the YAML schema and behavior." - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1412] - columnheader "Description" [ref=e1413] - row - cell "list" [ref=e986] - cell "List installed bundles (default when no subcommand given)" [ref=e987] - row - cell "show <name>" [ref=e988] - cell "Show one bundle's name, description, skills, and file path" [ref=e989] - row - cell "create <name>" [ref=e990] - cell "Create a new bundle. Pass --skill <id> (repeat) or omit for interactive entry. --description, --instruction, --force available." [ref=e991] - row - cell "delete <name>" [ref=e992] - cell "Remove a bundle file" [ref=e993] - row - cell "reload" [ref=e994] - cell "Re-scan ~/.hermes/skill-bundles/ and report added/removed bundles" [ref=e995] - paragraph - StaticText "Examples:" - generic - generic [ref=e242] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e996] - paragraph - StaticText "In a chat session, " - code - StaticText "/bundles" - StaticText " lists installed bundles and " - code - StaticText "/<bundle-name>" - StaticText " loads one." - heading "hermes curator Direct link to hermes-curator" [level=2, ref=e75] - code - StaticText "hermes curator" - link "Direct link to hermes-curator" [ref=e243] - StaticText "#" - generic - generic [ref=e244] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e997] - paragraph - StaticText "The curator is an auxiliary-model background task that periodically reviews agent-created skills, prunes stale ones, consolidates overlaps, and archives obsolete skills. Bundled and hub-installed skills are never touched. Archives are recoverable; auto-deletion never happens." - table - rowgroup - row - columnheader "Subcommand" [ref=e1414] - columnheader "Description" [ref=e1415] - row - cell "status" [ref=e998] - cell "Show curator status and skill stats" [ref=e999] - row - cell "run" [ref=e1000] - cell "Trigger a curator review now (blocks until the LLM pass finishes)" [ref=e1001] - row - cell "run --background" [ref=e1002] - cell "Start the LLM pass in a background thread and return immediately" [ref=e1003] - row - cell "run --dry-run" [ref=e1004] - cell "Preview only — produce the review report with no mutations" [ref=e1005] - row - cell "backup" [ref=e1006] - cell "Take a manual tar.gz snapshot of ~/.hermes/skills/ (curator also snapshots automatically before every real run)" [ref=e1007] - row - cell "rollback" [ref=e1008] - cell "Restore ~/.hermes/skills/ from a snapshot (defaults to newest)" [ref=e1009] - row - cell "rollback --list" [ref=e1010] - cell "List available snapshots" [ref=e1011] - row - cell "rollback --id <ts>" [ref=e1012] - cell "Restore a specific snapshot by id" [ref=e1013] - row - cell "rollback -y" [ref=e1014] - cell "Skip the confirmation prompt" [ref=e1015] - row - cell "pause" [ref=e1016] - cell "Pause the curator until resumed" [ref=e1017] - row - cell "resume" [ref=e1018] - cell "Resume a paused curator" [ref=e1019] - row - cell "pin <skill>" [ref=e1020] - cell "Pin a skill so the curator never auto-transitions it" [ref=e1021] - row - cell "unpin <skill>" [ref=e1022] - cell "Unpin a skill" [ref=e1023] - row - cell "restore <skill>" [ref=e1024] - cell "Restore an archived skill" [ref=e1025] - row - cell "archive <skill>" [ref=e1026] - cell "Archive a skill manually" [ref=e1027] - row - cell "prune" [ref=e1028] - cell "Manually prune skills the curator would normally clean up" [ref=e1029] - row - cell "list-archived" [ref=e1030] - cell "List archived skills (recoverable via restore)" [ref=e1031] - paragraph - StaticText "On a fresh install the first scheduled pass is deferred by one full " - code - StaticText "interval_hours" - StaticText " (7 days by default) — the gateway will not curate immediately on the first tick after " - code - StaticText "hermes update" - StaticText ". Use " - code - StaticText "hermes curator run --dry-run" - StaticText " to preview before that happens." - paragraph - StaticText "See " - link "Curator" [ref=e245] - StaticText " for behavior and config." - heading "hermes moa Direct link to hermes-moa" [level=2, ref=e76] - code - StaticText "hermes moa" - link "Direct link to hermes-moa" [ref=e246] - StaticText "#" - paragraph - StaticText "Configure named Mixture of Agents presets. Presets appear as selectable models under a " - code - StaticText "Mixture of Agents" - StaticText " provider in every model picker; " - code - StaticText "/moa <prompt>" - StaticText " runs one prompt through the default preset." - generic - generic [ref=e247] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1032] - paragraph - code - StaticText "hermes moa configure" - StaticText " reuses Hermes' provider → model picker for each reference model and the aggregator. A preset is an execution-mode configuration, not a primary model or provider." - heading "hermes fallback Direct link to hermes-fallback" [level=2, ref=e77] - code - StaticText "hermes fallback" - link "Direct link to hermes-fallback" [ref=e248] - StaticText "#" - generic - generic [ref=e249] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1033] - paragraph - StaticText "Manage the fallback provider chain. Fallback providers are tried in order when the primary model fails with rate-limit, overload, or connection errors." - table - rowgroup - row - columnheader "Subcommand" [ref=e1416] - columnheader "Description" [ref=e1417] - row - cell "list (alias: ls)" [ref=e1034] - StaticText " (alias: " - cell "Show the current fallback chain (default when no subcommand)" [ref=e1035] - row - cell "add" [ref=e1036] - cell "Pick a provider + model (same picker as hermes model) and append to the chain" [ref=e1037] - row - cell "remove (alias: rm)" [ref=e1038] - StaticText " (alias: " - cell "Pick an entry to delete from the chain" [ref=e1039] - row - cell "clear" [ref=e1040] - cell "Remove all fallback entries" [ref=e1041] - paragraph - StaticText "See " - link "Fallback Providers" [ref=e250] - StaticText "." - heading "hermes hooks Direct link to hermes-hooks" [level=2, ref=e78] - code - StaticText "hermes hooks" - link "Direct link to hermes-hooks" [ref=e251] - StaticText "#" - generic - generic [ref=e252] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1042] - paragraph - StaticText "Inspect shell-script hooks declared in " - code - StaticText "~/.hermes/config.yaml" - StaticText ", test them against synthetic payloads, and manage the first-use consent allowlist at " - code - StaticText "~/.hermes/shell-hooks-allowlist.json" - StaticText "." - table - rowgroup - row - columnheader "Subcommand" [ref=e1418] - columnheader "Description" [ref=e1419] - row - cell "list (alias: ls)" [ref=e1043] - StaticText " (alias: " - cell "List configured hooks with matcher, timeout, and consent status" [ref=e1044] - row - cell "test <event>" [ref=e1045] - cell "Fire every hook matching <event> against a synthetic payload" [ref=e1046] - row - cell "revoke (aliases: remove, rm)" [ref=e1047] - StaticText " (aliases: " - cell "Remove a command's allowlist entries (takes effect on next restart)" [ref=e1048] - row - cell "doctor" [ref=e1049] - cell "Check each configured hook: exec bit, allowlist, mtime drift, JSON validity, and synthetic run timing" [ref=e1050] - paragraph - StaticText "See " - link "Hooks" [ref=e253] - StaticText " for event signatures and payload shapes." - heading "hermes memory Direct link to hermes-memory" [level=2, ref=e79] - code - StaticText "hermes memory" - link "Direct link to hermes-memory" [ref=e254] - StaticText "#" - generic - generic [ref=e255] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1051] - paragraph - StaticText "Set up and manage external memory provider plugins. Available providers: honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory. Only one external provider can be active at a time. Built-in memory (MEMORY.md/USER.md) is always active." - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1420] - columnheader "Description" [ref=e1421] - row - cell "setup" [ref=e1052] - cell "Interactive provider selection and configuration." [ref=e1053] - row - cell "status" [ref=e1054] - cell "Show current memory provider config." [ref=e1055] - row - cell "off" [ref=e1056] - cell "Disable external provider (built-in only)." [ref=e1057] - generic - image - StaticText "PROVIDER-SPECIFIC SUBCOMMANDS" - paragraph - StaticText "When an external memory provider is active, it may register its own top-level " - code - StaticText "hermes <provider>" - StaticText " command for provider-specific management (e.g. " - code - StaticText "hermes honcho" - StaticText " when Honcho is active). Inactive providers do not expose their subcommands. Run " - code - StaticText "hermes --help" - StaticText " to see what's currently wired in." - heading "hermes acp Direct link to hermes-acp" [level=2, ref=e80] - code - StaticText "hermes acp" - link "Direct link to hermes-acp" [ref=e256] - StaticText "#" - generic - generic [ref=e257] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1058] - paragraph - StaticText "Starts Hermes as an ACP (Agent Client Protocol) stdio server for editor integration." - paragraph - StaticText "Related entrypoints:" - generic - generic [ref=e258] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1059] - paragraph - StaticText "Install support first:" - generic - generic [ref=e259] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1060] - paragraph - StaticText "See " - link "ACP Editor Integration" [ref=e260] - StaticText " and " - link "ACP Internals" [ref=e261] - StaticText "." - heading "hermes mcp Direct link to hermes-mcp" [level=2, ref=e81] - code - StaticText "hermes mcp" - link "Direct link to hermes-mcp" [ref=e262] - StaticText "#" - generic - generic [ref=e263] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1061] - paragraph - StaticText "Manage MCP (Model Context Protocol) server configurations and run Hermes as an MCP server." - table - rowgroup - row - columnheader "Subcommand" [ref=e1422] - columnheader "Description" [ref=e1423] - row - cell "(none) or picker" [ref=e1062] - cell "Interactive catalog picker — browse Nous-approved MCPs and install/enable/disable." [ref=e1063] - row - cell "catalog" [ref=e1064] - cell "List Nous-approved MCPs (plain text, scriptable)." [ref=e1065] - row - cell "install <name>" [ref=e1066] - cell "Install a catalog entry (e.g. hermes mcp install n8n)." [ref=e1067] - row - cell "serve [-v|--verbose]" [ref=e1068] - cell "Run Hermes as an MCP server — expose conversations to other agents." [ref=e1069] - row - cell "add <name> [--url URL] [--command CMD] [--auth oauth|header] [--args ...]" [ref=e1070] - cell "Add a custom MCP server with automatic tool discovery. --args passes the remaining argv to the stdio command, so put it last." [ref=e1071] - row - cell "remove <name> (alias: rm)" [ref=e1072] - StaticText " (alias: " - cell "Remove an MCP server from config." [ref=e1073] - row - cell "list (alias: ls)" [ref=e1074] - StaticText " (alias: " - cell "List configured MCP servers." [ref=e1075] - row - cell "test <name>" [ref=e1076] - cell "Test connection to an MCP server." [ref=e1077] - row - cell "configure <name> (alias: config)" [ref=e1078] - StaticText " (alias: " - cell "Toggle tool selection for a server." [ref=e1079] - row - cell "login <name>" [ref=e1080] - cell "Force re-authentication for an OAuth-based MCP server." [ref=e1081] - paragraph - StaticText "See " - link "MCP Config Reference" [ref=e264] - StaticText ", " - link "Use MCP with Hermes" [ref=e265] - StaticText ", and " - link "MCP Server Mode" [ref=e266] - StaticText "." - heading "hermes plugins Direct link to hermes-plugins" [level=2, ref=e82] - code - StaticText "hermes plugins" - link "Direct link to hermes-plugins" [ref=e267] - StaticText "#" - generic - generic [ref=e268] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1082] - paragraph - StaticText "Unified plugin management — general plugins, memory providers, and context engines in one place. Running " - code - StaticText "hermes plugins" - StaticText " with no subcommand opens a composite interactive screen with two sections:" - list - listitem [level=1] - ListMarker "• " - strong - StaticText " — multi-select checkboxes to enable/disable installed plugins" - listitem [level=1] - ListMarker "• " - strong - StaticText " — single-select configuration for Memory Provider and Context Engine. Press ENTER on a category to open a radio picker." - table - rowgroup - row - columnheader "Subcommand" [ref=e1424] - columnheader "Description" [ref=e1425] - row - cell "(none)" [ref=e1083] - cell "Composite interactive UI — general plugin toggles + provider plugin configuration." [ref=e1084] - row - cell "install <identifier> [--force]" [ref=e1085] - cell "Install a plugin from a Git URL or owner/repo." [ref=e1086] - row - cell "update <name>" [ref=e1087] - cell "Pull latest changes for an installed plugin." [ref=e1088] - row - cell "remove <name> (aliases: rm, uninstall)" [ref=e1089] - StaticText " (aliases: " - cell "Remove an installed plugin." [ref=e1090] - row - cell "enable <name>" [ref=e1091] - cell "Enable a disabled plugin." [ref=e1092] - row - cell "disable <name>" [ref=e1093] - cell "Disable a plugin without removing it." [ref=e1094] - row - cell "list (alias: ls)" [ref=e1095] - StaticText " (alias: " - cell "List installed plugins with enabled/disabled status." [ref=e1096] - paragraph - StaticText "Provider plugin selections are saved to " - code - StaticText "config.yaml" - StaticText ":" - list - listitem [level=1] - ListMarker "• " - code - StaticText " — active memory provider (empty = built-in only)" - listitem [level=1] - ListMarker "• " - code - StaticText " — active context engine (" - code - StaticText " = built-in default)" - paragraph - StaticText "General plugin disabled list is stored in " - code - StaticText "config.yaml" - StaticText " under " - code - StaticText "plugins.disabled" - StaticText "." - paragraph - StaticText "See " - link "Plugins" [ref=e269] - StaticText " and " - link "Build a Hermes Plugin" [ref=e270] - StaticText "." - heading "hermes tools Direct link to hermes-tools" [level=2, ref=e83] - code - StaticText "hermes tools" - link "Direct link to hermes-tools" [ref=e271] - StaticText "#" - generic - generic [ref=e272] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1097] - table - rowgroup - row - columnheader "Option" [ref=e1426] - columnheader "Description" [ref=e1427] - row - cell "--summary" [ref=e1098] - cell "Print the current enabled-tools summary and exit." [ref=e1099] - paragraph - StaticText "Without " - code - StaticText "--summary" - StaticText ", this launches the interactive per-platform tool configuration UI." - heading "hermes computer-use Direct link to hermes-computer-use" [level=2, ref=e84] - code - StaticText "hermes computer-use" - link "Direct link to hermes-computer-use" [ref=e273] - StaticText "#" - generic - generic [ref=e274] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1100] - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1428] - columnheader "Description" [ref=e1429] - row - cell "install" [ref=e1101] - cell "Run the upstream cua-driver installer (macOS, Windows, and Linux)." [ref=e1102] - row - cell "install --upgrade" [ref=e1103] - cell "Re-run the installer even if cua-driver is already on PATH. The upstream script always pulls the latest release, so this performs an in-place upgrade." [ref=e1104] - row - cell "status" [ref=e1105] - cell "Print whether cua-driver is on $PATH and which version is installed." [ref=e1106] - paragraph - code - StaticText "hermes computer-use install" - StaticText " is the stable entry point for installing the " - link "cua-driver" [ref=e275] - StaticText " binary used by the " - code - StaticText "computer_use" - StaticText " toolset. It runs the same upstream installer that " - code - StaticText "hermes tools" - StaticText " invokes when you first enable Computer Use, so it's safe to use for re-running the install if the toolset toggle didn't trigger it (for example, on returning-user setups)." - paragraph - code - StaticText "hermes update" - StaticText " automatically re-runs the upstream installer at the end of the update if cua-driver is on PATH, so most users will not need to call " - code - StaticText "--upgrade" - StaticText " manually. Use it when upstream ships a fix you want right now without waiting for the next Hermes update." - heading "hermes pets Direct link to hermes-pets" [level=2, ref=e85] - code - StaticText "hermes pets" - link "Direct link to hermes-pets" [ref=e276] - StaticText "#" - generic - generic [ref=e277] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1107] - paragraph - link "Petdex" [ref=e278] - StaticText " is a public gallery of animated sprite pets for coding agents. Install one and Hermes shows it reacting to agent activity across the CLI, TUI, and desktop app." - table - rowgroup - row - columnheader "Subcommand" [ref=e1430] - columnheader "Description" [ref=e1431] - row - cell "list" [ref=e1108] - cell "Browse the petdex gallery." [ref=e1109] - row - cell "install" [ref=e1110] - cell "Install a pet from the gallery." [ref=e1111] - row - cell "select" [ref=e1112] - cell "Set the active pet (writes display.pet.*)." [ref=e1113] - row - cell "show" [ref=e1114] - cell "Animate the active pet in the terminal." [ref=e1115] - row - cell "off" [ref=e1116] - cell "Disable the pet display." [ref=e1117] - row - cell "scale" [ref=e1118] - cell "Resize the pet everywhere (display.pet.scale)." [ref=e1119] - row - cell "remove" [ref=e1120] - cell "Delete an installed pet." [ref=e1121] - row - cell "doctor" [ref=e1122] - cell "Check pet setup + terminal graphics support." [ref=e1123] - paragraph - StaticText "You can also generate a brand-new pet from a text description with the " - code - StaticText "/hatch" - StaticText " slash command. See " - link "Pets" [ref=e279] - StaticText "." - heading "hermes sessions Direct link to hermes-sessions" [level=2, ref=e86] - code - StaticText "hermes sessions" - link "Direct link to hermes-sessions" [ref=e280] - StaticText "#" - generic - generic [ref=e281] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1124] - paragraph - StaticText "Subcommands:" - table - rowgroup - row - columnheader "Subcommand" [ref=e1432] - columnheader "Description" [ref=e1433] - row - cell "list" [ref=e1125] - cell "List recent sessions." [ref=e1126] - row - cell "browse" [ref=e1127] - cell "Interactive session picker with search and resume." [ref=e1128] - row - cell "export <output> [--session-id ID]" [ref=e1129] - cell "Export sessions to JSONL." [ref=e1130] - row - cell "delete <session-id>" [ref=e1131] - cell "Delete one session." [ref=e1132] - row - cell "prune" [ref=e1133] - cell "Delete sessions matching filters: time bounds --older-than/--newer-than/--before/--after (durations like 5h/2d, bare days, or ISO timestamps); attributes --source, --title, --model, --provider, --branch, --end-reason, --user, --chat-id, --chat-type, --cwd; numeric bounds --min/--max-messages, --min/--max-tokens, --min/--max-cost, --min/--max-tool-calls; plus --include-archived, --dry-run, --yes. Default: older than 90 days." [ref=e1134] - StaticText "Delete sessions matching filters: time bounds " - StaticText ". Default: older than 90 days." - row - cell "archive" [ref=e1135] - cell "Bulk-archive (soft-hide, no deletion) sessions matching the same filters as prune. Requires at least one filter." [ref=e1136] - row - cell "stats" [ref=e1137] - cell "Show session-store statistics." [ref=e1138] - row - cell "rename <session-id> <title>" [ref=e1139] - cell "Set or change a session title." [ref=e1140] - heading "hermes insights Direct link to hermes-insights" [level=2, ref=e87] - code - StaticText "hermes insights" - link "Direct link to hermes-insights" [ref=e282] - StaticText "#" - generic - generic [ref=e283] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1141] - table - rowgroup - row - columnheader "Option" [ref=e1434] - columnheader "Description" [ref=e1435] - row - cell "--days <n>" [ref=e1142] - cell "Analyze the last n days (default: 30)." [ref=e1143] - StaticText " days (default: 30)." - row - cell "--source <platform>" [ref=e1144] - cell "Filter by source such as cli, telegram, or discord." [ref=e1145] - heading "hermes claw Direct link to hermes-claw" [level=2, ref=e88] - code - StaticText "hermes claw" - link "Direct link to hermes-claw" [ref=e284] - StaticText "#" - generic - generic [ref=e285] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1146] - paragraph - StaticText "Migrate your OpenClaw setup to Hermes. Reads from " - code - StaticText "~/.openclaw" - StaticText " (or a custom path) and writes to " - code - StaticText "~/.hermes" - StaticText ". Automatically detects legacy directory names (" - code - StaticText "~/.clawdbot" - StaticText ", " - code - StaticText "~/.moltbot" - StaticText ") and config filenames (" - code - StaticText "clawdbot.json" - StaticText ", " - code - StaticText "moltbot.json" - StaticText ")." - table - rowgroup - row - columnheader "Option" [ref=e1436] - columnheader "Description" [ref=e1437] - row - cell "--dry-run" [ref=e1147] - cell "Preview what would be migrated without writing anything." [ref=e1148] - row - cell "--preset <name>" [ref=e1149] - cell "Migration preset: full (all compatible settings) or user-data (excludes infrastructure config). Neither preset imports secrets — pass --migrate-secrets explicitly." [ref=e1150] - StaticText "Migration preset: " - row - cell "--overwrite" [ref=e1151] - cell "Overwrite existing Hermes files on conflicts (default: refuse to apply when the plan has conflicts)." [ref=e1152] - row - cell "--migrate-secrets" [ref=e1153] - cell "Include API keys in migration. Required even under --preset full." [ref=e1154] - row - cell "--no-backup" [ref=e1155] - cell "Skip the pre-migration zip snapshot of ~/.hermes/ (by default a single restore-point archive is written to ~/.hermes/backups/pre-migration-*.zip before apply; restorable with hermes import)." [ref=e1156] - row - cell "--source <path>" [ref=e1157] - cell "Custom OpenClaw directory (default: ~/.openclaw)." [ref=e1158] - StaticText "Custom OpenClaw directory (default: " - row - cell "--workspace-target <path>" [ref=e1159] - cell "Target directory for workspace instructions (AGENTS.md)." [ref=e1160] - row - cell "--skill-conflict <mode>" [ref=e1161] - cell "Handle skill name collisions: skip (default), overwrite, or rename." [ref=e1162] - StaticText "Handle skill name collisions: " - row - cell "--yes" [ref=e1163] - cell "Skip the confirmation prompt." [ref=e1164] - heading "What gets migrated Direct link to What gets migrated" [level=3, ref=e89] - StaticText "What gets migrated" - link "Direct link to What gets migrated" [ref=e286] - StaticText "#" - paragraph - StaticText "The migration covers 30+ categories across persona, memory, skills, model providers, messaging platforms, agent behavior, session policies, MCP servers, TTS, and more. Items are either " - strong - StaticText "directly imported" - StaticText " into Hermes equivalents or " - strong - StaticText "archived" - StaticText " for manual review." - paragraph - strong - StaticText "Directly imported:" - StaticText " SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills (4 source directories), default model, custom providers, MCP servers, messaging platform tokens and allowlists (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), agent defaults (reasoning effort, compression, human delay, timezone, sandbox), session reset policies, approval rules, TTS config, browser settings, tool settings, exec timeout, command allowlist, gateway config, and API keys from 3 sources." - paragraph - strong - StaticText "Archived for manual review:" - StaticText " Cron jobs, plugins, hooks/webhooks, memory backend (QMD), skills registry config, UI/identity, logging, multi-agent setup, channel bindings, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md." - paragraph - strong - StaticText "API key resolution" - StaticText " checks three sources in priority order: config values → " - code - StaticText "~/.openclaw/.env" - StaticText " → " - code - StaticText "auth-profiles.json" - StaticText ". All token fields handle plain strings, env templates (" - code - StaticText "${VAR}" - StaticText "), and SecretRef objects." - paragraph - StaticText "For the complete config key mapping, SecretRef handling details, and post-migration checklist, see the " - strong - link "full migration guide" [ref=e1165] - StaticText "." - heading "Examples Direct link to Examples" [level=3, ref=e90] - StaticText "Examples" - link "Direct link to Examples" [ref=e287] - StaticText "#" - generic - generic [ref=e288] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1166] - heading "hermes import-agent Direct link to hermes-import-agent" [level=2, ref=e91] - code - StaticText "hermes import-agent" - link "Direct link to hermes-import-agent" [ref=e289] - StaticText "#" - generic - generic [ref=e290] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1167] - paragraph - StaticText "Import a " - strong - StaticText "Claude Code" - StaticText " (" - code - StaticText "~/.claude" - StaticText ") or " - strong - StaticText "OpenAI Codex CLI" - StaticText " (" - code - StaticText "~/.codex" - StaticText ") setup into Hermes. Maps " - code - StaticText "CLAUDE.md" - StaticText "/" - code - StaticText "AGENTS.md" - StaticText " instructions to memory entries, " - code - StaticText "Bash(...)" - StaticText " permission allow/deny rules to " - code - StaticText "command_allowlist" - StaticText "/" - code - StaticText "approvals.deny" - StaticText ", MCP servers to " - code - StaticText "mcp_servers" - StaticText " in " - code - StaticText "config.yaml" - StaticText ", and skill directories into " - code - StaticText "~/.hermes/skills/" - StaticText ". Always previews before applying; API keys and credentials are never imported." - table - rowgroup - row - columnheader "Option" [ref=e1438] - columnheader "Description" [ref=e1439] - row - cell "agent" [ref=e1168] - cell "claude-code or codex (default: auto-detect)." [ref=e1169] - StaticText " (default: auto-detect)." - row - cell "--source <path>" [ref=e1170] - cell "Custom source directory (default: ~/.claude or ~/.codex)." [ref=e1171] - StaticText "Custom source directory (default: " - row - cell "--dry-run" [ref=e1172] - cell "Preview only — write nothing." [ref=e1173] - row - cell "--overwrite" [ref=e1174] - cell "Replace conflicting MCP servers / skills (default: skip)." [ref=e1175] - row - cell "--yes, -y" [ref=e1176] - cell "Skip confirmation prompts." [ref=e1177] - paragraph - StaticText "See the " - strong - link "import guide" [ref=e1178] - StaticText " for the full mapping tables." - heading "hermes serve Direct link to hermes-serve" [level=2, ref=e92] - code - StaticText "hermes serve" - link "Direct link to hermes-serve" [ref=e291] - StaticText "#" - generic - generic [ref=e292] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1179] - paragraph - StaticText "Start the Hermes " - strong - StaticText "backend server" - StaticText " — the JSON-RPC/WebSocket gateway the " - link "desktop app" [ref=e293] - StaticText " and remote clients connect to. It is the same server " - code - StaticText "hermes dashboard" - StaticText " runs, but " - strong - StaticText "headless" - StaticText ": it never opens a browser UI. The desktop app launches its own " - code - StaticText "hermes serve" - StaticText " backend; use this command directly when you want a headless backend on a remote host. Accepts the same " - code - StaticText "--host" - StaticText " / " - code - StaticText "--port" - StaticText " / " - code - StaticText "--insecure" - StaticText " / " - code - StaticText "--skip-build" - StaticText " / " - code - StaticText "--stop" - StaticText " / " - code - StaticText "--status" - StaticText " options as " - code - StaticText "hermes dashboard" - StaticText " below (a non-loopback bind engages the same auth gate). Requires the " - code - StaticText "[web]" - StaticText " extra; the embedded Chat socket additionally needs " - code - StaticText "[pty]" - StaticText " on a POSIX host." - heading "hermes dashboard Direct link to hermes-dashboard" [level=2, ref=e93] - code - StaticText "hermes dashboard" - link "Direct link to hermes-dashboard" [ref=e294] - StaticText "#" - generic - generic [ref=e295] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1180] - paragraph - StaticText "Launch the web dashboard — a browser-based UI for managing configuration, API keys, and monitoring sessions. (For a headless backend with no browser UI — e.g. what the desktop app spawns — use " - link "hermes serve" [ref=e296] - code - StaticText " above.) Requires " - code - StaticText "cd ~/.hermes/hermes-agent && uv pip install -e \".[web]\"" - StaticText " (FastAPI + Uvicorn). The embedded browser Chat tab is always available and additionally needs the " - code - StaticText "pty" - StaticText " extra (" - code - StaticText "cd ~/.hermes/hermes-agent && uv pip install -e \".[web,pty]\"" - StaticText ") plus a POSIX PTY environment such as Linux, macOS, or WSL2. See " - link "Web Dashboard" [ref=e297] - StaticText " for full documentation." - table - rowgroup - row - columnheader "Option" [ref=e1440] - columnheader "Default" [ref=e1441] - columnheader "Description" [ref=e1442] - row - cell "--port" [ref=e1181] - cell "9119" [ref=e1182] - cell "Port to run the web server on" [ref=e1183] - row - cell "--host" [ref=e1184] - cell "127.0.0.1" [ref=e1185] - cell "Bind address" [ref=e1186] - row - cell "--no-open" [ref=e1187] - cell "—" [ref=e1188] - cell "Don't auto-open the browser" [ref=e1189] - row - cell "--insecure" [ref=e1190] - cell "off" [ref=e1191] - cell "Deprecated / no-op. Formerly bypassed auth on a non-loopback bind. Since the June 2026 hardening a public bind always requires an auth provider (password or OAuth). Bind 127.0.0.1 and tunnel to keep it local." [ref=e1192] - row - cell "--skip-build" [ref=e1193] - cell "off" [ref=e1194] - cell "Skip the web UI build step and serve the existing dist directly. Useful for non-interactive contexts (Windows Scheduled Tasks, CI) where npm isn't available. Pre-build with cd web && npm run build." [ref=e1195] - row - cell "--isolated" [ref=e1196] - cell "off" [ref=e1197] - cell "When launched from a named profile (worker dashboard), run a dedicated per-profile server instead of routing to the machine dashboard." [ref=e1198] - row - cell "--stop" [ref=e1199] - cell "—" [ref=e1200] - cell "Stop running hermes dashboard processes and exit." [ref=e1201] - row - cell "--status" [ref=e1202] - cell "—" [ref=e1203] - cell "List running hermes dashboard processes and exit." [ref=e1204] - heading "hermes dashboard register Direct link to hermes-dashboard-register" [level=3, ref=e94] - code - StaticText "hermes dashboard register" - link "Direct link to hermes-dashboard-register" [ref=e298] - StaticText "#" - paragraph - StaticText "Register this install as a self-hosted dashboard with your Nous Portal account. Creates an OAuth client, writes " - code - StaticText "HERMES_DASHBOARD_OAUTH_CLIENT_ID" - StaticText " into " - code - StaticText "~/.hermes/.env" - StaticText ", and prints how to engage the login gate. Requires being logged in (" - code - StaticText "hermes setup" - StaticText ")." - table - rowgroup - row - columnheader "Option" [ref=e1443] - columnheader "Description" [ref=e1444] - row - cell "--name" [ref=e1205] - cell "Human-readable label for the dashboard (default: auto-generated)." [ref=e1206] - row - cell "--redirect-uri" [ref=e1207] - cell "Public HTTPS OAuth redirect URI (e.g. https://hermes.example.com/auth/callback). Omit for localhost-only use." [ref=e1208] - row - cell "--portal-url" [ref=e1209] - cell "Override the Nous Portal base URL for registration (default: the portal you logged into). Also settable via HERMES_DASHBOARD_PORTAL_URL." [ref=e1210] - StaticText "Override the Nous Portal base URL for registration (default: the portal you logged into). Also settable via " - generic - generic [ref=e299] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1211] - heading "hermes profile Direct link to hermes-profile" [level=2, ref=e95] - code - StaticText "hermes profile" - link "Direct link to hermes-profile" [ref=e300] - StaticText "#" - generic - generic [ref=e301] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1212] - paragraph - StaticText "Manage profiles — multiple isolated Hermes instances, each with its own config, sessions, skills, and home directory." - table - rowgroup - row - columnheader "Subcommand" [ref=e1445] - columnheader "Description" [ref=e1446] - row - cell "list" [ref=e1213] - cell "List all profiles." [ref=e1214] - row - cell "use <name>" [ref=e1215] - cell "Set a sticky default profile." [ref=e1216] - row - cell "create <name> [--clone] [--clone-all] [--clone-from <source>] [--no-alias]" [ref=e1217] - cell "Create a new profile. --clone copies config, .env, SOUL.md, and skills from the active profile. --clone-all copies all state. --clone-from specifies a source profile and implies config clone unless paired with --clone-all." [ref=e1218] - row - cell "delete <name> [-y]" [ref=e1219] - cell "Delete a profile." [ref=e1220] - row - cell "show <name>" [ref=e1221] - cell "Show profile details (home directory, config, etc.)." [ref=e1222] - row - cell "alias <name> [--remove] [--name NAME]" [ref=e1223] - cell "Manage wrapper scripts for quick profile access." [ref=e1224] - row - cell "rename <old> <new>" [ref=e1225] - cell "Rename a profile." [ref=e1226] - row - cell "export <name> [-o FILE]" [ref=e1227] - cell "Export a profile to a .tar.gz archive (local backup)." [ref=e1228] - row - cell "import <archive> [--name NAME]" [ref=e1229] - cell "Import a profile from a .tar.gz archive (local restore)." [ref=e1230] - row - cell "install <source> [--name N] [--alias] [--force] [-y]" [ref=e1231] - cell "Install a profile distribution from a git URL or local directory." [ref=e1232] - row - cell "update <name> [--force-config] [-y]" [ref=e1233] - cell "Re-pull a distribution; preserves user data (memories, sessions, auth)." [ref=e1234] - row - cell "info <name>" [ref=e1235] - cell "Show a profile's distribution manifest (version, requirements, source)." [ref=e1236] - paragraph - StaticText "Examples:" - generic - generic [ref=e302] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1237] - heading "hermes completion Direct link to hermes-completion" [level=2, ref=e96] - code - StaticText "hermes completion" - link "Direct link to hermes-completion" [ref=e303] - StaticText "#" - generic - generic [ref=e304] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1238] - paragraph - StaticText "Print a shell completion script to stdout. Source the output in your shell profile for tab-completion of Hermes commands, subcommands, and profile names." - paragraph - StaticText "Examples:" - generic - generic [ref=e305] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1239] - heading "hermes update Direct link to hermes-update" [level=2, ref=e97] - code - StaticText "hermes update" - link "Direct link to hermes-update" [ref=e306] - StaticText "#" - generic - generic [ref=e307] focusable [tabindex] - code - button "Copy code to clipboard" [ref=e1240] - paragraph - StaticText "Pulls the latest " - code - StaticText "hermes-agent" - StaticText " code and reinstalls dependencies in the managed venv, then re-runs the post-install hooks (MCP servers, skills sync, completion install). Safe to run on a live install. Use " - code - StaticText "--check" - StaticText " to see whether your checkout is behind " - code - StaticText "origin/main" - StaticText " without installing." - paragraph - code - StaticText "hermes update" - StaticText " pulls the configured update branch (default: " - code - StaticText "main" - StaticText "). If your checkout is on another branch, Hermes may check out the update branch before pulling. Commit branch work before updating when you want to keep it outside the update autostash flow." - table - rowgroup - row - columnheader "Option" [ref=e1447] - columnheader "Description" [ref=e1448] - row - cell "--gateway" [ref=e1241] - cell "Internal mode used by the messaging /update command. Uses file-based IPC for prompts and progress streaming instead of reading from terminal stdin. Not a gateway restart flag." [ref=e1242] - row - cell "--check" [ref=e1243] - cell "Check whether an update is available without pulling, installing dependencies, or restarting anything." [ref=e1244] - row - cell "--no-backup" [ref=e1245] - cell "Skip all pre-update backups for this run (both the quick state snapshot and the full zip), regardless of updates.pre_update_backup." [ref=e1246] - row - cell "--backup" [ref=e1247] - cell "Force a full pre-update backup for this run: the quick state snapshot plus a complete zip of HERMES_HOME (config, auth, sessions, skills, pairing data). The default mode is quick — a lightweight state snapshot only. Set the permanent mode via `updates.pre_update_backup: quick" [ref=e1248] - StaticText " pre-update backup for this run: the quick state snapshot plus a complete zip of " - StaticText " — a lightweight state snapshot only. Set the permanent mode via `updates.pre_update_backup: quick" - row - cell "--yes, -y" [ref=e1249] - cell "Assume yes for interactive prompts such as config migration and stash restore. API-key entry is skipped; run hermes config migrate separately for those." [ref=e1250] - paragraph - StaticText "Additional behavior:" - list - listitem [level=1] - ListMarker "• " - strong - StaticText " After a successful update, Hermes attempts to restart all running gateway profiles automatically so they pick up the new code. Use " - code - StaticText " when you want to restart a gateway without applying an update." - listitem [level=1] - ListMarker "• " - strong - StaticText " For git installs, dirty tracked files and untracked files are auto-stashed before branch checkout or pull (" - code - StaticText "). Interactive terminal updates ask before restoring the stash. Non-interactive updates restore it by default; set " - code - StaticText "updates.non_interactive_local_changes: discard" - StaticText " only on managed installs where local source edits should be thrown away after a successful pull. If stash restore conflicts or the pull fails, the stash is left in place for manual recovery." - listitem [level=1] - ListMarker "• " - strong - StaticText " Before stashing or switching branches, Hermes makes a best-effort cleanup of tracked " - code - StaticText " diffs produced by npm install/build steps. Commit or manually stash intentional lockfile edits before running " - code - StaticText "." - listitem [level=1] - ListMarker "• " - strong - StaticText " Even when " - code - StaticText " is off, " - code - StaticText " takes a lightweight snapshot of " - code - StaticText " and the Feishu comment rules before " - code - StaticText ". You can roll it back with " - code - StaticText " if a pull rewrites a file you were editing." - listitem [level=1] - ListMarker "• " - strong - StaticText " If Hermes detects a pre-rename " - code - StaticText " systemd unit (instead of the current " - code - StaticText "), it prints a one-time migration hint so you can avoid flap-loop issues." - listitem [level=1] - ListMarker "• " - strong - StaticText " " - code - StaticText " on success, " - code - StaticText " on pull/install/post-install errors, " - code - StaticText " on unexpected working-tree changes that block " - code - StaticText "." - heading "Maintenance commands Direct link to Maintenance commands" [level=2, ref=e98] - StaticText "Maintenance commands" - link "Direct link to Maintenance commands" [ref=e308] - StaticText "#" - table - rowgroup - row - columnheader "Command" [ref=e1449] - columnheader "Description" [ref=e1450] - row - cell "hermes version" [ref=e1251] - cell "Print version information." [ref=e1252] - row - cell "hermes update" [ref=e1253] - cell "Pull latest changes and reinstall dependencies." [ref=e1254] - paragraph - StaticText "| " - code - StaticText "hermes uninstall [--full] [--gui] [--dry-run] [--yes]" - StaticText " | Remove Hermes, optionally deleting all config/data. " - code - StaticText "--gui" - StaticText " removes only the desktop Chat GUI, leaving the agent intact; " - code - StaticText "--full" - StaticText " also deletes config/data; " - code - StaticText "--dry-run" - StaticText " prints what would be removed without changing anything; " - code - StaticText "--yes" - StaticText " skips prompts. |" - heading "See also Direct link to See also" [level=2, ref=e99] - StaticText "See also" - link "Direct link to See also" [ref=e309] - StaticText "#" - list - listitem [level=1] - ListMarker "• " - link "Slash Commands Reference" [ref=e1255] - listitem [level=1] - ListMarker "• " - link "CLI Interface" [ref=e1256] - listitem [level=1] - ListMarker "• " - link "Sessions" [ref=e1257] - listitem [level=1] - ListMarker "• " - link "Skills System" [ref=e1258] - listitem [level=1] - ListMarker "• " - link "Skins & Themes" [ref=e1259] - sectionfooter - link "Edit this page" [ref=e1260] - navigation "Docs pages" [ref=e14] - link "Previous « Trajectory Format" [ref=e100] - StaticText "Previous" - generic - StaticText "« " - StaticText "Trajectory Format" - link "Next Slash Commands Reference »" [ref=e101] - StaticText "Next" - generic - StaticText "Slash Commands Reference" - StaticText " »" - list - listitem [level=1] - link "Global entrypoint" [ref=e1261] - list - listitem [level=2] - link "Global options" [ref=e1459] - listitem [level=1] - link "Top-level commands" [ref=e1262] - listitem [level=1] - link "hermes chat" [ref=e1263] - code - list - listitem [level=2] - link "hermes -z <prompt> — scripted one-shot" [ref=e1460] - listitem [level=1] - link "hermes model" [ref=e1264] - code - list - listitem [level=2] - link "/model slash command (mid-session)" [ref=e1461] - listitem [level=1] - link "hermes gateway" [ref=e1265] - code - listitem [level=1] - link "hermes lsp" [ref=e1266] - code - listitem [level=1] - link "hermes setup" [ref=e1267] - code - listitem [level=1] - link "hermes portal" [ref=e1268] - code - listitem [level=1] - link "hermes whatsapp" [ref=e1269] - code - listitem [level=1] - link "hermes slack" [ref=e1270] - code - listitem [level=1] - link "hermes send" [ref=e1271] - code - list - listitem [level=2] - link "Sending images and other media" [ref=e1462] - listitem [level=1] - link "hermes secrets" [ref=e1272] - code - listitem [level=1] - link "hermes migrate" [ref=e1273] - code - listitem [level=1] - link "hermes proxy" [ref=e1274] - code - listitem [level=1] - link "hermes security" [ref=e1275] - code - listitem [level=1] - link "hermes login / hermes logout (Deprecated)" [ref=e1276] - code - StaticText " / " - code - StaticText " " - emphasis - listitem [level=1] - link "hermes auth" [ref=e1277] - code - listitem [level=1] - link "hermes status" [ref=e1278] - code - listitem [level=1] - link "hermes cron" [ref=e1279] - code - listitem [level=1] - link "hermes kanban" [ref=e1280] - code - listitem [level=1] - link "hermes egress" [ref=e1281] - code - list - listitem [level=2] - link "Common flows" [ref=e1463] - listitem [level=2] - link "Diagnostic shortcuts" [ref=e1464] - listitem [level=1] - link "hermes project" [ref=e1282] - code - listitem [level=1] - link "hermes webhook" [ref=e1283] - code - list - listitem [level=2] - link "hermes webhook subscribe" [ref=e1465] - listitem [level=1] - link "hermes doctor" [ref=e1284] - code - listitem [level=1] - link "hermes dump" [ref=e1285] - code - list - listitem [level=2] - link "What it includes" [ref=e1466] - listitem [level=2] - link "Example output" [ref=e1467] - listitem [level=2] - link "When to use" [ref=e1468] - listitem [level=1] - link "hermes debug" [ref=e1286] - code - list - listitem [level=2] - link "Examples" [ref=e1469] - listitem [level=1] - link "hermes backup" [ref=e1287] - code - list - listitem [level=2] - link "Examples" [ref=e1470] - listitem [level=1] - link "hermes checkpoints" [ref=e1288] - code - list - listitem [level=2] - link "Options" [ref=e1471] - listitem [level=2] - link "Examples" [ref=e1472] - listitem [level=1] - link "hermes import" [ref=e1289] - code - list - listitem [level=2] - link "Examples" [ref=e1473] - listitem [level=1] - link "hermes logs" [ref=e1290] - code - list - listitem [level=2] - link "Log files" [ref=e1474] - listitem [level=2] - link "Options" [ref=e1475] - listitem [level=2] - link "Examples" [ref=e1476] - listitem [level=2] - link "Filtering" [ref=e1477] - listitem [level=2] - link "Log rotation" [ref=e1478] - listitem [level=1] - link "hermes prompt-size" [ref=e1291] - code - listitem [level=1] - link "hermes config" [ref=e1292] - code - listitem [level=1] - link "hermes pairing" [ref=e1293] - code - listitem [level=1] - link "hermes skills" [ref=e1294] - code - listitem [level=1] - link "hermes bundles" [ref=e1295] - code - listitem [level=1] - link "hermes curator" [ref=e1296] - code - listitem [level=1] - link "hermes moa" [ref=e1297] - code - listitem [level=1] - link "hermes fallback" [ref=e1298] - code - listitem [level=1] - link "hermes hooks" [ref=e1299] - code - listitem [level=1] - link "hermes memory" [ref=e1300] - code - listitem [level=1] - link "hermes acp" [ref=e1301] - code - listitem [level=1] - link "hermes mcp" [ref=e1302] - code - listitem [level=1] - link "hermes plugins" [ref=e1303] - code - listitem [level=1] - link "hermes tools" [ref=e1304] - code - listitem [level=1] - link "hermes computer-use" [ref=e1305] - code - listitem [level=1] - link "hermes pets" [ref=e1306] - code - listitem [level=1] - link "hermes sessions" [ref=e1307] - code - listitem [level=1] - link "hermes insights" [ref=e1308] - code - listitem [level=1] - link "hermes claw" [ref=e1309] - code - list - listitem [level=2] - link "What gets migrated" [ref=e1479] - listitem [level=2] - link "Examples" [ref=e1480] - listitem [level=1] - link "hermes import-agent" [ref=e1310] - code - listitem [level=1] - link "hermes serve" [ref=e1311] - code - listitem [level=1] - link "hermes dashboard" [ref=e1312] - code - list - listitem [level=2] - link "hermes dashboard register" [ref=e1481] - listitem [level=1] - link "hermes profile" [ref=e1313] - listitem [level=1] - link "hermes completion" [ref=e1314] - listitem [level=1] - link "hermes update" [ref=e1315] - listitem [level=1] - link "Maintenance commands" [ref=e1316] - listitem [level=1] - link "See also" [ref=e1317] - contentinfo - StaticText "Docs" - list - listitem [level=1] - link "Getting Started" [ref=e102] - listitem [level=1] - link "User Guide" [ref=e103] - listitem [level=1] - link "Developer Guide" [ref=e104] - listitem [level=1] - link "Reference" [ref=e105] - StaticText "Community" - list - listitem [level=1] - link "Discord (opens in new tab)" [ref=e106] - listitem [level=1] - link "GitHub Issues (opens in new tab)" [ref=e107] - listitem [level=1] - link "Skills Hub (opens in new tab)" [ref=e108] - StaticText "More" - list - listitem [level=1] - link "Desktop Download (opens in new tab)" [ref=e109] - listitem [level=1] - link "GitHub (opens in new tab)" [ref=e110] - listitem [level=1] - link "Nous Research (opens in new tab)" [ref=e111] - generic - link "Nous Research" [ref=e15]