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).
Maintaining this reference takes time — thanks if you can chip in.
☕ Buy me a coffee · other ways to support
hermes setup — interactive wizard · hermes model — pick Nous Portal (OAuth), OpenRouter (API key), or your own endpoint.hermes / hermes desktop — same agent via CLI or native Desktop UI (shared config, memory, skills).hermes gateway setup → hermes gateway → hermes gateway install; enable browser workspace with hermes webapp.hermes update — sync upstream / refresh deps (CLI). Desktop and Store builds update through their own channels.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.
hermes cron).hermes plugins (importers, MCP serve, backends, language packs, and more).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.
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.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup for the interactive wizard.hermes (CLI) or hermes desktop (native UI) — same config and sessions.hermes update on CLI installs to sync upstream and refresh dependencies. Store / Desktop installer builds update through their own channels.| Source | Notes |
|---|---|
| Nous Portal | OAuth sign-in through the Nous portal. |
| OpenRouter | Bring your OpenRouter API key. |
| Your endpoint | Any OpenAI-compatible HTTP API you operate. |
Commands: hermes setup (wizard) · hermes model (choose / change model configuration).
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.
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)
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.
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.
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)
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.
Use hermes auth for credentials and OAuth (Codex / Nous / Anthropic and API-key pools). hermes login / logout are deprecated aliases.
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
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.
Work inside CLI, TUI, Desktop chat, and (where noted) messaging. Prefix matching works (/mod → /model). Full list: Slash commands reference.
| Command | Notes |
|---|---|
/model | Show / switch model; provider:model, custom endpoints, aliases; --global / --session / --once. |
/model reset | Drop this session’s model pin; keep history; fall back to config. |
/delegation | Subagent routing (advanced-delegation plugin); choices can persist for the next session. |
/usage | Tokens, cost, context, and live account limits when the provider supports them. |
| Command | Notes |
|---|---|
/loop | Recurring in-session turns (/loop 5m …); status / pause / resume / stop. |
/pause | Global emergency stop (same idea as hermes pause); /pause off to lift. |
/status | Session info + local recap (model, profile, tokens, tools) — no LLM call. |
/new · /compress | Fresh session; manual context compression. |
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.
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.
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>
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.
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
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).
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
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.
Desktop, CLI/TUI, Webapp, Telegram, Discord, Slack, WhatsApp, Signal, and email — one agent, one memory across surfaces.
Persistent memory plus auto-generated skills — learns your projects and retains how problems were solved.
Natural-language cron for reports, backups, and briefings unattended via the gateway.
Isolated subagents: separate conversations, terminals, Python RPC — lower context cost for pipelines.
Backends include local, Docker, SSH, Singularity, and Modal — hardened containers and namespace isolation.
Search, browser automation, vision, image generation, TTS, and multi-model reasoning in one stack.
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.
| Area | Examples (from site) |
|---|---|
| Web & browser | Search, browsing, snapshots, automation |
| Execution | Terminal, sandboxes, Python RPC / code run |
| Memory & plans | Long-term recall, task planning |
| Omni-channel | Gateway integrations, schedules |
| Media | Vision, image gen, TTS |
Desktop · CLI/TUI · Webapp · Telegram · Discord · Slack · WhatsApp · Signal · Email — same agent and memory across surfaces, as described on hermes-agent.nousresearch.com.
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.
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.
Start from bundled skills, fork for your stack, and publish extras so every Hermes instance you run shares the same muscle memory.
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.
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.
hermes webapp serves the Desktop workspace from the gateway listener.requires_hermes checks; skill write locks; importers via hermes migrate.hermes cron (pause / resume / doctor / tick) plus missed-run policies; Desktop cron Stop control./model reset; /delegation choices persist across sessions.compression.prepare_ahead); pre_llm_call hooks can block a turn.| Resource | URL |
|---|---|
| Product / install | hermes-agent.nousresearch.com |
| Desktop guide | Docs → Hermes Desktop |
| CLI reference | Docs → CLI commands |
| Slash commands | Docs → Slash commands |
| Releases | GitHub releases |
| Source | github.com/NousResearch/hermes-agent |
| Nous Research | nousresearch.com |
This cheatsheet is independent documentation — always verify behavior against upstream docs and release notes.