Skip to content

herminal v0.4.1 — session restore

Choose a tag to compare

@hoangperry hoangperry released this 02 Jun 20:09
· 91 commits to main since this release

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.json on 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.dmg

Signed + notarized + stapled. 79/79 tests pass.