session persistence, safer updates, and workspace navigation
This one adds new persistence paths for updates, server restarts, and larger sessions.
Persistence for the hard parts
Session persistence is not one feature. A detached client, a stopped server, a terminal history replay, an agent conversation restore, and an update handoff all protect different parts of the workspace.
Herdr 0.6.3 pushes on three of those boundaries.
Agent restore after server restart
When a Herdr server stops, normal pane processes stop with it. Native agent restore is the path for getting supported agent conversations back after that kind of restart.
With [session] resume_agents_on_restore = true, Herdr can use official session references from supported integrations to relaunch Pi, Claude Code, Codex, OpenCode, and Hermes panes into their previous conversations.
Read the session restore docs.
Pane screen history
Pane screen history solves the visual half of restart recovery. When enabled, Herdr saves recent pane output and replays it into restored panes so the workspace does not come back as a set of empty terminals.
It is useful for shells, logs, dev servers, and agent panes where recent output explains what was happening before the server stopped.
Read how pane history differs from live persistence.
Live handoff for updates
Live handoff is the update path for supported running sessions. Instead of stopping the old server and killing pane processes, Herdr can ask the old server to transfer live PTY ownership to the updated server.
It is currently experimental and opt-in with herdr update --handoff and herdr --remote <host> --handoff. That keeps the default path conservative while the feature gets more real-world coverage.
For the technical background, read the deep dive: Live updates without killing your terminal processes.
Session navigator
Large Herdr sessions need fast movement. The new session navigator opens with prefix+g and gives you a searchable workspace, tab, and pane tree.
At a glance, you can see the full tree of workspaces, tabs, and panes. Press / to fuzzy find by text. Press b, w, i, or d to filter by blocked, working, idle, or done panes. Press a or Backspace to clear the state filter.
Use it to jump straight to the pane that needs attention without manually scanning the sidebar.
More terminal workflow polish
Direct agent terminal attaches now have scrollback, so PageUp, PageDown, and mouse wheel scrolling work in the attach viewport when the running terminal app has not requested that input for itself.
Herdr also gained better update and remote-bootstrap behavior for package-manager installs, more reliable event delivery under load, and fixes across agent detection, terminal colors, sound alerts, and integration lifecycle handling.
Pane metadata reporting
The new pane.report_metadata socket method and herdr pane report-metadata CLI command let integrations and local hooks customize what Herdr shows for a pane.
After installing an integration, the integration can report a title, visible agent name, compact status label, state label, and native session metadata without taking over unrelated lifecycle behavior.
You can also use it from your own scripts. For example, a hook can mark a pane as running a deploy, rename a long-lived task, or ask an agent to report a more specific state for the work it is doing.
herdr pane report-metadata \ --title "api deploy" \ --agent-name "codex" \ --state-label "reviewing logs" \ --compact-status "deploy"This gives integrations a supported way to make panes more readable while keeping Herdr’s session and agent ownership rules intact.
Full notes
This page highlights the product changes. The complete release notes remain on GitHub.