> ## 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.

# Herm: keyboard-driven terminal UI for Hermes Agent

> Herm is a keyboard-driven terminal UI for Hermes Agent. Chat, inspect sessions, manage config, run automation, and work with eikons from one shell.

<Note>
  Herm is a TUI client for Hermes Agent. Hermes Agent owns model providers, tool execution, sessions, profiles, cron, skills, memory, MCP, and gateway runtime behavior. Herm gives you a terminal interface for operating those surfaces.
</Note>

Herm is a keyboard-driven terminal UI for Hermes Agent. Hermes Agent handles inference, tools, profiles, sessions, skills, memory, cron, MCP, and gateway runtime behavior. Herm gives those surfaces a single terminal interface.

## Why use Herm?

Herm is useful when your Hermes workflow spans more than one chat prompt.

* **Chat in the terminal:** stream responses, inspect tool calls, attach files, and use slash commands.
* **Inspect session state:** browse history, context, lineage, usage, model, cost, and tool details.
* **Operate your Hermes home:** manage profiles, cron jobs, kanban boards, config, env vars, skills, toolsets, and memory providers.
* **Customize the shell:** use themes, skins, keybindings, a command palette, and eikon avatars.

## Tab overview

Herm has five top-level tabs. Use `Alt+Left` / `Alt+Right` to cycle, `Alt+1` through `Alt+5` to jump directly, or `<leader>1` through `<leader>5` if you prefer leader-key navigation.

| # | Tab                       | What it contains                                                           |
| - | ------------------------- | -------------------------------------------------------------------------- |
| 1 | **Chat**                  | Main chat interface, file context, slash commands, voice mode, tool frames |
| 2 | **Sessions**              | Session list, context inspector, analytics                                 |
| 3 | **Profiles & Automation** | Kanban, profiles, live delegation view, cron jobs                          |
| 4 | **Config**                | Config, skills, toolsets, env vars, memory providers                       |
| 5 | **Eikon**                 | Gallery, Studio, Marketplace                                               |

Tabs with sub-tabs use **Shift+Left** and **Shift+Right** for sub-tab navigation.

## Requirements

Before installing Herm, make sure these are available:

* **Hermes Agent:** Herm is a client for the Hermes Agent gateway.
* **Bun 1.3.0 or newer:** recommended for install and development. npm install is also supported.
* **A Hermes home:** defaults to `~/.hermes`; set `HERMES_HOME` if yours lives elsewhere.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install Herm and send your first message.
  </Card>

  <Card title="Chat" icon="message" href="/features/chat">
    Streaming responses, file context, slash commands, voice mode, and tool frames.
  </Card>

  <Card title="Eikon avatars" icon="user-astronaut" href="/eikon/overview">
    Browse, create, install, and activate terminal avatars.
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration">
    Environment variables, preferences, and custom paths.
  </Card>
</CardGroup>

## Related docs

* [Quickstart](/quickstart)
* [Chat](/features/chat)
* [Configuration](/configuration)