snapshot: preserve central wiki state 2026-08-15 (7 modified + 1 new file)

2026-08-15 22:11:30 +08:00
commit 92e8028bb8
71 changed files with 9897 additions and 0 deletions
@@ -0,0 +1,51 @@
+---
+title: hermes-ui (Browser Hermes Desktop)
+type: system
+status: live
+created: 2026-07-30
+updated: 2026-07-30
+verified_on: 2026-07-30
+confidence: high
+tags: [hermes, webui, desktop, browser]
+---
+
+# hermes-ui
+
+The official Hermes Desktop renderer, extracted from the `hermes-agent` monorepo (`apps/desktop`) and repackaged as a plain Vite web app — runs in a browser instead of Electron.
+
+- **Repo:** https://github.com/przbadu/hermes-ui
+- **Upstream:** NousResearch/hermes-agent monorepo, commit `56a8e81d33a524f0ba0d68b6d54c8786ed283fb8` (2026-07-08)
+- **Extraction date:** 2026-07-11
+- **License:** MIT (Copyright (c) 2025 Nous Research)
+
+## Deployments
+
+| Host | Location | Port | Status | Started |
+|------|----------|------|--------|---------|
+| CT460 (this box) | `/home/hermes/hermes-ui/` | 5174 | Vite dev server | Active |
+| CT450 (hermesagent) | `/home/hermes/hermes-ui/` | 5174 | Vite dev server | Active (since 2026-07-30) |
+
+## How It Works
+
+- Runs as a Vite dev server, proxying REST/auth/WebSocket to a running Hermes gateway (`http://127.0.0.1:9119` by default).
+- Same-origin proxy via Vite so cookies and the WebSocket work without CORS issues.
+- Electron-only methods are stubbed behind a capability flag in `src/web-bridge/`.
+
+## Quick Start
+
+```bash
+# Install deps (uses bun)
+cd ~/hermes-ui/app && bun install
+
+# Start dev server
+cd ~/hermes-ui && bin/dev
+
+# Or skip bin/dev and run vite directly:
+bunx vite --port 5174 --host 0.0.0.0
+```
+
+## Files
+
+- `PLAN.md` — extraction plan
+- `UPSTREAM.md` — upstream commit diff guide
+- `scripts/serve-on-gateway.sh` — serve built UI same-origin via `hermes serve`