📢 แจ้งเตือน: hermes agent cheat sheet - สรุปดราม่าล่าสุด

Hermes Agent is an open-source AI agent for coding, research, and recurring tasks. You can use it from the terminal or connected messaging apps, resume past conversations, switch models, and manage skills or scheduled jobs.

This cheat sheet collects the CLI commands, slash commands, keyboard shortcuts, and configuration settings for everyday Hermes Agent tasks.

Hermes Agent Cheat Sheet: CLI, Slash Commands & Config

CLI commands and flags

Command	Action
`hermes`	Start an interactive chat session.
`hermes --help`	Show terminal command help.
`hermes <command> --help`	Show flags and subcommands for a command family.
`hermes --version`	Print the installed version and exit. `-V` is an alias.

Flag	Action
`--profile <NAME>`	Use the named profile for one command without changing the sticky default. Alias: `-p`.
`-z <PROMPT>`	Run a scripted prompt and print only the final response text. This entry point auto-bypasses interactive approvals. Also available as `--oneshot <PROMPT>`.
`--usage-file <PATH>`	Write a JSON usage report for a one-shot run, including token counts and estimated cost.
`--model <MODEL>`	Override the model for this invocation. Alias: `-m`.
`--provider <NAME>`	Override the inference provider for this invocation.
`--reasoning <LEVEL>`	Override reasoning for this run: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`, or `ultra`.
`--toolsets <LIST>`	Enable a comma-separated set of toolsets. Alias: `-t`.
`--skills <NAME>`	Preload one or more skills. Repeat the flag or pass comma-separated names. Alias: `-s`.
`--resume <SESSION>`	Resume a session by ID or title. `latest` picks the latest session for the current workspace. Alias: `-r`.
`--continue [NAME]`	Resume the latest session, or the latest session matching a name. Alias: `-c`.
`--in <DIR>`	Run from a directory. With latest-session resume, scope the lookup to that workspace.
`--no-restore-cwd`	Resume a session without changing to its recorded working directory.
`--worktree`	Start in an isolated Git worktree. Alias: `-w`.
`--accept-hooks`	Automatically approve unseen configured shell hooks. Intended for headless runs.
`--yolo`	Bypass dangerous-command approval prompts.
`--pass-session-id`	Include the session ID in the agent’s system prompt.
`--ignore-user-config`	Ignore `config.yaml` and use built-in defaults. Credentials in `.env` still load.
`--ignore-rules`	Skip automatic `AGENTS.md`, `SOUL.md`, `.cursorrules`, memory, and preloaded-skill injection.
`--safe-mode`	For troubleshooting, skip user config, rules and memory injection, plugins, MCP servers, and shell-hook registration. `.env` credentials still load.
`--tui`	Launch the modern terminal interface. Requires Node.js 20 or newer and an interactive TTY.
`--cli`	Force the classic prompt-toolkit interface.

hermes -p work chat -q "Summarize the open pull requests"
hermes -z "List the changed files" --usage-file usage.json

Chat options

Use hermes chat for explicit chat options. A query sent from a terminal can open an interactive session. Add --oneshot when the command must answer and exit.

Command	Action
`hermes chat -q "<PROMPT>"`	Submit a prompt (`--query` is an alias). On a TTY it seeds an interactive session, while `--oneshot`, `-Q`, or non-TTY input answers and exits.
`hermes chat --query-file <PATH>`	Read a single query from a file or stdin (pass `-`). Input is not shell-interpreted and this option cannot be combined with `-q`.
`hermes chat --oneshot -q "<PROMPT>"`	Answer once and exit instead of keeping the TTY session open.
`hermes chat --image <PATH>`	Attach a local image to a single query.
`hermes chat --verbose`	Show verbose output. `-v` is an alias.
`hermes chat --quiet`	Suppress the banner, spinner, and tool previews for programmatic use. `-Q` is an alias.
`hermes chat --format <FORMAT>`	Choose single-query output (`text` or `stream-json`). JSONL implies quiet mode and cannot be combined with `--tui`.
`hermes chat -c <NAME> --create-if-missing`	Start a new session with that title when no named session exists.
`hermes chat --checkpoints`	Enable filesystem checkpoints before destructive file operations. Restore with `/rollback`.
`hermes chat --max-turns <N>`	Set the maximum tool-calling iterations per conversation turn.
`hermes chat --run-budget <SECONDS>`	Set a wall-clock budget for each conversation run.
`hermes chat --source <TAG>`	Tag the session for later filtering. The default source is `cli`.

hermes chat --oneshot -q "Summarize README.md"
hermes chat --query-file prompt.txt --format stream-json

Profiles, models, and sessions

Profiles

Command	Action
`hermes profile list`	List profiles and identify the active one.
`hermes profile create <NAME>`	Create a profile with its own Hermes home.
`hermes profile create <NAME> --clone`	Copy the active profile’s configuration, `.env`, personality, skills, and curated memory files.
`hermes profile create <NAME> --clone-from <SOURCE> --clone-all`	Create a full copy from a named profile. Session history and cron jobs are not copied.
`hermes profile create <NAME> --no-skills`	Create an empty profile without bundled skills.
`hermes profile use <NAME>`	Set the sticky default profile. Use `default` to return to the base profile.
`hermes -p <NAME> <COMMAND>`	Run one command against a profile without changing the sticky default. `--profile` is an alias.
`hermes profile show <NAME>`	Show profile details.
`hermes profile alias <NAME> [--name NAME]`	Create or rename a shell wrapper for a profile.
`hermes profile alias <NAME> --remove`	Remove the profile’s shell wrapper.
`hermes profile export <NAME> [-o FILE]`	Export a profile to a `.tar.gz` archive.
`hermes profile import <ARCHIVE> [--name NAME]`	Import a profile archive.
`hermes profile delete <NAME> [-y]`	Delete a profile. `-y` skips the confirmation prompt.

Models and fallback routes

Command	Action
`hermes model`	Open the provider setup wizard to add credentials, configure model endpoints, and choose the default model. Run from the shell.
`hermes model --refresh`	Clear the model-picker cache and refetch providers’ live model lists.
`hermes config get model.provider`	Read the configured default provider.
`hermes config set model.provider <PROVIDER>`	Set the persistent default provider.
`hermes config set model.default <MODEL>`	Set the persistent default model ID.
`hermes fallback`	Show the ordered fallback-provider chain. This is the default action, and `hermes fallback list` is explicit.
`hermes fallback add`	Choose a provider and model to append to the fallback chain.
`hermes fallback remove`	Select and remove one fallback entry.
`hermes fallback clear`	Remove every fallback entry.

Session history

Command	Action
`hermes -c`	Resume the most recent session for the current workspace.
`hermes -c "<TITLE>"`	Resume the latest session matching a title.
`hermes --resume <SESSION_ID>`	Resume a specific session by ID.
`hermes --resume latest --in <DIR>`	Resume the latest session associated with a directory’s workspace.
`hermes sessions list [--source SOURCE] [--limit N] [--workspace NEEDLE]`	List recent sessions. The default limit is 20.
`hermes sessions browse [--source SOURCE] [--limit N]`	Open an interactive session picker with search and resume.
`hermes sessions rename <SESSION_ID> <TITLE>`	Set or change a session title.
`hermes sessions pin <SESSION_ID...>`	Pin one or more sessions so they stay visible and are exempt from auto-archive.
`hermes sessions unpin <SESSION_ID...>`	Remove the keep pin from one or more sessions.
`hermes sessions pinned [--json]`	List pinned sessions.
`hermes sessions export [OUTPUT] --format <FORMAT>`	Export in `jsonl` (default), `md`, `qmd`, `html`, or `trace`. `--session-id ID` selects one session and filters can select a set.
`hermes sessions delete <SESSION_ID> [-y]`	Delete a session. `-y` skips confirmation.
`hermes sessions prune --older-than 90d --dry-run`	Preview ended sessions older than 90 days. The command also accepts filters for time, source, title, model, provider, workspace, and usage.
`hermes sessions archive --older-than 90d --dry-run`	Soft-hide sessions older than 90 days without deleting them. At least one filter is required.
`hermes sessions stats`	Show session-store statistics.
`hermes sessions optimize`	Reclaim database space without changing session data.
`hermes sessions repair --check-only`	Check whether the session database schema opens cleanly without modifying it.
`hermes sessions recover --source <DB> --output <NEW_DB>`	Recover canonical session data into a separate database. The active store is not replaced automatically.

hermes sessions list --limit 50 --workspace ./project
hermes sessions export history.md --format md

Setup, status, and diagnostics

Setup, authentication, and updates

Command	Action
`hermes setup`	Run the interactive setup wizard.
`hermes setup --portal`	Set up Nous Portal login, choose a Nous model, and configure the Tool Gateway.
`hermes setup <SECTION>`	Run one setup section: `model`, `tts`, `terminal`, `gateway`, `tools`, `telemetry`, or `agent`.
`hermes auth list [PROVIDER]`	List pooled credentials, optionally filtered by provider.
`hermes auth add <PROVIDER>`	Add a credential. Without `--api-key`, Hermes prompts for the key securely or starts the provider’s OAuth flow.
`hermes auth status <PROVIDER>`	Show authentication status for one provider.
`hermes auth refresh <PROVIDER> [TARGET]`	Refresh a pooled OAuth credential and clear its cooldown.
`hermes update --check`	Check for an available update without installing it.
`hermes update --plan`	Print the read-only update and service-restart plan.
`hermes auth remove <provider> <index>`	Remove one stored credential from a provider pool.
`hermes auth logout <provider>`	Clear the provider’s stored authentication state.
`hermes update`	Install an update on the selected channel. Dependency changes or an installed service may require a restart.

Status, logs, and support

Command	Action
`hermes status`	Show the one-screen status summary.
`hermes status --full`	Show every status section with keys redacted. `--all` is an alias.
`hermes status --deep`	Run deeper checks. This also enables the full report and may take longer.
`hermes doctor`	Check configuration and dependencies.
`hermes doctor --fix`	Ask Hermes to attempt automatic fixes for issues it finds.
`hermes doctor --live`	Run bounded, read-only network health probes against configured tool backends.
`hermes security audit`	Check the Hermes Python environment, plugin dependencies, and pinned MCP packages against OSV vulnerability reports.
`hermes security audit --json`	Output vulnerability findings as JSON for scripts.
`hermes logs <LOG>`	View the last 50 lines. Supported names are `agent` (default), `errors`, `gateway`, `gui`, `desktop`, `update`, `handoff`, and `list`.
`hermes logs -f`	Follow `agent.log` in real time.
`hermes logs <LOG> -n <N>`	Show a chosen number of lines from a log.
`hermes logs --since 1h --level WARNING`	Filter recent log entries by age and severity.
`hermes logs --session <ID> --component tools`	Filter logs by session ID and component.
`hermes dump`	Print a compact setup summary for support. Sensitive values are redacted.
`hermes prompt-size`	Show an offline byte breakdown of prompt and tool-schema content.
`hermes debug share --local`	Build and print a debug report locally without uploading it.
`hermes debug share`	Upload a debug report. The command asks for confirmation and redacts secrets by default.
`hermes debug delete <URL...>`	Delete one or more supported debug pastes.

Skills, MCP servers, and plugins

Skills

Command	Action
`hermes skills list`	List skills installed for the current profile.
`hermes skills browse --source official`	Browse official optional skills.
`hermes skills search react --source skills-sh`	Search the skills.sh directory.
`hermes skills inspect official/security/1password`	Preview an official optional skill before installing it.
`hermes skills install official/security/1password`	Install an official skill with the normal security scan.
`hermes skills tap add myorg/skills-repo`	Add a GitHub repository as a custom skill source.
`hermes skills trust <repo-path>`	Trust the current or named repository so its project-local skills can load.
`hermes skills opt-out`	Stop future seeding of bundled skills for this profile.
`hermes skills opt-in --sync`	Re-enable bundled skills and sync them now.
`hermes skills uninstall <id>`	Remove a hub-installed skill.
`hermes skills check`	Check installed hub skills for updates.
`hermes skills update`	Apply available hub-skill updates.

MCP servers

Command	Action
`hermes mcp`	Open the interactive MCP catalog and connection picker.
`hermes mcp catalog`	List approved catalog entries in plain text.
`hermes mcp install deepwiki`	Install a catalog MCP server by name.
`hermes mcp add codex --preset codex`	Register the Codex CLI MCP server over stdio. The codex executable must be on PATH.
`hermes mcp configure <name>`	Review or change which tools a configured server exposes.
`hermes mcp login <name>`	Authorize or re-authorize an OAuth-protected server.
`hermes mcp test <name>`	Test a configured MCP connection and report the server response.
`hermes mcp list`	List configured MCP servers.
`hermes mcp remove <name>`	Remove a server configuration.
`hermes mcp serve`	Expose Hermes conversations to other agents as an MCP server.

Plugins

Command	Action
`hermes plugins search <term>`	Search the Hermes plugin catalog.
`hermes plugins browse`	Browse all curated catalog entries.
`hermes plugins info <name>`	Show details for one catalog plugin.
`hermes plugins install <catalog-name>`	Install a catalog plugin at its reviewed pinned revision.
`hermes plugins install owner/repo --enable`	Install from Git and request immediate activation.
`hermes plugins list`	Show installed plugins and whether each is enabled, disabled, or not enabled.
`hermes plugins enable <name>`	Activate an installed plugin.
`hermes plugins disable <name>`	Stop loading an installed plugin without removing it.
`hermes plugins update <name>`	Update a tracked plugin after the install-time security scan.
`hermes plugins remove <name>`	Uninstall a plugin and remove its enablement entry.

Messaging and scheduled work

Gateway, sending, and pairing

Command	Action
`hermes gateway setup`	Run the interactive setup for messaging platforms.
`hermes gateway run`	Run the gateway in the foreground. Use foreground mode for Docker and WSL.
`hermes gateway install`	Install the background service: systemd user service on Linux, launchd on macOS, or the Hermes scheduled task on Windows.
`sudo hermes gateway install --system`	Install a Linux system service that can start at boot.
`hermes gateway start`	Start the installed gateway service.
`hermes gateway stop`	Drain and stop the installed gateway service.
`hermes gateway restart`	Gracefully restart the installed gateway service.
`hermes gateway status`	Check whether the gateway service is running.
`hermes gateway list`	List Hermes profiles and the running state of each gateway.
`hermes gateway uninstall`	Remove the installed gateway service.
`hermes gateway status --system`	Inspect the Linux system-level gateway service explicitly.
`hermes send --to <target> "<message>"`	Send a one-shot message using configured credentials. Bot-token platforms can send directly without a running gateway. Persistent-adapter plugins may need one.
`hermes send --to <target> --file <path>`	Send the text content of a file to a messaging target.
`hermes send --list [platform]`	List configured messaging targets, optionally for one platform.
`hermes pairing list`	Show pending and approved messaging users.
`hermes pairing approve <platform> <code>`	Approve a pairing request.
`hermes pairing revoke <platform> <user-id>`	Revoke a messaging user’s access.

Cron jobs

Command	Action
`hermes cron create 'every 2h' 'Check server status'`	Create a recurring agent job using a natural-language interval.
`hermes cron create '0 9 * * 1' 'Write the weekly report'`	Create a Monday 9:00 job with a standard cron expression.
`hermes cron create 'every 1h' 'Summarize new feed items' --skill blogwatcher --skill maps`	Attach one or more installed skills to a scheduled run.
`hermes cron create 'every 6h' 'Scan for news' --continuity`	Include the job’s previous substantive output in later runs.
`hermes cron create 'every 5m' --no-agent --script memory-watchdog.sh --deliver telegram`	Run a script from $HERMES_HOME/scripts/ on the gateway host and deliver stdout directly, without model inference.
`hermes cron create <schedule> <prompt> --workdir /absolute/project/path`	Give a job project context files and use that path for its terminal and file tools.
`hermes cron create <schedule> <prompt> --deliver platform:chat_id`	Send output to a specific configured messaging destination.
`hermes cron list`	List scheduled jobs.
`hermes cron edit <job-id> --schedule 'every 4h'`	Change a job’s schedule.
`hermes cron run <job-id>`	Queue the job for the next scheduler tick.
`hermes cron remove <job-id>`	Delete a scheduled job.
`hermes cron tick`	Run due jobs once and exit. Useful for manual scheduler checks.
`hermes cron pause <job-id>`	Pause a scheduled job.
`hermes cron resume <job-id>`	Resume a paused job.
`hermes cron status`	Check the scheduler state.
`hermes cron doctor`	Check jobs, deliveries, and scheduling health.

Kanban tasks

Command	Action
`hermes kanban init`	Create the default Kanban database.
`hermes kanban boards create <slug>`	Create a named board before selecting it or pinning a process to it.
`hermes kanban boards switch <slug>`	Make a previously created board the current board for this process.
`hermes kanban create 'Research AI funding' --assignee researcher`	Create a task and assign it to a profile.
`hermes kanban create 'Update API docs' --assignee writer --workspace worktree`	Run a coding task in a persistent Git worktree.
`hermes kanban create 'Review inbox' --workspace dir:/absolute/path`	Give a worker access to an existing shared directory. The path must be absolute.
`hermes kanban dispatch --dry-run`	Preview which ready tasks the dispatcher would claim.
`hermes kanban request-review <id> --summary 'Ready for review'`	Hand a completed implementation to a reviewer.
`hermes kanban list`	List tasks on the active board.
`hermes kanban show <id>`	Show a task and its activity.
`hermes kanban block <id> "<reason>"`	Mark a task blocked with a reason.
`hermes kanban unblock <id>`	Return a blocked task to its source phase.

hermes cron create '0 9 * * 1' 'Write the weekly report' --workdir /absolute/project/path
hermes kanban create 'Review API docs' --assignee writer --workspace worktree

Delegation and peer agents

Hermes can delegate work through its agent tools during a conversation. Use /agents to monitor active workers or /review to request an independent review. Configure delegation limits in config.yaml. The peer commands address another registered gateway from a terminal.

Peer gateway commands

Command	Action
`hermes peer add <peer> --url http://<host>:<port> --key <API_SERVER_KEY>`	Register a remote gateway. The key is stored in .env and peer name/URL in config.yaml.
`hermes peer list`	List registered peer gateways.
`hermes peer dm <peer>/<agent> "<message>"`	Send a short request to a named profile on the peer and print its reply.
`hermes peer run <peer> --idempotency-key <key> "<message>"`	Start a long remote turn asynchronously and return its run ID.
`hermes peer status <peer> <run_id>`	Read the status and output of an asynchronous peer run.
`hermes peer stop <peer> <run_id>`	Stop that asynchronous run.
`hermes peer remove <peer>`	Remove a registered peer.

Other terminal command families

These commands handle project workspaces, hooks, integrations, data recovery, and optional interfaces. Run hermes <command> --help for full options on a less common command.

Backups, checkpoints, and migration

Command	Action
`hermes backup --output <path>`	Create a user-data ZIP, including credentials, configuration, skills, and sessions. Keep the archive private.
`hermes backup --quick --label <name>`	Take a smaller snapshot of critical state files.
`hermes import <zipfile>`	Restore a backup over existing Hermes home files. Stop the gateway first. This overwrites newer data with archive contents.
`hermes checkpoints`	Inspect the filesystem-checkpoint shadow store used by /rollback.
`hermes checkpoints prune --retention-days <days>`	Remove stale and orphaned checkpoint projects and enforce the store size cap.
`hermes checkpoints clear`	Delete all filesystem checkpoints after confirmation. This cannot be undone.
`hermes import-agent --help`	Inspect options for importing a Claude Code or Codex CLI setup.
`hermes claw migrate --dry-run`	Preview an OpenClaw migration before importing settings or data.

Hooks and global automation controls

Command	Action
`hermes pause --reason <text>`	Hold new cron jobs, Kanban dispatch, and gateway turns. Work already in progress continues.
`hermes resume`	Remove the global pause so new work can start on the next tick.
`hermes hooks list`	List configured shell hooks and their consent status. Alias: ls.
`hermes hooks test <event>`	Execute matching hooks with a synthetic payload. The configured shell commands really run.
`hermes hooks revoke <command>`	Remove the exact hook command from the allowlist. Takes effect after restart.
`hermes hooks doctor`	Check hook permissions, consent, drift, JSON output, and execution timing.
`hermes webhook list`	List dynamic webhook subscriptions. The webhook platform must be enabled.
`hermes webhook subscribe <name> --prompt <template>`	Create a subscription and return its route and HMAC secret. Payload references use {dot.notation}.
`hermes webhook remove <name>`	Delete a dynamic subscription, leaving static config routes intact.

Skill bundles and maintenance

Command	Action
`hermes bundles list`	List installed skill bundles.
`hermes bundles show <name>`	Show a bundle’s description, constituent skills, and file path.
`hermes bundles create <name> --skill <id>`	Create a bundle. Repeat –skill to include more installed skills.
`hermes bundles delete <name>`	Remove a bundle definition.
`hermes curator status`	Show maintenance status for agent-created skills.
`hermes curator run --dry-run`	Preview skill-maintenance proposals without applying them. An auxiliary-model call may incur usage.
`hermes curator run`	Review agent-created skills and apply maintenance actions. Bundled and hub-installed skills are excluded.
`hermes curator rollback --list`	List skill snapshots available for restoration.
`hermes curator restore <skill>`	Restore an archived skill.
`hermes curator pin <skill>`	Protect a skill from automatic maintenance transitions.

Additional CLI command families

Command	Action
`hermes tools`	Open per-platform tool configuration.
`hermes tools --summary`	Print enabled-tool information without opening the configuration UI.
`hermes project list`	List named project workspaces for the active profile.
`hermes project create <NAME>`	Create a named project workspace that can contain multiple folders.
`hermes worktree list`	Inspect Hermes-created Git worktrees, age, and cleanup eligibility.
`hermes worktree prune --dry-run`	Preview cleanup of safe, merged scratch worktrees.
`hermes-agent --query "<PROMPT>"`	Run a single prompt through the legacy `hermes-agent` entry point. Prefer `hermes -z` for scripts.
`hermes usage --json`	Read configured-account rate-limit information in JSON without opening a session.
`hermes moa list`	List configured Mixture of Agents presets.
`hermes moa configure [name]`	Configure reference models and an aggregator for a preset.
`hermes journey`	Inspect learned skills and memory history. Aliases: learning, memory-graph.
`hermes memory setup`	Select and configure an external memory provider.
`hermes connectors`	Manage hosted connector accounts.
`hermes worktree list`	Inspect Hermes scratch worktrees and cleanup eligibility.
`hermes worktree prune --dry-run`	Preview cleanup of safe scratch worktrees and merged branches.
`hermes project list`	List named multi-folder workspaces for the current profile.
`hermes project --help`	Inspect project creation, folder membership, active-project, archive, and board-binding commands.
`hermes security audit`	Run an on-demand dependency vulnerability audit through OSV.dev.
`hermes approvals --help`	Inspect tools for turning approval history into allowlist proposals.
`hermes proxy --help`	Inspect the local OpenAI-compatible proxy for OAuth provider credentials.
`hermes egress status`	Inspect the optional outbound credential-injection proxy for remote sandboxes.
`hermes lsp --help`	Inspect Language Server Protocol integration and diagnostic configuration.
`hermes dashboard`	Launch the web management dashboard.
`hermes serve --help`	Inspect headless backend-server options for desktop or remote clients.
`hermes desktop`	Build and launch the native desktop application. Alias: gui.
`hermes acp --help`	Inspect Agent Client Protocol server options for editor integrations.
`hermes completion bash`	Print Bash completion code. Other supported shells include zsh and fish.
`hermes computer-use status`	Check whether the Computer Use backend is installed.
`hermes pets list`	Browse the animated-pet gallery.
`hermes skin --help`	Inspect display-skin commands.
`hermes console`	Open the Hermes command console.
`hermes insights`	Show token, cost, and activity analytics.
`hermes portal status`	Show Nous Portal authentication and Tool Gateway routing.
`hermes secrets bitwarden setup`	Configure Bitwarden Secrets Manager as an external credential source. Requires its access token.
`hermes migrate xai`	Preview replacements for retired xAI model references in the active configuration. Add –apply to write the changes.
`hermes codex-runtime migrate --dry-run`	Preview the Hermes-managed configuration projected into the Codex app-server runtime.
`hermes slack manifest`	Print a Slack app manifest with native gateway slash commands.
`hermes whatsapp`	Open WhatsApp bridge setup and QR-code pairing.
`hermes whatsapp-cloud --help`	Inspect the Meta WhatsApp Business Cloud API setup. Requires a Business account and public webhook.
`hermes uninstall --help`	Inspect removal options before uninstalling Hermes.

Slash commands

Session and context

Command	Action
`/new [name]`	Start a new session (fresh session ID + history). Alias: `/reset`.
`/clear`	CLI only. Clear the screen and start a new session.
`/redraw`	CLI only. Repaint the terminal UI.
`/history`	CLI only. Show conversation history.
`/save <json\|md\|html> [filename] [redact]`	Export the conversation as JSON, Markdown, or HTML.
`/retry`	Retry the last message (resend to agent).
`/prompt [initial text]`	CLI only. Compose your next prompt in $EDITOR (markdown), then send it. Alias: `/compose`.
`/undo [N]`	Back up user turns and re-prompt.
`/title [name]`	Set a title for the current session.
`/handoff <platform>`	CLI only. Hand this session to a messaging platform.
`/branch [--here] [name]`	Branch the current session (or use –here to stay on the branch). Alias: `/fork`.
`/worktree`	Show worktrees. Use `new`, `list`, or `prune --dry-run` for the named action. CLI only.
`/compress`	Compress context. `here <N>` keeps recent turns, `focus <topic>` narrows the summary, and `--preview` or `--dry-run` shows the result first. Alias: `/compact`.
`/rollback [number] [--all]`	List or restore filesystem checkpoints. –all includes hand-edited files.
`/snapshot [create\|restore <id>\|prune]`	CLI only. Create or restore Hermes state snapshots. Alias: `/snap`.
`/stop`	Classic CLI: stop background processes and asynchronous delegations. Messaging: interrupt the active run or outstanding session delegations while keeping the session.
`/bg <prompt>`	Run a prompt in a separate background session.
`/btw <question>`	Ask a side question without interrupting the current turn.
`/agents`	Show active agents and running tasks. Alias: `/tasks`.
`/journey [list\|delete <id>\|edit <id>]`	CLI only. Open the learning timeline. Unavailable in messaging. Aliases: `/learning`, `/memory-graph`.
`/queue <prompt>`	Queue a prompt. Use `list`, `edit`, `rm`, `move`, or `clear` to manage the queue. Alias: `/q`.
`/steer <prompt>`	Add direction after the next tool call. Alias: `/s`.
`/goal <text>`	Set a standing goal. Use `show`, `status`, `gate add`, `pause`, `resume`, `clear`, `wait`, or `unwait` to manage it.
`/heartbeat every <interval> <prompt>`	Set a recurring idle prompt. Use `status`, `pause`, `resume`, or `clear` to manage it. Alias: `/hb`.
`/refine [focus instructions]`	Review the conversation and save useful lessons.
`/review [review instructions]`	Spawn an independent subagent to review the work just discussed (PR, code, docs).
`/loop [interval] <prompt> [--times N] [--until <condition>]`	Repeat a prompt at an interval. Omit the interval to run continuously. Manage it with `/loop status`, `/loop pause`, `/loop resume`, or `/loop stop`. Alias: `/proactive`.
`/plan [task]`	Write a markdown implementation plan to .hermes/plans/ without executing anything.
`/moa <prompt>`	Run a prompt through the default Mixture of Agents preset.
`/subgoal <text>`	Add an active-goal criterion. Use `remove <N>` or `clear` to change it.
`/status`	Show session, model, token, and context info.
`/egress [status]`	Show Docker egress proxy status.
`/context [all]`	Show context-window usage, category breakdown, compression, and throughput. Alias: `/ctx`.
`/resume [name]`	Resume a named session.
`/sessions`	Browse sessions. In the TUI, open live sessions.
`/quit [--delete]`	CLI only. Exit the CLI. –delete also removes session history. Alias: `/exit`.

Settings and display

Command	Action
`/export [profile] [-o output.tar.gz]`	CLI only. Export profile settings and skills to an archive.
`/import <archive.tar.gz> [--name <name>]`	CLI only. Import an archive as a new profile.
`/config`	CLI only. Show current configuration.
`/model [model] [--provider name] [--reasoning level] [--global\|--session] [--refresh]`	Switch among configured models in the current session. Use `--global` to save the default; add providers with `hermes model` from the shell.
`/codex-runtime [auto\|codex_app_server]`	Toggle the Codex app-server runtime. Alias: `/codex_runtime`.
`/personality [name]`	Set a predefined personality.
`/statusbar`	CLI only. Toggle the status bar. Alias: `/sb`.
`/battery [on\|off\|status]`	CLI only. Toggle the battery indicator.
`/timestamps [on\|off\|status]`	CLI only. Toggle message timestamps. Alias: `/ts`.
`/verbose`	CLI only. Cycle tool progress display: off -> new -> all -> verbose. Messaging requires display.tool_progress_command: true.
`/focus [on\|off\|status]`	CLI only. Show only your prompt and final response.
`/footer [on\|off\|status]`	Toggle the runtime metadata footer.
`/yolo`	Toggle YOLO mode (skip all dangerous command approvals).
`/approvals [manual\|smart\|off]`	Show or set the persistent dangerous-command approval mode.
`/reasoning [level\|show\|hide\|full\|clamp] [--global]`	Manage reasoning effort and display.
`/fast [normal\|fast\|auto\|cold\|ultrafast\|status] [--global]`	Set fast-processing mode (OpenAI or Anthropic).
`/skin [name]`	CLI only. Show or change the display theme.
`/indicator [ascii\|emoji\|kaomoji\|unicode]`	CLI only. Choose the terminal busy-indicator style.
`/voice [on\|off\|tts\|status]`	Control voice mode. Join, channel, and leave are Discord-only.
`/wake [on\|off\|status]`	CLI only. Toggle the Hey Hermes wake-word listener.
`/busy [queue\|steer\|interrupt\|status]`	Choose how messages behave while Hermes is working.

Tools, skills, and automation

Command	Action
`/tools [list\|disable\|enable] [name...]`	CLI only. Manage available tools.
`/toolsets`	CLI only. List available toolsets.
`/skills`	CLI only. Search, install, inspect, or manage skills. Messaging write-review subcommands require skills.write_approval.
`/memory [pending\|approve\|reject\|approval] [id\|on\|off]`	Review pending memory writes or set the approval gate.
`/bundles`	List skill bundles (aliases /<name> for multiple skills).
`/pet [toggle\|list\|scale <n>\|<slug>]`	CLI only. Toggle or select a mascot.
`/hatch [description]`	CLI only. Generate a pet from a description. Alias: `/generate-pet`.
`/learn <what to learn from>`	Create a reusable skill from supplied material.
`/init [notes]`	Generate or update repository instructions.
`/cron [subcommand]`	CLI only. Manage scheduled tasks.
`/suggestions`	Review suggested automations. Use `accept`, `dismiss <N>`, or `catalog`.
`/blueprint [name] [slot=value ...]`	Set up an automation from a blueprint. Alias: `/bp`.
`/curator [subcommand]`	Control background skill maintenance.
`/kanban [subcommand]`	Manage tasks and collaboration boards across profiles.
`/reload`	CLI only. Reload .env variables into the running session.
`/reload-mcp`	Reload MCP servers from config. Alias: `/reload_mcp`.
`/reload-skills`	Refresh the installed-skill list. Alias: `/reload_skills`.
`/browser [connect\|disconnect\|status\|use]`	CLI only. Connect browser tools via CDP or switch to Browser Use mode.
`/plugins`	CLI only. Show installed plugins and their status.

Information and diagnostics

Command	Action
`/whoami`	Show slash-command access level.
`/profile`	Show the active profile and Hermes home.
`/diff [staged\|all\|session] [--stat] [path...]`	Show git changes in the working directory.
`/help [skills\|<filter>]`	Show available commands (/help skills lists skill commands, /help <text> filters).
`/palette`	Classic CLI only. Open the fuzzy command palette. `Ctrl+P` is an alternative.
`/usage [reset [--force]]`	Show token usage, cost, and provider limits.
`/subscription`	CLI only. View or change your Nous plan. Alias: `/upgrade`.
`/login`	Sign in with a Nous account.
`/topup`	Show balance and billing options.
`/insights [days]`	Show usage insights.
`/platforms`	CLI only. Show messaging gateway platform status. Alias: `/gateway`.
`/copy [number]`	CLI only. Copy an assistant reply to the clipboard.
`/paste`	CLI only. Attach an image from the clipboard.
`/image <path>`	CLI only. Attach a local image to the next prompt.
`/update`	Update Hermes Agent.
`/version`	Show Hermes version. Alias: `/v`.
`/debug [nous\|local]`	Upload debug report (system info + logs) and get shareable links.

Messaging-only commands

These commands run in configured messaging chats.

Command	Action
`/start`	Acknowledge platform start pings without a reply.
`/topic [off\|help\|session-id]`	Enable or inspect Telegram DM topic sessions.
`/pause <reason>`	Pause new messaging work globally. `/pause off` resumes it.
`/approve [session\|always]`	Approve a pending dangerous command.
`/deny [all] [reason]`	Deny a pending dangerous command (optionally with a reason).
`/sethome`	Set this chat as the home channel. Alias: `/set-home`.
`/commands [page]`	Browse all commands and skills (paginated).
`/restart`	Gracefully restart the gateway after draining active runs.
`/platform list`	List messaging platforms. Use `pause <name>` or `resume <name>` to change one.

Dynamic commands

Installed skills, bundles, and user-defined Quick Commands can add slash names.

Command	Action
`/<skill-name> [arguments]`	Load an installed skill on demand. Built-in commands win name conflicts; invoke a colliding skill with `/skill <name>`.
`/<bundle-name> [arguments]`	Run a configured skill bundle that loads multiple skills.
`/<quick-name> [arguments]`	Run a user-defined exec shell command or dispatch an alias to another slash command. String-only prompt shortcuts are unsupported.

Modern TUI views

The TypeScript TUI adds panels and controls to the shared slash-command set. These entries apply when Hermes starts with --tui or display.interface is set to tui.

Command	Action
`/help`	Open the categorized command overlay.
`/sessions`	Open the live-session switcher for sessions active in this TUI process. Alias: `/switch`.
`/model [model]`	Open the provider-grouped model picker.
`/skin [name]`	Preview and apply a theme while browsing.
`/usage`	Open a token, cost, and context panel.
`/agents`	Open the live agent and process monitor. Alias: `/tasks`.
`/reload`	Reload ~/.hermes/.env into the running TUI process.
`/connectors`	TUI only. List connector accounts and rename, add, reconnect, or remove them.
`/details [hidden\|collapsed\|expanded\|cycle]`	Set or cycle global tool-call detail visibility.
`/details <section> [hidden\|collapsed\|expanded\|reset]`	Set or reset visibility for one detail section. Alias: `/detail`.
`/mouse [on\|off\|toggle\|wheel\|buttons\|all]`	Choose a mouse-tracking preset. The setting is saved to config. Alias: `/scroll`.
`/terminal-setup [auto\|cursor\|vscode\|windsurf]`	Install local IDE terminal bindings for multiline input and undo/redo.
`/density [on\|off\|toggle]`	TUI only. Toggle compact display density.
`/theme [auto\|light\|dark]`	TUI only. Choose automatic, light, or dark mode.

Classic CLI keyboard shortcuts

Shortcut	Action
`Enter`	Send the message.
`Alt+Enter`	Insert a newline. On Windows Terminal, use `Ctrl+Enter` or `Ctrl+J` because Alt+Enter toggles fullscreen.
`Ctrl+J`	Insert a newline. `Shift+Enter` also works when supported by the terminal.
`Alt+V`	Paste a clipboard image when the terminal supports it.
`Ctrl+V`	Paste text. The CLI may also attach a clipboard image.
`Ctrl+G`	Open the draft in `$EDITOR`. Save and quit to send it. `Ctrl+X Ctrl+E` is an alternative.
`Ctrl+C`	Clear a typed draft. With an empty composer, interrupt Hermes. Press twice within two seconds to force exit.
`Ctrl+D`	Exit the classic CLI.
`Ctrl+B`	Start or stop voice recording when voice mode is enabled.
`Ctrl+S`	Stash a draft. Press again on an empty composer to restore it.
`Ctrl+T`	Open the live work monitor. `F6` is an alternative. In its roster, `s` steers a worker.
`Ctrl+R`	Toggle the live-work dock. `F7` is an alternative.
`Ctrl+Z`	Suspend Hermes on Unix. Run `fg` in the shell to resume.
`Tab`	Accept a suggestion or complete a slash command.
`Ctrl+P`	Open the fuzzy command palette. Up/Down move through matches and Enter inserts the selected command. Also opens with `/palette`.
`Up`	Move up one line or browse earlier prompt history at the first line.
`Down`	Move down one line or browse later prompt history at the last line.
`Ctrl+A`	Move to the start of the line.
`Ctrl+E`	Move to the end of the line.
`Ctrl+U`	Delete from the cursor back to the start of the line.
`Ctrl+K`	Delete from the cursor to the end of the line.
`Ctrl+W`	Delete the word before the cursor.
`Alt+B`	Move back one word.
`Alt+F`	Move forward one word.
`Alt+Backspace`	Delete the word before the cursor.
`Alt+D`	Delete the word after the cursor.
`Ctrl+Y`	Restore the most recently cut text.

TUI keyboard shortcuts

Shortcut	Action
`Enter`	Send the prompt.
`Alt+Enter`	Insert a newline. Windows Terminal captures this key for fullscreen, so use `Ctrl+Enter` or `Ctrl+J` there. `Shift+Enter` works when the terminal distinguishes it from Enter.
`Alt+V`	Paste a clipboard image when the terminal supports it.
`Cmd+V`	Paste on macOS. The TUI may attach a clipboard image.
`Ctrl+V`	Paste on Windows or Linux. The TUI may attach a clipboard image.
`Ctrl+B`	Start or stop voice recording when voice mode is enabled.
`Ctrl+G`	Open the draft in `$EDITOR`. `Ctrl+X Ctrl+E` also opens it.
`Ctrl+S`	Stash a draft. Press again to restore it, or browse/discard when several drafts are parked.
`Ctrl+C`	Clear a typed draft. With an empty composer, interrupt Hermes. Double-press within 2 seconds to force exit.
`Ctrl+T`	Expand the live-work dock into the agents roster. `F6` is an alternative.
`Ctrl+R`	Toggle the live-work dock. `F7` is an alternative. Refresh inside the session switcher.
`Ctrl+X`	Open the live-session switcher. With selected text it cuts the selection, and while editing a queued message it removes that queued item.
`Ctrl+D`	Exit from an empty composer. Inside the session switcher, close the selected live session.
`Ctrl+Z`	Suspend Hermes on Unix. Run fg in the shell to resume.
`Tab`	Accept ghost-text suggestion or slash-command completion.
`Mouse drag`	Select text in the transcript.

Inside the agents roster

Shortcut	Action
`Up`	Move selection in the agents roster.
`Down`	Move selection in the agents roster.
`Enter`	Open the selected agent transcript. `t` is an alternative.
`d`	Show selected agent details.
`e`	Steer the selected agent.
`x`	Request that the selected agent stop.

Inside the session switcher

Shortcut	Action
`Up`	Move selection in the session switcher.
`Down`	Move selection in the session switcher.
`Enter`	Switch to the selected live session.
`Ctrl+N`	Start a new session from the switcher.
`Ctrl+D`	Close the selected live session.
`Ctrl+R`	Refresh the session list.
`Esc`	Close the session switcher.

Configuration files and commands

File	Action
`~/.hermes/config.yaml`	Default configuration file on POSIX systems. On Windows, the default home is `%LOCALAPPDATA%\hermes`.
`~/.hermes/.env`	Credentials and other environment variables for the active profile.

Config CLI

Command	Action
`hermes config show`	Print the active merged configuration.
`hermes config set terminal.backend docker`	Set a dotted config.yaml value. The terminal backend runs agent shell/code tools.
`hermes config set DISCORD_BOT_TOKEN <token>`	Save a credential in the active profile .env file.
`hermes config get model.default`	Print one resolved setting by dotted key.
`hermes config edit`	Open the active config.yaml in the configured editor.
`hermes config set <key> <value>`	Write a dotted setting to config.yaml or an uppercase environment name to .env.
`hermes config unset <key>`	Remove a setting or secret and return it to its built-in default.
`hermes config path`	Print the active config.yaml path.
`hermes config env-path`	Print the active .env path.
`hermes config check`	Check for missing, stale, or inactive settings.
`hermes config migrate`	Interactively add or update options introduced by the installed release.
`hermes config set OPENROUTER_API_KEY <key>`	Store a provider API key in the active profile .env without writing it to config.yaml.

hermes config get model.provider
hermes config set model.default <model-id>
hermes config set OPENROUTER_API_KEY <key>
hermes config check

Configuration keys

Model, agent, and display

Configuration key	Action
`model.default`	Choose the default model ID for new sessions.
`model.provider`	Choose the provider route. Provider credentials are read from the matching environment variable.
`model.base_url`	Set a custom OpenAI-compatible endpoint for the selected provider.
`model.context_length`	Override the model context window when the endpoint or catalog reports the wrong size.
`agent.max_turns`	Set the maximum tool iterations per conversation turn. Omit the key or set it to null to leave turns uncapped.
`agent.reasoning_effort`	Set the default reasoning level. Supported values include none through ultra.
`compression.enabled`	Keep automatic conversation compression enabled for long sessions.
`compression.threshold`	Start compression at the configured fraction of the model context window.
`compression.target_ratio`	Preserve the recent tail up to this fraction of the trigger threshold.
`auxiliary.compression.provider`	Choose the provider for compression summaries. `auxiliary.compression.model` selects its model.
`memory.memory_enabled`	Enable bounded persistent memory in the agent context.
`memory.memory_char_limit`	Limit the curated memory text injected into the system prompt.
`memory.write_approval`	Require approval for memory writes and stage background-review suggestions.
`display.interface`	Choose `cli` for the classic interface or `tui` for the modern terminal interface.
`display.tool_progress_command`	Allow tool-progress controls in messaging.
`auxiliary.compression.model`	Choose the model for compression summaries.

Terminal, skills, MCP, and plugins

Configuration key	Action
`terminal.backend`	Choose `local`, `docker`, `ssh`, `modal`, `daytona`, `vercel_sandbox`, or `singularity` for agent terminal tools.
`terminal.cwd`	Set the working directory used by gateway and cron agent runs. Interactive CLI uses its launch directory.
`terminal.home_mode`	Choose `auto`, `real`, or `profile` for subprocess HOME handling.
`terminal.env_passthrough`	Forward named environment variables into sandboxed terminal and execute_code sessions.
`skills.auto_load`	Load listed skills at the start of every new session.
`skills.external_dirs`	Scan additional skill directories alongside ~/.hermes/skills/.
`skills.create_dir`	Choose where newly authored skills are saved.
`skills.write_approval`	Stage agent skill edits and deletions for review before applying them.
`mcp_servers.<name>.command`	Set the executable for a local stdio MCP server. Use `mcp_servers.<name>.args` for its arguments.
`mcp_servers.<name>.url`	Connect to a remote HTTP MCP endpoint.
`mcp_servers.<name>.headers`	Set HTTP headers. Reference secrets as ${ENV_VAR} so credentials stay in .env.
`mcp_servers.<name>.tools.include`	Expose only the listed tools from that server.
`mcp_servers.<name>.tools.exclude`	Hide listed tool names or patterns while leaving other server tools enabled.
`plugins.enabled`	Allow the named plugin to load its hooks and tools.
`plugins.disabled`	Deny a plugin even when its name also appears in the enabled list.
`plugins.auto_apply`	Opt tracked Git plugins into unattended updates. Manual updates are the default.
`mcp_servers.<name>.args`	Pass argument strings to a local stdio MCP server.

Gateway, automation, and delegation

Configuration key	Action
`gateway.allow_all_users`	Allow any messaging user when set to `true`. The default is `false`.
`cron.model`	Set the default model for scheduled jobs without a model override.
`cron.model_provider`	Set the default provider for scheduled jobs without a provider override.
`cron.max_parallel_jobs`	Limit the number of scheduled agent runs active at once.
`cron.preflight`	Validate provider credentials, attached skills, delivery targets, and MCP toolsets before a scheduled agent run.
`cron.allow_agent_scheduling`	Allow cron-run agents to create, edit, or remove jobs. Disabled by default.
`kanban.dispatch_in_gateway`	Run the dispatcher inside the gateway. This is the default.
`kanban.dispatch_interval_seconds`	Set the embedded dispatcher’s polling interval.
`kanban.max_in_progress`	Cap the number of active tasks across a board.
`kanban.max_in_progress_per_profile`	Limit concurrent worker tasks for each assignee profile.
`delegation.max_concurrent_children`	Cap parallel children per batch and concurrent background delegation units. Set it explicitly when the same capacity is required across installations.
`delegation.max_spawn_depth`	Keep delegation flat by default. Raise it to allow orchestrator children to spawn descendants.
`delegation.worktree_isolation`	Keep children in the shared working directory by default. Enable isolated Git worktrees for local-backend repositories.
`delegation.max_iterations`	Set each child agent’s tool-call iteration budget.
`delegation.model`	Choose the model for delegated child agents. Empty value inherits the parent model.
`delegation.provider`	Choose the provider for delegated child agents. `auto` inherits the parent route.
`bot_peers.<name>`	Stores peer names and gateway URLs. Credentials use HERMES_PEER_<NAME>_KEY in .env.

model:
  provider: openrouter
  default: <model-id>
terminal:
  backend: local
compression:
  enabled: true

mcp_servers:
  filesystem:
    command: npx
    args: [-y, "@modelcontextprotocol/server-filesystem", /home/user/projects]
  company_api:
    url: https://example.com/mcp
    headers:
      Authorization: "Bearer ${COMPANY_MCP_TOKEN}"

Environment variables

Environment variable	Action
`HERMES_TIMEZONE`	Override the local timezone with an IANA timezone name.
`HERMES_TUI`	Set to `1` to launch the modern TUI when running `hermes`.
`HERMES_TUI_THEME`	Use `light`, `dark`, or a six-character hex background to choose the TUI color theme.
`HERMES_INFERENCE_MODEL`	Override the inference model for a run; can also be set with `--model`.
`OPENROUTER_API_KEY`	OpenRouter credential. Save with hermes config set OPENROUTER_API_KEY <key> or place in .env.
`OPENAI_API_KEY`	OpenAI API or explicitly configured custom endpoint credential.
`ANTHROPIC_API_KEY`	Anthropic Console API credential.
`GOOGLE_API_KEY`	Google AI Studio credential. GEMINI_API_KEY is an alias.
`XAI_API_KEY`	xAI API credential for Grok routes.
`TELEGRAM_BOT_TOKEN`	Store a Telegram bot credential in .env.
`TELEGRAM_ALLOWED_USERS`	Restrict Telegram access to the listed user IDs.
`DISCORD_ALLOWED_USERS`	Restrict Discord access to the listed user IDs.
`GATEWAY_ALLOWED_USERS`	Apply one comma-separated user allowlist across all messaging platforms.
`GATEWAY_ALLOW_ALL_USERS`	Control global allow-all access. Default false, and the environment variable overrides gateway.allow_all_users.
`HERMES_CRON_TIMEOUT`	Set the cron agent’s inactivity timeout in seconds. 0 disables it.
`HERMES_CRON_SCRIPT_TIMEOUT`	Set the script-only job timeout in seconds.
`HERMES_KANBAN_BOARD`	Pin a process and its workers to a board created with hermes kanban boards create <slug>.
`DELEGATION_MAX_CONCURRENT_CHILDREN`	Set the child concurrency cap through the process environment.
`API_SERVER_KEY`	Credential required by the remote gateway when its api_server platform is enabled.
`HERMES_HOME`	Select the configuration and data home. Defaults to `~/.hermes` on POSIX and `%LOCALAPPDATA%\hermes` on Windows.
`HERMES_PEER_<NAME>_KEY`	Store a registered peer gateway credential.