v0.22.6 · Updated Nov 2, 2026260K+ ⭐ GitHubMIT · Open source

The Hermes Agent Cheatsheet

An autonomous agent that runs on your machine or server, remembers what it learns, and grows over time — Desktop, CLI, Webapp, and gateway essentials on one page (aligned with Hermes Agent v0.22.x).

📄 Print / Save PDFShare on 𝕏⭐ Star on GitHubNous Research — Hermes

Maintaining this reference takes time — thanks if you can chip in.
☕ Buy me a coffee · other ways to support

🚀 Get started in 60 seconds (from the official site)

1
Install — Desktop from the official site (macOS / Windows / Linux / Microsoft Store), or the terminal one-liner below.
2
hermes setup — interactive wizard · hermes model — pick Nous Portal (OAuth), OpenRouter (API key), or your own endpoint.
3
hermes / hermes desktop — same agent via CLI or native Desktop UI (shared config, memory, skills).
4
Optional: hermes gateway setup → hermes gateway → hermes gateway install; enable browser workspace with hermes webapp.
5
hermes update — sync upstream / refresh deps (CLI). Desktop and Store builds update through their own channels.
📌

What is Hermes Agent?

From the product site: it is not a coding copilot chained to an IDE or a thin wrapper around one API. It is an autonomous agent that lives on your machine or server, persists memory, generates skills from experience, and improves the longer it runs — with a real CLI, optional messaging gateway, sandboxed execution, and multi-model tooling.

Highlights

  • Multi-surface — Desktop app, CLI/TUI, gateway Webapp, plus Telegram, Discord, Slack, WhatsApp, Signal, and email — one agent, one memory.
  • Memory & skills — remembers projects and past fixes; creates and installs skills (including community hubs).
  • Automation — natural-language cron for unattended jobs through the gateway (hermes cron).
  • Delegation — subagents with isolated conversations, terminals, and Python RPC for parallel work.
  • Sandboxing — five backends: local, Docker, SSH, Singularity, Modal — with hardening options.
  • Web & media — search, browser automation, vision, image generation, TTS, multi-model reasoning.
  • Plugins — opt-in catalog installs via hermes plugins (importers, MCP serve, backends, language packs, and more).

Platform support

Hermes Desktop ships for macOS, Windows, and Linux (including Microsoft Store on Windows). The terminal installer covers Linux, macOS, and WSL2. Optional hosted agents are available via Nous Portal cloud deploy. Source: hermes-agent.nousresearch.com.

⚡

Install

Prefer Hermes Desktop from the official site (macOS 12+, Windows 10/11, Linux, Microsoft Store), or install via terminal. The official one-liner sets up tooling (including uv), Python, and the agent environment — typically without sudo.

Terminal one-liner

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

After install

  • Run hermes setup for the interactive wizard.
  • Run hermes (CLI) or hermes desktop (native UI) — same config and sessions.
  • Use hermes update on CLI installs to sync upstream and refresh dependencies. Store / Desktop installer builds update through their own channels.
🎛️

Configure models & auth

Model providers (from the site)

SourceNotes
Nous PortalOAuth sign-in through the Nous portal.
OpenRouterBring your OpenRouter API key.
Your endpointAny OpenAI-compatible HTTP API you operate.

Commands: hermes setup (wizard) · hermes model (choose / change model configuration).

Sign up

Account and billing flows are hosted on the Nous portal — use the Sign Up on Nous Portal call-to-action on the official landing page.

⌨️

CLI essentials

Day-to-day

hermes              # Interactive session (tools, memory, skills)
hermes desktop      # Native Desktop app (same agent core)
hermes setup        # Configuration wizard
hermes model        # Model / provider selection
hermes status       # Agent, auth, platform status
hermes doctor       # Diagnose config / dependency issues
hermes update       # Pull latest + refresh deps (CLI installs)

Also useful

hermes webapp       # Open Desktop workspace in a browser (gateway)
hermes plugins      # Install / enable / update / remove plugins
hermes cron         # List, create, pause, cancel, run scheduled jobs
hermes migrate      # Import from OpenClaw, Claude Code, Cursor, Grok Bot, …

Webapp needs hermes config set webapp.enabled true, then restart the gateway before hermes webapp. Full command list: CLI commands reference.

🛰️

Messaging gateway & Webapp

Connect Telegram, Discord, Slack, WhatsApp, Signal, and email through a single gateway process. The same gateway can also serve the Desktop workspace in a browser (hermes webapp) — not the same as the Web Dashboard admin panel.

Commands

hermes gateway setup     # Interactive gateway wizard
hermes gateway         # Run the gateway
hermes gateway install  # Install as a system service
hermes gateway restart  # Restart after config changes
hermes webapp          # Browser Desktop workspace (enable webapp first)

Why it matters

Start on CLI or Desktop, then pick up the same agent on chat apps or a browser tab — scheduled automations and channel delivery run through this gateway layer. Treat remote Webapp access like host access: use sign-in, VPN/tunnel, and prefer HTTPS off-loopback. Docs: Hermes Desktop.

🔐

Auth & accounts

Use hermes auth for credentials and OAuth (Codex / Nous / Anthropic and API-key pools). hermes login / logout are deprecated aliases.

Credentials

hermes auth              # Interactive credential wizard
hermes auth list        # Show pools / providers
hermes auth add …       # API key or --type oauth
hermes auth status      # Provider auth status
hermes auth logout      # Clear stored auth for a provider

Usage / limits

hermes usage            # Rate-limit / credits block (no session)
hermes usage --json     # Script-friendly JSON
hermes usage --provider openai-codex

In-session equivalent: /usage. Docs: CLI reference.

💬

Slash & session commands

Work inside CLI, TUI, Desktop chat, and (where noted) messaging. Prefix matching works (/mod → /model). Full list: Slash commands reference.

Model & delegation

CommandNotes
/modelShow / switch model; provider:model, custom endpoints, aliases; --global / --session / --once.
/model resetDrop this session’s model pin; keep history; fall back to config.
/delegationSubagent routing (advanced-delegation plugin); choices can persist for the next session.
/usageTokens, cost, context, and live account limits when the provider supports them.

Loops, pause, status

CommandNotes
/loopRecurring in-session turns (/loop 5m …); status / pause / resume / stop.
/pauseGlobal emergency stop (same idea as hermes pause); /pause off to lift.
/statusSession info + local recap (model, profile, tokens, tools) — no LLM call.
/new · /compressFresh session; manual context compression.
⏰

Automation (cron & pause)

Cron

hermes cron list
hermes cron create …      # Prompt + optional --skill / reasoning pin
hermes cron pause|resume <id>
hermes cron run|remove <id>
hermes cron status|doctor|tick

Also: edit, runs, incidents. Natural-language schedules run through the gateway; Desktop has a cron editor with Stop.

Global pause

hermes pause [reason]   # Hold new cron, kanban, gateway turns
hermes resume           # Lift the emergency stop

In-flight work finishes; surfaces show “Hermes is paused.” Messaging can use /pause / /pause off.

🗂️

Kanban & projects

Kanban

Multi-profile collaboration boards (hermes kanban) — tasks, links, dispatcher. Agents use a kanban_* toolset; humans/scripts use the CLI. Boards are selectable with --board / hermes kanban boards switch.

hermes kanban init
hermes kanban --board default <action>

Projects

hermes project manages named multi-folder workspaces (per profile). Anchors Desktop session grouping; kanban tasks tied to a project with a primary folder default to a deterministic worktree + branch.

Details: CLI → kanban / project.

🔌

Plugins, MCP & hooks

Plugins & MCP

hermes plugins                 # Interactive enable / providers UI
hermes plugins install <name>  # Catalog, owner/repo, or Git URL
hermes plugins enable|update|remove <name>
hermes mcp                     # Catalog picker / manage MCP servers
hermes mcp install|add|list|test …
hermes plugins install mcp-serve && hermes mcp-serve  # Hermes as MCP server

Hooks

hermes hooks list
hermes hooks test <event>   # Synthetic payload
hermes hooks doctor
hermes hooks revoke …      # Drop allowlist entries

Shell-script hooks live in config.yaml; first-use consent is allowlisted. Plugin hooks such as pre_llm_call / post_compaction are separate (see plugin docs).

🩺

Diagnostics & support

Health & audits

hermes status [--full|--deep]
hermes doctor [--fix]      # Exit 1 if unresolved problems
hermes dump               # Copy-pasteable setup summary
hermes security audit     # OSV supply-chain check (venv, plugins, MCP)
hermes logs               # View / tail agent & gateway logs

When sharing bugs

Prefer hermes dump for redacted setup text and hermes doctor before opening issues. hermes debug can upload logs for support. Always verify against the CLI commands reference.

✨

Feature themes

Lives where you do

Desktop, CLI/TUI, Webapp, Telegram, Discord, Slack, WhatsApp, Signal, and email — one agent, one memory across surfaces.

Grows the longer it runs

Persistent memory plus auto-generated skills — learns your projects and retains how problems were solved.

Scheduled automations

Natural-language cron for reports, backups, and briefings unattended via the gateway.

Delegates & parallelizes

Isolated subagents: separate conversations, terminals, Python RPC — lower context cost for pipelines.

Real sandboxing

Backends include local, Docker, SSH, Singularity, and Modal — hardened containers and namespace isolation.

Full web & browser control

Search, browser automation, vision, image generation, TTS, and multi-model reasoning in one stack.

🧰

Tools (40+ built-ins)

Marketing copy on the site lists 40+ built-in tools spanning search, terminal, filesystem, browser automation, vision, image generation, TTS, code execution, subagent delegation, memory, planning, cron, multi-model routing, and more. Treat this cheatsheet as a map — exact tool names live in repo docs.

Bundled categories (summary)

AreaExamples (from site)
Web & browserSearch, browsing, snapshots, automation
ExecutionTerminal, sandboxes, Python RPC / code run
Memory & plansLong-term recall, task planning
Omni-channelGateway integrations, schedules
MediaVision, image gen, TTS
📱

Platforms

Where you can talk to it

Desktop · CLI/TUI · Webapp · Telegram · Discord · Slack · WhatsApp · Signal · Email — same agent and memory across surfaces, as described on hermes-agent.nousresearch.com.

🖥️

Run environmentsEnvironments

Where it can execute

Official docs list five sandbox backends: local, Docker, SSH, Singularity, and Modal, with container hardening and namespace isolation. Match backends to your org’s safety requirements; extra backends may appear via plugins.

🧩

Skills ecosystem

Bundles & sharing

Hermes ships many bundled skills (site copy cites 40+ across MLOps, GitHub flows, research, and more). Agents can author new skills dynamically. The interchange format aligns with openagentskills.io, with community installs from ClawHub, LobeHub, and GitHub — as listed on the landing page.

Practice

Start from bundled skills, fork for your stack, and publish extras so every Hermes instance you run shares the same muscle memory.

🔬

Research workflows

Batch & RL hooks

Nous positions research-oriented flows: batch trajectory generation with parallel workers and checkpointing, Atropos integration for RL training, and exports to ShareGPT-style formats for fine-tuning with trajectory compression — see the Research blurb on the official site for the latest scope.

🆕

What’s new in v0.22.x

Cheatsheet highlights for the current stable line (latest tagged release: v0.22.6). Full curated notes for the window ship with upstream v0.23.0 — always check GitHub releases.

Surfaces & access

  • Hermes Desktop — first-class native app; Microsoft Store builds on Windows.
  • Webapp — hermes webapp serves the Desktop workspace from the gateway listener.
  • Plugins — catalog installs with requires_hermes checks; skill write locks; importers via hermes migrate.

Ops & sessions

  • Richer hermes cron (pause / resume / doctor / tick) plus missed-run policies; Desktop cron Stop control.
  • Session /model reset; /delegation choices persist across sessions.
  • Opt-in prepared compaction (compression.prepare_ahead); pre_llm_call hooks can block a turn.