> ## Documentation Index
> Fetch the complete documentation index at: https://herm.liftaris.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Slash commands

> Type / in the Herm composer to open local client commands and gateway-discovered commands for sessions, skills, plugins, and MCP prompts.

Slash commands give you quick, keyboard-driven access to Herm's full feature surface without leaving the composer. Typing `/` in the input area opens a live popover that filters commands as you type, shows descriptions and argument hints, and supports tab-completion for subcommands. Press `Return` on a highlighted entry, or finish typing the command and press `Return`.

## How the popover works

Start typing `/` followed by the command name. The popover narrows the list in real time across both command names and their aliases. For commands that accept subcommands (for example `/voice on`), continue typing after a space and the popover switches to subcommand completions automatically.

```text theme={null}
/theme          → opens the theme picker
/reload-mcp now → restarts MCP servers immediately
/voice on       → enables voice recording
```

<Note>
  The popover merges **local commands** (handled directly by the Herm client) with **gateway commands** discovered from the live Hermes gateway, including skills, plugins, and MCP prompts. The tables on this page cover the built-in local commands. Gateway commands appear in the same popover once the connection is established.
</Note>

## Command categories

Commands are grouped into four categories:

<CardGroup cols={2}>
  <Card title="Client" icon="display">
    Actions handled entirely inside the Herm TUI: themes, skins, UI toggles, clipboard, voice, and diagnostics.
  </Card>

  <Card title="Session" icon="terminal">
    Commands that act on the active Hermes Agent session: steering, queueing, reloading, goal control, and browser management.
  </Card>

  <Card title="Info" icon="circle-info">
    Read-only status panels: usage stats, profile details, session history, and version/path information.
  </Card>

  <Card title="Exit" icon="door-open">
    Commands that close or restart Herm.
  </Card>
</CardGroup>

## Built-in local commands

The following fallback catalog is generated from `src/app/slashCommands.ts` in the Herm source repo. Herm also intercepts some live-session gateway commands for safety. Gateway commands, skills, plugins, and MCP prompts are discovered at runtime.

## Client commands

| Command     | Aliases | Args                     | Description                           |
| ----------- | ------- | ------------------------ | ------------------------------------- |
| `/clear`    | None    | `None`                   | Clear chat messages                   |
| `/new`      | `reset` | `None`                   | Start a new session                   |
| `/theme`    | None    | `[light\|dark]`          | Switch color theme or mode            |
| `/help`     | None    | `None`                   | Show keyboard shortcuts               |
| `/keys`     | None    | `None`                   | Rebind keyboard shortcuts             |
| `/logs`     | None    | `None`                   | Show gateway stderr log               |
| `/title`    | None    | `[text]`                 | Set session title                     |
| `/rollback` | None    | `None`                   | Browse & restore checkpoints          |
| `/chafa`    | None    | `<path>`                 | Render image via chafa (demo)         |
| `/splash`   | None    | `None`                   | Show the launch splash                |
| `/skin`     | None    | `[name]`                 | Switch Hermes skin (+ theme + eikon)  |
| `/voice`    | None    | `[on\|off\|status\|tts]` | Toggle voice recording                |
| `/stash`    | None    | `[pop\|list]`            | Park the prompt (pop/list to restore) |

## Session commands

| Command          | Aliases         | Args                                         | Description                                         |
| ---------------- | --------------- | -------------------------------------------- | --------------------------------------------------- |
| `/steer`         | None            | `[text]`                                     | Inject a note mid-turn (no interrupt)               |
| `/reload-mcp`    | None            | `[now\|always]`                              | Restart MCP servers & rediscover tools              |
| `/reload`        | None            | `None`                                       | Hot-reload \~/.hermes/.env (API keys)               |
| `/reload-skills` | `reload_skills` | `None`                                       | Re-scan \~/.hermes/skills/ for added/removed skills |
| `/goal`          | None            | `[text\|done\|pause\|resume\|clear\|status]` | Set/control the session goal                        |
| `/queue`         | `q`             | `[text]`                                     | Queue a prompt for the next idle turn               |
| `/redo`          | None            | `None`                                       | Re-send the last undone message                     |
| `/branch`        | `fork`          | `[name]`                                     | Fork current conversation                           |
| `/browser`       | None            | `[connect\|disconnect\|status] [url]`        | Connect/disconnect a CDP browser                    |
| `/yolo`          | None            | `None`                                       | Toggle approval bypass for the current session      |

## Info commands

| Command    | Aliases | Args   | Description                                         |
| ---------- | ------- | ------ | --------------------------------------------------- |
| `/history` | None    | `None` | Server-side transcript viewer                       |
| `/status`  | None    | `None` | Version, model, paths                               |
| `/usage`   | None    | `None` | Credits, account status, tokens, context fill, cost |
| `/profile` | None    | `None` | Active profile details                              |

## Exit commands

| Command | Aliases | Args   | Description |
| ------- | ------- | ------ | ----------- |
| `/quit` | `exit`  | `None` | Exit herm   |

## Additional live-session commands

Herm intercepts some commands that may also exist in the gateway so they act on the active TUI session safely. Common examples include:

| Command                       | Description                                             |
| ----------------------------- | ------------------------------------------------------- |
| `/model`                      | Open the model picker or set a model value              |
| `/resume`                     | Open session selection or resume by id                  |
| `/compress`                   | Compress current context                                |
| `/undo` / `/retry`            | Rewind or retry recent session turns                    |
| `/copy` / `/paste` / `/image` | Work with reply text, clipboard images, and image paths |
| `/mouse` / `/redraw`          | Toggle mouse capture or repaint the terminal            |

<Accordion title="Goal subcommands">
  The `/goal` command accepts several subcommands:

  | Subcommand | Effect                                    |
  | ---------- | ----------------------------------------- |
  | `[text]`   | Set the session goal to the provided text |
  | `done`     | Mark the current goal as complete         |
  | `pause`    | Pause goal tracking                       |
  | `resume`   | Resume a paused goal                      |
  | `clear`    | Clear the goal entirely                   |
  | `status`   | Print the current goal and its state      |
</Accordion>

<Accordion title="YOLO mode (/yolo)">
  The `/yolo` command toggles approval bypass for the active Hermes Agent session. When enabled, tool calls that would normally prompt for confirmation run without interruption. Herm intercepts the command locally and routes it through the gateway's `config.set` path so the new state applies immediately to the current session only — other sessions and your saved config are unaffected.

  After running `/yolo`, the new state is reflected in `session.info.yolo` (`true` when bypass is on) and Herm shows a toast like `yolo on` or `yolo off`. Run `/yolo` again to toggle it back.

  ```text theme={null}
  /yolo   # toggle approval bypass for this session
  ```

  <Warning>
    YOLO mode disables per-call approvals for the active session. Only enable it when you trust the prompt, tools, and working directory.
  </Warning>
</Accordion>

<Accordion title="Browser subcommands">
  The `/browser` command manages a CDP browser connection:

  | Subcommand      | Effect                                                             |
  | --------------- | ------------------------------------------------------------------ |
  | `connect [url]` | Connect to a running Chrome/Chromium instance at the given CDP URL |
  | `disconnect`    | Disconnect the active browser session                              |
  | `status`        | Show whether a browser is connected and its URL                    |
</Accordion>

## Gateway and skill commands

In addition to the built-in commands listed above, the popover also surfaces commands registered on your Hermes gateway. These include:

* **Skills**: custom scripts in `~/.hermes/skills/` that expose slash commands.
* **Plugins**: gateway-side plugins that register named commands.
* **MCP prompts**: prompt templates served by connected MCP servers and surfaced as `/mcp-prompt-name` entries.

Gateway commands appear in the same popover once the live Hermes gateway is connected. Herm forwards them to the gateway unless the command needs local live-session handling. Use `/reload-skills` or `/reload-mcp` to refresh the list after adding new skills or MCP servers.

<Tip>
  If the gateway is unreachable at startup, the popover falls back to showing only local commands. Gateway commands appear automatically once the connection is restored: no restart required.
</Tip>

## Related docs

* [Chat](/features/chat)
* [Keybindings](/customization/keybindings)
* [Config tab](/features/config)