Hermes-Workspace v2.3.0 — HermesWorld integration, Agent View, Dashboard polish

A focused follow-up to v2.2.0 with three new features in the workspace shell and a wave of bug fixes that unblock fresh installs.

46 commits since v2.2.0 · 22 PRs merged in the final push · 4 issues closed · queue down 50%.

✨ New features

🌐 HermesWorld integration

The playable agent MMO — hermes-world.ai — now embeds directly inside Workspace via iframe, with the workspace nav preserved around it. Sign in with Google or email, reserve your founder username, and you're in. Real users started signing up the moment the landing went live (13 founder usernames claimed in the first hour).

• /play/ embed with workspace chrome around the playable runtime
• Wave Chat RPG panels — Inventory, Quest, Map, Founders Vault as React components
• Speech bubbles + toasts in the in-world chat
• Photosensitive safety mode — flash/strobe reduction toggle
• Mobile bundle splitting for faster load on phones
• HermesWorld brand asset pack — logo lockups, social previews, in-game art
• MJ-generated NPC + zone art wired into the playground
• Public name reservation flow at /reserve with founder ranking

VITE_HERMESWORLD_ENABLED=false lets you opt out of the link in the sidebar.

👤 Agent View panel

A new side panel in chat that shows the active agent, queue, history, and a usage meter wired to real provider quota.

• Avatar reflects real activity state — idle / thinking / speaking, sourced from the chat-activity store, no fake demo data
• Two-tier avatar picker — Hermes default + 9 Greek god PNGs (Athena, Apollo, Artemis, Iris, Nike, Pan, Chronos, Eros, Hermes), plus an emoji avatar tier
• Real provider quota tracking in the usage meter
• Smooth slide+fade transitions on the desktop panel
• Mobile sheet variant for small screens
• Enterprise chrome — borderless inner sections, no demo fallback when the gateway returns zero agents

📊 Dashboard

Workspace dashboard now mirrors the native Hermes Agent dashboard at :9120, aggregated server-side in a single round trip that proxies six native endpoints with per-section graceful fallbacks.

New cards:

• System Status Strip — gateway pill + active-agents count + warning chip on restart_requested
• Platforms card — connected platforms with per-platform state pills
• Cron Summary — scheduled / paused / running counts + next-run countdown, deep-links to /jobs
• Achievements ribbon — three most recent unlocks with tier badges + modal for the full ribbon
• Analytics Summary — top-3 models by tokens with proportional bars + real cost (replaces the hardcoded $5/M estimate)
• Provider Mix donut + cache efficiency tile
• Velocity + Cost Ledger menu items
• Contextual Operator Tip card

Vanilla installs still render a usable dashboard — every section resolves to null independently if its provider isn't available.

🛠 Patches & fixes (22 PRs merged)

Install / runtime

• #360 — Docker compose finally works on fresh installs. hermes-agent was missing command: [gateway, run] so the container started the interactive CLI and exited under up -d. Fixed in #385.
• #356 — "Hermes updated" modal stops popping on every refresh. storeNotes() was clearing the seen marker on every poll. Fixed in #386 — only clears when the notes ID actually changes.
• kimi-k2.6 256k context window support (#357)
• Legacy claude-workspace / claude-agent remote aliases so old upgrades don't break the update checker (#359)

Tasks / jobs / cron

• Tasks board auto-detects local vs gateway backend (#361). Probes /api/hermes-tasks and /api/claude-tasks in parallel and picks the one with data. Fixes silent empty boards on installs that store tasks in ~/.hermes/tasks.json.
• Jobs API normalization — always returns {jobs:[]} even when the gateway returns a bare array (#358)

Chat / sessions / agent

• Chat session accounting + local title rename fixes (#350) — phantom agents in sidebar, context meter inflation, local session rename display mismatches all addressed.
• Inline MEDIA:<path> rendering (#349, #330) — local file paths from the agent now show as images in chat, served through a path-allowlisted /api/media route.
• Inline artifact cards in chat (#346, #295)
• Workspace session identity preserved during streams (#310)
• Right-click works on update cards (#286)

Conductor / Swarm / orchestration

• Conductor mission sanitization (#335) — strips Cloudflare 5xx HTML error pages and self-referencing workspace URLs out of mission goals before they hit the model. Defense-in-depth against gateway/proxy failures contaminating agent prompts.
• Conductor falls back when Dashboard mission API is unavailable (#317)
• Swarm tmux session survival check (#341) — when the agent process dies inside tmux (bad PATH, missing API key, etc.), Workspace now surfaces the actual exit output instead of a cryptic "can't find pane" error.
• Hardened workspace swarm prompt submission (#307)
• Operations picker merges Hermes models (#342)
• Chat sends scoped to active workspace (#340)

Files / browser / settings

• Server-side file browser mode clarified (#345)
• HTML preview mode in file browser (#296)
• Groq STT controls in workspace settings (#347)

Themes / UI

• SciFi theme (#320) — full dark/light Tailwind v4 token palette
• Switch toggles show ON/OFF labels with emerald accent (#284)

Auth / gateway

• Codex OAuth tokens bridge to portable-mode chat bearer auth (#332)
• Gateway capability fields reported correctly (#318)
• Production server start path fixed (#308)
• Faster recovery from disconnected state (#275)

Misc

• VT-Capital Guardian OMS cockpit plugin-scoped surface (#364)
• Agora HUD polish to match mockup (#376)
• MseeP.ai security badge added to README (#378)
• Asset generation v2 prompts + ChatGPT prompt batch docs (#370, #375)
• HermesWorld lore bible + player guides (#368)

🔄 Issues closed

• #360 Docker compose on fresh install — fixed in #385
• #356 Update modal popping every refresh — fixed in #386
• #319 Workspace + Codex provider compatibility — clarified, gateway is the missing piece
• #294 File browser file system access — already resolved, server-side mode confirmed

📊 Queue movement

• PRs: 24 open → 12 open
• Issues: 10 open → 6 open
• Today's merges: 22 PRs

🚀 Upgrade

cd ~/hermes-workspace
git pull
pnpm install
pnpm dev

Or, fresh install:

curl -fsSL https://hermes-workspace.com/install.sh | bash

🙏 Contributors this release

@Interstellar-code, @WanderWang, @kadeross, @John-tip, @shoveller, @Fungraphic, @valted81, @kung4lex, @aliasfoxkde, @moto-taka, @kaankirsan, @nazeshinjite, @nixbin-engineering, @CipherFrame, @mseep-ai, @SebuH, @kliebinz-ds, @yasuhidekoizumi-afk

Free. MIT. Open source forever.

→ github.com/outsourc-e/hermes-workspace
→ hermes-world.ai
→ hermes-workspace.com