# Herm

> Documentation for Herm — the terminal UI for Hermes Agent.

## Docs

- [Herm Environment Variables and Configuration Reference](https://herm.liftaris.dev/configuration.md): All environment variables Herm reads, what each one does, and how to relocate Herm's preferences and input history to a custom path.
- [Keyboard shortcuts and key rebinding in Herm terminal UI](https://herm.liftaris.dev/customization/keybindings.md): View and remap every Herm action with /keys, understand the leader-key prefix system, and see the full default keybinding table grouped by scope.
- [Slash commands reference: all built-in Herm TUI commands](https://herm.liftaris.dev/customization/slash-commands.md): Type / in the composer to open the slash popover and explore every built-in client and session command with aliases and arguments.
- [Themes and skins: personalize your Herm terminal UI](https://herm.liftaris.dev/customization/themes.md): Browse 40+ built-in themes, open the live picker with /theme or <leader>t, fix tmux color issues, and switch skins that bundle a theme and eikon preset.
- [Browse and manage installed eikons in Herm Gallery](https://herm.liftaris.dev/eikon/gallery.md): How to view installed eikons, activate one for the sidebar, install from a file or URL, open in Studio, and submit to the Marketplace.
- [Find and install community eikons from Herm Marketplace](https://herm.liftaris.dev/eikon/marketplace.md): Search the community Eikon Marketplace, preview entries, and install shared avatars without auto-activating — all from inside Herm.
- [Eikon avatars: customize your Hermes agent persona](https://herm.liftaris.dev/eikon/overview.md): An overview of the Eikon avatar system in Herm — what eikons are, how they appear in chat, and the three tabs: Gallery, Studio, Marketplace.
- [Create and tune avatar eikons in Herm Eikon Studio](https://herm.liftaris.dev/eikon/studio.md): Use Eikon Studio to create and tune avatars — attach image or video source, adjust contrast and spatial controls, and save with Ctrl+S.
- [Herm Automation — kanban, profiles, and cron jobs](https://herm.liftaris.dev/features/automation.md): Switch Hermes profiles, manage kanban boards for agentic tasks, and schedule recurring cron jobs — all from the Profiles & Automation tab in Herm.
- [Herm Chat tab — stream, voice, and slash commands](https://herm.liftaris.dev/features/chat.md): Stream markdown responses, attach files with @ references, view inline images and diff chips, use voice mode, and run slash commands from the Chat tab.
- [Herm Config tab — settings, skills, and toolsets](https://herm.liftaris.dev/features/config.md): Manage Hermes Agent's settings, skills, toolsets, environment variables, and persistent memory entries — all from the Config tab in Herm.
- [Herm Sessions — browse, resume, and inspect history](https://herm.liftaris.dev/features/sessions.md): Browse, resume, rename, and branch sessions in Herm. Inspect active context segments, review token analytics, and restore earlier states with rollback.
- [Herm: Keyboard-Driven Terminal UI for Hermes Agent](https://herm.liftaris.dev/introduction.md): Herm is a keyboard-driven TUI for Hermes Agent. Manage chat, sessions, profiles, config, and avatars without leaving your terminal.
- [Herm plugin API reference: HermPlugin and HermPluginApi](https://herm.liftaris.dev/plugins/api-reference.md): Complete reference for the HermPlugin interface and the api object — all extension points, lifecycle methods, and UI utilities available to plugins.
- [Herm plugin examples: slots, tabs, events, and rasterizers](https://herm.liftaris.dev/plugins/examples.md): Copy-pasteable Herm plugin examples: status bar slots, custom tabs, gateway event listeners, persistent KV settings, and Eikon rasterizers.
- [Herm plugin system overview: extend the terminal UI](https://herm.liftaris.dev/plugins/overview.md): Overview of the Herm plugin system — what plugins can do, current limitations (bundled-only), and how to get started building your first plugin.
- [Install Herm and Send Your First Message in Minutes](https://herm.liftaris.dev/quickstart.md): Install the Herm TUI, connect it to Hermes Agent, and send your first message — from zero to an active chat session in under five minutes.
- [Common Herm TUI problems: diagnosis and step-by-step fixes](https://herm.liftaris.dev/troubleshooting/common-issues.md): Diagnose and fix common Herm problems: tmux color rendering, display corruption, inline images, gateway startup failures, and stale session state.
- [Frequently asked questions about the Herm terminal UI](https://herm.liftaris.dev/troubleshooting/faq.md): Answers to common questions about Herm: compatibility with Hermes Agent, session storage, themes, gateway setup, and what Herm does and doesn't do.

## Optional

- [GitHub](https://github.com/liftaris/herm)