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

# Home

> Install, configure, and use Herm, the terminal UI for Hermes Agent.

<div data-product-guide-index className="flex w-full flex-col gap-8 max-w-5xl mx-auto px-4 md:px-8 lg:px-12 py-10 lg:gap-14 lg:py-16">
  <div className="flex max-w-[540px] flex-col gap-2 self-center text-center">
    <h1 className="text-[30px] font-medium leading-9 tracking-tight text-gray-900 dark:text-gray-50">
      Herm Documentation
    </h1>

    <p className="text-balance text-base leading-relaxed tracking-tight text-gray-600 dark:text-gray-400">
      Install, configure, and use Herm, the keyboard-driven terminal UI for Hermes Agent.
    </p>
  </div>

  <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
    <Card title={<span className="product-guide-feature-card-title">Get Started</span>} icon="rocket" href="/introduction" className="product-guide-feature-card" size={64}>
      <span className="product-guide-feature-card-description">Install Herm and start chatting with Hermes Agent in your terminal.</span>
    </Card>

    <a href="/features/chat" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
      <Icon icon="message-square" color="rgb(var(--primary))" size={18} className="shrink-0" />

      <div className="flex flex-col gap-1">
        <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Chat</span>

        <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
          Stream AI responses with markdown, diffs, inline images, and tool calls.
        </span>
      </div>
    </a>

    <a href="/eikon/overview" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
      <Icon icon="image" color="rgb(var(--primary))" size={18} className="shrink-0" />

      <div className="flex flex-col gap-1">
        <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Eikon Avatars</span>

        <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
          Customize your agent avatar with the built-in studio and marketplace.
        </span>
      </div>
    </a>
  </div>

  <hr className="border-0 border-t border-border" />

  <div className="flex flex-col gap-4">
    <h2 className="font-serif text-xl font-medium leading-normal text-gray-900 dark:text-gray-50">Common tasks</h2>

    <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
      <a href="/quickstart" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
        <Icon icon="zap" color="rgb(var(--primary))" size={18} className="shrink-0" />

        <div className="flex flex-col gap-1">
          <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Install and run Herm</span>

          <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
            Install globally with Bun or npm and launch your first session.
          </span>
        </div>
      </a>

      <a href="/customization/themes" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
        <Icon icon="palette" color="rgb(var(--primary))" size={18} className="shrink-0" />

        <div className="flex flex-col gap-1">
          <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Switch themes</span>

          <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
            Browse the source-defined theme catalog or pick one live with /theme.
          </span>
        </div>
      </a>

      <a href="/customization/keybindings" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
        <Icon icon="keyboard" color="rgb(var(--primary))" size={18} className="shrink-0" />

        <div className="flex flex-col gap-1">
          <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Rebind keys</span>

          <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
            Remap any action to your preferred key combination with /keys.
          </span>
        </div>
      </a>

      <a href="/features/automation" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
        <Icon icon="kanban-square" color="rgb(var(--primary))" size={18} className="shrink-0" />

        <div className="flex flex-col gap-1">
          <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Run kanban work</span>

          <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
            Dispatch agentic tasks from a kanban board without leaving the terminal.
          </span>
        </div>
      </a>

      <a href="/plugins/overview" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
        <Icon icon="plug" color="rgb(var(--primary))" size={18} className="shrink-0" />

        <div className="flex flex-col gap-1">
          <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">Write a plugin</span>

          <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
            Extend Herm with new tabs, commands, and UI slots using the plugin API.
          </span>
        </div>
      </a>

      <a href="/troubleshooting/faq" className="rounded-2xl flex flex-col gap-4 border bg-gray-50 p-4 outline-none shadow-sm shadow-gray-950/5 transition hover:border-primary hover:shadow-md dark:bg-gray-950 dark:shadow-black/20 dark:hover:border-primary">
        <Icon icon="circle-help" color="rgb(var(--primary))" size={18} className="shrink-0" />

        <div className="flex flex-col gap-1">
          <span className="font-serif text-base font-medium text-gray-900 dark:text-gray-50">FAQ & troubleshooting</span>

          <span className="text-sm leading-relaxed text-gray-600 dark:text-gray-400">
            Resolve common issues with themes, tmux, sessions, and the gateway.
          </span>
        </div>
      </a>
    </div>
  </div>
</div>