Skip to main content
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.
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. 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.

Quickstart

Install Herm and send your first message.

Chat

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

Eikon avatars

Browse, create, install, and activate terminal avatars.

Configuration

Environment variables, preferences, and custom paths.

​
Related docs