herminal v0.4.1 — session restore
v0.4 milestone slice 2. Quit with a layout, get it back on launch.
Session restore
herminal now remembers your tab + split layout and reopens it next launch — each pane a plain shell in its last working directory. No more rebuilding your workspace every morning.
- Persists to
~/Library/Application Support/herminal/workspace.jsonon quit + on every structural change (add/close/split tab). - Settings → "Restore tabs & panes on launch" (default on). Off → fresh single tab, snapshot cleared.
What it restores (and what it doesn't)
- ✅ Tab count, split axis, pane ratios, focus, each pane's cwd.
- ❌ Commands. ssh / claude / arbitrary commands are NOT re-run — those are side-effectful (network connections, LLM resumes) and surprising to fire on every launch. A former ssh pane comes back as a clean local shell.
- Every restored cwd is validated against the local filesystem; a stale or remote path falls back to home rather than failing.
Pairs with v0.4.0's Claude session browser (⌘⇧C): restore brings back your layout, and the browser one-click-resumes the actual Claude conversations.
Install
curl -LO https://github.com/hoangperry/herminal/releases/download/v0.4.1/herminal-v0.4.1.dmg
open herminal-v0.4.1.dmgSigned + notarized + stapled. 79/79 tests pass.