Files
Brooklyn Nicholson 648da6a8d1 feat(gui): make desktop setup flow real and testable
Add a GUI-first setup gate and runtime state API so desktop onboarding is safe, iterative, and works with isolated fresh-mode installs. Scaffold and wire the desktop shell/runtime pieces so this branch runs end-to-end without disturbing existing user installs.
2026-04-25 19:48:02 -05:00
..

Hermes Apps

Platform apps live here. The first app is a cross-platform GUI shell around the existing Hermes dashboard; it should not fork chat, config, logs, or session UI.

Shape

apps/
  gui/      # cross-platform app shell: dev Chrome shell now, Tauri native next
  shared/   # runtime bundle notes/scripts used by Windows + macOS packaging

Desktop Dev

The backend-only GUI mode is:

hermes dashboard --gui

The fast GUI shell is:

cd \\wsl$\Ubuntu\home\bb\hermes-agent\apps\gui
npm run dev

The native Tauri shell is:

cd \\wsl$\Ubuntu\home\bb\hermes-agent\apps\gui
npm run dev:tauri

--gui implies the embedded TUI; do not pass --tui separately for GUI mode.

MVP Boundary

Included:

  • bundled Python runtime
  • bundled Node/TUI runtime
  • CLI install to PATH
  • profile picker and first-run setup
  • dashboard health/reconnect state
  • tray controls
  • desktop notifications
  • Windows installer

Deferred:

  • code signing
  • native self-updater
  • store distribution

For MVP updates, the desktop UI should run the existing hermes update flow and surface progress/finish notifications.