Skip to content

Commit ce79481

Browse files
author
itsdodobitch
committed
Prepare Hermes Desktop v0.9.0
1 parent 4709e3e commit ce79481

33 files changed

Lines changed: 3719 additions & 232 deletions

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,17 @@
22
/AGENTS.md
33
/.build
44
/.build-tests
5+
/.cache
6+
/.deriveddata
7+
/.deriveddata-device
58
/dist
69
/docs/*
710
!/docs/distribution.md
811
!/docs/releases/
912
!/docs/releases/*.md
1013
/private/
1114
/.swiftpm-home
15+
/.swiftpm-cache
1216
/.vscode
1317
/packaging/AppIcon-1024.png
1418
/packaging/AppIcon.iconset/

README.md

Lines changed: 16 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -78,15 +78,6 @@ session store. Kanban comes from the upstream Hermes Kanban home. Cron jobs
7878
come from the remote scheduler state. Files and skills are edited on the host
7979
with conflict checks before save.
8080

81-
Workflow presets are the intentional local convenience layer in that model.
82-
They are small saved prompts with optional skill selections stored on your Mac,
83-
scoped to the active host/profile, and used only to open a fresh remote
84-
Terminal tab. They do not create a second copy of Hermes state on the host.
85-
86-
That makes the app easier to reason about. There is no hidden execution layer
87-
to audit, no shadow state to reconcile, and no ambiguity about which machine
88-
owns the work.
89-
9081
That restraint has a practical advantage: Hermes Desktop can remain useful when
9182
higher-level surfaces are unavailable. If a dashboard, gateway, or agent
9283
configuration breaks, the app still has the direct SSH path: inspect the host,
@@ -121,8 +112,8 @@ Setup is intentionally lightweight. Before you install, make sure you have:
121112
- `python3` available on the Hermes host
122113
- Hermes data under the remote user's `~/.hermes`
123114

124-
For in-app chat and terminal resume workflows, the remote `hermes` CLI also
125-
needs to be available on the host's non-interactive SSH `PATH`.
115+
For Sessions Chat, Terminal resume, and workflow launch, the remote `hermes`
116+
CLI also needs to be available on the host's non-interactive SSH `PATH`.
126117

127118
For the native Kanban workspace, the host needs a Hermes Agent build with
128119
upstream Kanban support. Newer Kanban features appear automatically when the
@@ -279,12 +270,14 @@ It gives the real Hermes workflow a native workbench:
279270
Hermes Desktop does not replace the terminal surfaces Hermes already gives you.
280271
It lets you choose the right one for the job.
281272

282-
- Use in-app chat in `Sessions` for quick turns, context checks, and continuing
283-
a session while you are already in the app.
273+
- Use `Chat` in `Sessions` when you want the real Hermes TUI embedded in the
274+
app, already scoped to the selected SSH host and Hermes profile.
275+
- Use `Transcript` in `Sessions` when you want to inspect persisted history from
276+
the host without starting or resuming a live TUI.
284277
- Use the embedded `Terminal` for heavier work where you want shell control,
285278
command approvals, long-running output, or manual review close at hand.
286-
- Use `hermes --tui` in the terminal when you want Hermes Agent's richer TUI for
287-
longer interactive sessions.
279+
- Use `hermes --tui` in any terminal when you want the same Hermes TUI outside
280+
the desktop layout.
288281

289282
All of these paths still run Hermes on the selected host. The choice is about
290283
surface area, not about creating a second source of truth.
@@ -407,17 +400,17 @@ non-interactive way.
407400
If Terminal still needs password entry, host key confirmation, or other
408401
interactive setup for that target, the app will usually hit the same wall.
409402

410-
### What does in-app chat do?
403+
### What does Sessions Chat do?
411404

412-
It runs Hermes on the selected host over SSH.
405+
It runs the real Hermes TUI on the selected host over SSH.
413406

414-
Starting a new chat uses the remote `hermes chat` path. Continuing a session
415-
uses the remote resume path with the selected Hermes profile preserved when one
416-
is active.
407+
Starting a new chat launches `hermes --tui`. Continuing a session launches
408+
`hermes --tui --resume <session-id>`, with the selected Hermes profile preserved
409+
when one is active.
417410

418-
If Hermes requests command approval during a non-interactive chat turn, Hermes
419-
Desktop cannot collect a manual approval inside that chat surface. When you
420-
need to review or approve commands yourself, resume the session in Terminal.
411+
The important detail is that Chat is a surface over the host's Hermes TUI, not a
412+
separate Desktop conversation backend. Sessions still reads persisted
413+
transcripts back from the host, and the host remains the source of truth.
421414

422415
### Does Hermes Desktop replace a remote file manager or IDE?
423416

0 commit comments

Comments
 (0)