Skip to content

flooryyyy/herm

 
 

Repository files navigation

Herm - Dashboard TUI for Hermes

image

herm /hɜːm/ noun : a sculptured head of Hermes on a square stone pillar, used in ancient Greece as a boundary marker at crossroads.

Herm is a tabbed, mouse-aware TUI built with OpenTUI (React renderer) and Bun. It talks to the same gateway hermes cli uses.

What it does

  • Chat with streaming, markdown, inline images (chafa), LaTeX→unicode, diff chips, tool-call expansion, and an animated ASCII avatar
  • Tabs for sessions, context, agents, analytics, skills, cron, toolsets, config, env, memory, kanban
  • Profile switching — hop between Hermes profiles without leaving the TUI
  • Command palette (Ctrl+K), slash popover, @-refs for file/diff context
  • Fully rebindable keys (/keys, opencode-compatible) and theme picker

Install

Herm needs a working Hermes Agent install and Bun.

bunx herm-tui              # try without installing
bun add -g herm-tui        # stable
npm i -g herm-tui          # also fine
bun add -g herm-tui@next   # bleeding edge (every dev push)
herm                       # fresh session
herm -c                    # resume last session

Or from source:

git clone https://github.com/liftaris/herm.git
cd herm && bun install
bun run src/index.tsx

Herm looks for ~/.hermes. If yours lives elsewhere, set HERMES_HOME. See .env.example for rarely-needed overrides.

Development

bun run dev            # watch mode
bun run typecheck
bun test

Motivation

Before Hermes, OpenCode was my daily driver. I built Herm because I wanted Hermes capabilities with an OpenCode style interface. Herm uses the same TUI framework OpenCode is built with, OpenTUI, and also exposes dashboard style tabs that centralizes everything I need to do in Hermes in my interface of choice--the terminal.

Acknowledgments

License

MIT — see LICENSE.

About

The Hermes TUI built with OpenTUI

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.8%
  • Other 0.2%