Hermes Ui

Hermes UI

English · [简体中文](README.zh-CN.md)

The command center for Hermes Agent — chat, steer, browse files, manage skills, and monitor everything from a single glassmorphic HTML app.

Built as a single-file HTML application with React 18, Hermes UI provides a full-featured chat interface, real-time log streaming, file browsing, memory inspection, and more — all through a lightweight Python proxy server.

Chat

Tasks / Live Work

Dashboard

Skills Browser

Cron Jobs

MCP Tools

File Browser

Terminal

---

What's new in v3.3.25

Large chat recovery and browser memory

• Sidebar history stays compact — the browser stores chat metadata instead of full transcripts, avoiding localStorage and tab-memory blowups on large histories
• Chats hydrate on demand — opening a chat loads its full transcript from the local server so refreshes do not pull every conversation into the browser at once
• Refresh races are guarded — compact or partial browser saves can no longer overwrite full server-side chat mirrors during startup
• Update button handles release checkouts — Update & Full Restart can now advance Hermes UI itself when the local install is checked out at an older release tag
• Stress coverage added — browser tests now cover refreshing with large chat lists and switching into an inactive compact chat

What's new in v3.3.24

Workspace and updater polish

• Spaces is no longer a dead end — non-chat screens now show a clear Chat return button in the header
• Versions stay visible outside chat — Spaces and other tool screens show compact Hermes Agent and Hermes UI version chips
• Agent updates handle release checkouts — Update & Full Restart can advance a detached Hermes Agent release tag and refresh the editable install metadata
• Update failures are visible — failed repo updates now stop before restart and show the underlying pull/install output in Settings

What's new in v3.3.23

Agent workspace clarity

• Top-bar workspace renamed — the folder chip now clearly reads as the active Agent Workspace instead of looking like the WebUI runtime directory
• Useful path display — the chip shows a shortened workspace path alongside the saved Space selector
• Manage shortcut — the chip includes a direct manage action into Spaces so users can add or change workspace folders intentionally

What's new in v3.3.22

Release reliability

• Truthful update checks — /api/version compares published Releases with repository tags, so a delayed Release cannot leave the UI reporting an older version
• One version source in the UI — desktop and composer footers now display the backend version instead of stale hardcoded text
• Automated releases — pushing a v* tag publishes generated GitHub release notes
• CI safety net — Python checks, release consistency, sensitive-data scanning, and a real Chromium startup smoke test run on pushes and pull requests

What's new in v3.3.18

Crash recovery context repair

• Latest user turns stay visible — recovery context now preserves the newest user instructions even when tool/status chatter floods the transcript tail
• Older workflows stay cancelled — the model prefix now tells Hermes that recent user corrections override stale transcript and memory when they conflict

What's new in v3.3.16

Sidebar ordering hotfix

• No stale conversation cache — startup now bypasses browser cache when loading the sidebar conversation list
• Always sorted state — conversation updates are normalized through the activity sorter so recently active chats stay at the top after refreshes and state rewrites
• API cache headers — JSON responses now send no-store headers so browser resets do not reuse old sidebar data

What's new in v3.3.15

Cancellation + sidebar ordering

• Cancel cleanup — cancelled work no longer leaves persistent composer status pills or repeated cancel messages in chat history
• Context safety — cancellation markers are filtered out of model context so future turns do not treat them as assistant replies
• Recent chat ordering — the sidebar now merges browser and server conversation caches before sorting, so the most recently active chats stay on top after refreshes

What's new in v3.3.14

Sidebar stability

• Conversation dedupe — duplicate sidebar rows now collapse by session id on load, save, and live state updates
• Refresh cleanup — persisted duplicate rows are repaired by the server instead of reappearing after reload

What's new in v3.3.13

Discussion feedback fixes

• Firefox performance mode — disables decorative animations, background overlays, and backdrop filters in Firefox to avoid pinning a CPU core
• Model picker cleanup — deduplicates model choices, corrects accidental gtp-* entries, and makes custom model selection apply reliably
• Reasoning + slash menu polish — preserves spaces in streamed reasoning text, includes plugin skills in slash commands, and improves Dawn theme contrast

What's new in v3.3.11

Hermes UI 3.3.11 fixes stale compact context that could make an active chat look reset.

Session continuity

• Stale context repair — if context_messages has fewer user turns than the saved transcript and no real compression marker exists, Hermes rebuilds from the full transcript
• No false reset — chats with dozens of visible prompts no longer start the next turn from a two-prompt backend tail
• Health counts fixed — session health now reports context from the repaired source instead of stale compact state

What's new in v3.3.10

Hermes UI 3.3.10 aligns normal chat context handling with the reference UI.

Context continuity

• No invisible tail-trim — normal turns no longer narrow model history to a small local window before Hermes Agent sees it
• Agent-owned compression — real context compression is left to Hermes Agent, which emits the visible compression event
• Repair keeps substance — browser/server transcript repair rebuilds provider-safe history without dropping older visible turns

What's new in v3.3.9

Hermes UI 3.3.9 adds video uploads for local/video-capable model workflows such as Kimi.

Video uploads

• Composer video attach — the file attachment button and drag/drop now accept common video formats
• Workspace upload path — videos are saved into the active workspace's uploads/ folder and attached to the prompt by local path
• Binary-safe prompts — video bytes are not inlined into chat history; Hermes receives the saved file path, MIME type, and size

What's new in v3.3.8

Hermes UI 3.3.8 fixes silent context narrowing in short chats with large tool receipts.

Reference-aligned context selection

• Full transcript first — chats under 40 user prompts rebuild model context from the full backend transcript instead of stale context_messages
• No silent compaction — bulky tool/output blobs are truncated for provider safety, but user/project turns stay in context unless real compaction happens
• Detour recovery — after side quests like skill edits, Hermes keeps the original project prompts in model context

What's new in v3.3.7

Hermes UI 3.3.7 makes recovered UI tool receipts visible to model context without pretending they are provider-native tool calls.

Recovered tool receipt context

• Provenance-labeled receipts — recovered UI toolCalls are shown as UI-observed tool events, not forged provider-native tool_calls
• Bad correction pruning — model context drops broken self-corrections like "I didn't run any tools" when earlier UI-observed tool receipts exist
• Verification guard — if UI receipts lack captured results, Hermes must verify the artifact/status with tools before claiming final state

What's new in v3.3.6

Hermes UI 3.3.6 fixes the browser/server repair path that could drop recent UI tool receipts after a transcript drift repair.

Tool receipt recovery

• UI tool receipts restored — /api/session/health can now recover browser-persisted toolCalls from ~/.hermes/ui-conversations.json when the server session is missing them
• Equal-count repair — repair now runs when the browser has tool evidence missing from the server, even if both sides have the same number of user prompts
• Reference-aligned authority split — browser text can repair missing visible transcript text, but it no longer replaces richer backend tool history

What's new in v3.3.5

Hermes UI 3.3.5 fixes a follow-up memory bug where Hermes could see a prior "work completed" transcript but reject it because tool evidence was missing from the repaired context.

Transcript/tool evidence repair

• No instant self-contradiction — if prior transcript says work finished but tool metadata is missing, Hermes now treats it as unverified prior state and verifies with tools instead of forgetting the topic or denying the previous turn
• Tool-safe browser repair — browser-ahead transcript repair now preserves existing server-side tool_calls and tool messages instead of replacing them with a simplified browser transcript
• API history preservation — the frontend now sends API-safe tool messages and tool-call fields back to the server so future repairs keep real work evidence intact

What's new in v3.3.4

Hermes UI 3.3.4 is a session-memory hotfix. It tightens the browser/server transcript repair so the compacted model context also receives the latest visible turns before Hermes answers.

Session context repair

• Latest-turn memory repair — browser-ahead transcript repair now refreshes the model-facing context tail too, preventing stale compact context from making Hermes forget the previous prompt/work
• Reference-aligned merge guards — workspace-prefixed agent echoes and checkpointed current-user turns are deduped when compacted context is merged back into the visible transcript
• Server health endpoint — /api/session/health reports server, browser, and compacted-context message counts for easier debugging
• Cleaner Tasks board — Done receipts now age out after 2 hours, Needs You/blocked receipts after 12 hours, and the Tasks copy clarifies that it is current/recent work
• Privacy check — release diff was checked for obvious token/API-key/personal-path leaks before shipping

What's new in v3.3.3

Hermes UI 3.3.3 is a session safety and Tasks cleanup patch. It adds a quiet browser/server transcript health check before each chat turn and trims stale task receipts so the board stays focused on current work.

Session safety + task cleanup

• Transcript safety check — before each send, the browser-visible transcript is compared with the server session and safely repaired if the browser has newer visible chat history
• Server health endpoint — /api/session/health reports server, browser, and compacted-context message counts for easier debugging
• Cleaner Tasks board — Done receipts now age out after 2 hours, Needs You/blocked receipts after 12 hours, and the Tasks copy clarifies that it is current/recent work

What's new in v3.3.2

Hermes UI 3.3.2 is a live-work reliability patch. It makes background/process work harder to miss, flags local-work claims when no tool ran, and keeps task status visible near the composer instead of letting it scroll away.

Live work visibility

• Composer work banner — active Hermes work and task follow-ups now stay visible directly above the message box with a quick Open Tasks action
• Tool honesty guard — local file/process claims with no tool call are flagged in chat so users do not mistake narrated work for completed work
• Tasks screenshot — README now shows the Tasks board and live work tracking flow

What's new in v3.3.1

Hermes UI 3.3.1 is a session-memory hotfix. It aligns the chat stream lifecycle more closely with the reference UI so context compression and session rotation do not leave the visible UI chat attached to a stale shorter backend session.

Session durability hotfix

• Compression session aliases — when Hermes rotates a session after context compression, the UI proxy now remembers the old ID points to the new canonical ID, even across proxy restarts
• Frontend session handoff — the stream handshake now carries the canonical session ID through compression, cancel/error, approval, and done events
• History drift repair — if the visible UI transcript is clearly longer than the server session file, the server repairs from the frontend transcript instead of answering from missing context

What's new in v3.3

Hermes UI 3.3 is a polish and durability release. It makes the app easier to read at a glance, steadier on long-running work, and better at showing you what Hermes is doing without turning the interface into clutter.

Health + operational visibility

• Health screen — consolidated Hermes heartbeat, agent/model/provider status, Scrapling/web extraction status, and redacted recent log snippets
• Recent log safety — logs shown in the UI are allowlisted and redacted so tokens and API keys do not leak into the app surface
• Version/update awareness — Hermes UI and Hermes Agent update status stay visible in-app without taking over the main workspace
• Background work monitor — active tools and "check back later" background work surface in Tasks and show a compact chat notice so users know where to continue
• Tool honesty guard — local file/process claims with no tool call are flagged in chat so users do not mistake narrated work for completed work

Chat performance + usability

• Long-chat smoothing — very large conversations render the newest messages first with a load-older control to reduce browser memory pressure
• Improved conversation ordering — recent chats stay easier to scan and recover during active work
• Pinned chat cleanup — pinned sessions keep a clear single-star indicator instead of duplicate pin markers

UI cleanup + branding

• Focused sidebar — the left rail defaults to core work areas first, with secondary tools tucked behind a clearer expander
• Cleaner composer/footer — bottom controls are condensed so the message box gets more space
• Space/profile cleanup — duplicate workspace controls were removed and the active space now lives in a more sensible spot
• Hermes Agent branding — refreshed wordmark/avatar treatment gives the app a more intentional identity

What's new in v3.2

Hermes UI 3.2 turns the project into a stronger multi-work command center, pairing the v3.1 workspace foundation with live task tracking, GitHub workflow polish, and Hermes Agent 0.12 validation.

Tasks / Kanban board

• Tasks screen — live Kanban-style board with Backlog, Active, Blocked, and Done columns
• Automatic task detection — board cards are derived from Hermes todos, delegated subagent work, and active chat state
• Source chat jump-back — click any task card to return to the chat where that work came from
• Board filtering — quickly narrow visible work by task text, source chat, kind, or status
• /tasks slash command — open the Tasks board from the composer
• Hermes Agent 0.12 validation — tested against official Hermes Agent v0.12.0 while keeping the board independent of unreleased upstream Kanban APIs

GitHub / release workflow

• GitHub issue shortcuts — status-bar feedback links open bug reports and feature requests directly
• Issue templates — GitHub now has dedicated bug report and feature request templates
• Version/update health — Hermes UI and Hermes Agent update status are surfaced in-app

Operations + performance follow-up

• Health screen — consolidated Hermes heartbeat, agent/model/provider status, Scrapling/web extraction status, and redacted recent log snip

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: pyrate-llama
• Source: pyrate-llama/hermes-ui
• License: MIT

Install and usage instructions live in the source repository linked above.