Skip to content

herminal v0.4.0 — Claude session browser

Choose a tag to compare

@hoangperry hoangperry released this 01 Jun 18:15
· 92 commits to main since this release

The feature the "terminal for devs living in Claude Code" tagline always promised: reopen any past Claude conversation in one click.

⌘⇧C — Claude session browser

A new left sidebar reads Claude Code's own transcript store (~/.claude/projects/) and lists every project you've run claude in — sorted by last-active, with the real working directory and git branch.

  • Resume opens a tab running claude --resume <id> in the project's cwd — reattaches the exact conversation.
  • Open Shell Here drops a plain shell in that directory.

Read-only — herminal never writes into ~/.claude. Reads only the first 16 KB of each transcript, so even a multi-hundred-MB session file costs two syscalls, not a parse. Paths with hyphens (e.g. andromeda-next) resolve correctly — the cwd is parsed from the transcript body, not the lossy directory slug.

Foundation (reused by future session-restore)

  • OSC 7 cwd tracking — every pane now knows its live working directory.
  • working_directory spawn — tabs can open in a specific dir.

What's next (v0.4 milestone)

This is slice 1. Session restore (snapshot every tab/pane on quit, restore on launch) and named workspaces build on this same foundation.

Install

curl -LO https://github.com/hoangperry/herminal/releases/download/v0.4.0/herminal-v0.4.0.dmg
open herminal-v0.4.0.dmg

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