Skip to main content
Herm is published as the herm-tui package and runs on top of Hermes Agent.
Install and configure Hermes Agent before launching Herm. Herm does not bundle or replace the agent runtime. It expects a Hermes home at ~/.hermes, or HERMES_HOME pointing to another Hermes home.
1

Try Herm without installing

If you have Bun installed, run Herm from the registry:
Double-tap Ctrl+C to quit, or use Ctrl+K to open the command palette and choose an exit action.
2

Install Herm globally

Install the herm command with Bun or npm.
The @next tag tracks development releases and can break. Use the stable tag for normal use.
3

Verify the command

Check that the launcher is on your PATH:
4

Launch Herm

Start a fresh session or resume the most recent session:
Herm reads HERMES_HOME, starts the Hermes Agent gateway subprocess, and renders the TUI. If startup fails, open Common issues.
5

Navigate the interface

Herm has five top-level tabs.
6

Send your first message

Go to the Chat tab, type a prompt in the composer, and press Enter.Use @ to attach files or diffs. Use / for commands such as /model, /theme, /keys, /new, and /status.

​
Next steps

Chat features

Streaming, file context, slash commands, voice mode, and tool frames.

Themes and keybindings

Theme picker, skins, leader key, and rebindable shortcuts.

Sessions

Resume, title, inspect, branch, and compress sessions.

​
Related docs