Fixed

• Update checks and in-app What's New release notes no longer depend on GitHub’s release API, which avoids the transient 403 failures from the previous update path.
• herdr pane run ... now submits the full command atomically in one request, fixing cases where scripted commands did not reliably execute because the final Enter was sent separately.
• Bare line-feed input is now preserved in raw terminal input instead of being normalized to Enter, fixing Linux terminal cases where inputs like Shift+Enter or Ctrl+J could be interpreted incorrectly.

Added

• The expanded sidebar agent panel can now switch between the current workspace and all workspaces, so you can scan and jump to agents across the whole session.
• The collapsed sidebar now shows compact per-pane agent indicators, so you can keep an eye on agent activity without reopening the full sidebar.

Changed

• The sidebar now handles larger workspace sets more cleanly: the workspace section has headers, its own scrolling, better-aligned drag/drop slots, and manual width changes persist across restarts. Double-clicking the divider resets it to the configured default width.
• Pane scrollback is now configured with advanced.scrollback_limit_bytes, matching Ghostty's byte-based scrollback limit. Set it to 0 to disable pane scrollback entirely. The old advanced.scrollback_lines key is still accepted as an alias, but it now uses the same byte-based value.
• Linux release binaries now ship with libghostty SIMD enabled again without reintroducing the musl startup issue, restoring the optimized Linux build path.

Fixed

• Typing in pane terminals on macOS is responsive again after the Ghostty migration, by keeping a persistent per-pane Ghostty key encoder instead of rebuilding it on every keypress.
• The collapsed sidebar expand toggle works again.
• Creating a new tab now waits until you confirm the dialog, so cancelling the new-tab flow no longer leaves behind an unwanted tab.
• Copying selected pane text now uses Ghostty's native selection extraction, which preserves wrapped text and wide characters more accurately.
• Session restore is more tolerant of older and current snapshot formats, including pre-tab session files.

Fixed

• Fixed Linux release binaries crashing on startup.

Major Changes

• Herdr now uses a Ghostty-backed terminal engine as its pane runtime.
• The legacy vt100 pane backend has been removed, making Ghostty the single terminal backend going forward.

UX and Interaction

• Workspaces can now be reordered by dragging them in the sidebar.
• Notification sounds now support custom mp3 file overrides, with either one shared file or separate files for finished vs needs-attention alerts.

API and Integration

• Workspace API ids are now stable, making socket and CLI automation more predictable across workspace changes and restores.

Packaging and Runtime

• macOS builds now statically link the vendored libghostty-vt, preserving the single-binary install and update flow.

note: linux version is broken on 0.4.0. it's excluded from the release please download 0.4.1.

Changed

• The global launcher now surfaces update-related actions more clearly: when release notes are available you can open What's New, and when an update has been downloaded you can quit to apply update directly from the menu.
• Release notes are now retained as the latest available notes after you dismiss the startup modal, so you can reopen them later from the UI instead of only seeing them once.

Fixed

• Fixed held-key repeat in terminal panes on macOS terminals that send explicit repeat events through the enhanced keyboard protocol, restoring continuous backspace, character, and arrow-key repeat without letting modal close/confirm key repeats leak into the shell.

Added

• New tabs now open directly into the rename flow, with the default tab name prefilled and replaced on first type so you can name tabs as you create them.

Changed

• Polished modal layout and spacing across onboarding, settings, keybind help, and release notes so overlays feel more consistent and their content/actions line up more cleanly.
• Debug builds now use separate runtime/config paths from normal releases, which avoids local development sessions colliding with your main herdr install.

Fixed

• Starting a second herdr instance against an active socket now fails fast with a clear error instead of clobbering the running session.
• Fixed pane and agent state updates being dropped under internal event queue pressure, which could leave a pane showing stale status after work finished.
• Fixed onboarding modal sizing and click targets, and corrected release-notes scroll calculations when a scrollbar is present.

Major Changes

• Added tabs within workspaces, so a single workspace can now hold multiple terminal tab contexts with their own pane layouts.
• Added first-class tab support to the local socket API and CLI wrappers, including herdr tab ... commands and tab ids like 1:2 alongside workspace-scoped pane ids.
• Added built-in direct integrations for pi, claude code, codex, and opencode, plus authoritative hook-driven state reporting so supported agents can report semantic state directly instead of relying only on screen heuristics.
• Added a post-update release-notes screen so herdr can explain what changed after an update is installed.

UX and Controls

• Added optional direct pane-focus keybindings for terminal mode, so you can switch panes with modifier shortcuts like alt+h or alt+right without entering navigate mode first.
• Reworked keybind discoverability so the in-app keybind help now shows all supported actions, including optional bindings that are currently unset.
• Keybind help now uses a centered scrollable modal with mouse and keyboard scrolling, matching the release-notes interaction model more closely.
• Popups and action-button interactions now use more consistent modal geometry and button semantics across the UI.
• Polished the sidebar agent section so it focuses on detected agents only and uses clearer two-line agent cards with more breathing room.

Behavior Fixes

• Hook-driven agent state updates now stay correct in tabbed workspaces.
• Modifier-only keypresses no longer leak into panes as stray input.
• Multi-tab agent labels now include tab names when that extra context matters.
• Workspace identity now follows the first tab's root pane again instead of stale creation-time cwd.
• Background notification suppression is now tab-aware rather than workspace-wide, so background tabs in the current workspace can still alert correctly.

Documentation

• Updated the README, configuration guide, integrations guide, skill, and socket API docs to reflect tabs, direct integrations, unset optional keybindings, direct terminal-mode navigation examples, workspace-scoped pane ids, and the current workspace identity/sidebar model.

Fixed

• Fixed a macOS-only startup misdetection where pi could briefly appear as codex in the sidebar because process environment entries were being parsed as command-line arguments.

Changed

• Mouse wheel handling now follows the tmux/Ghostty model more closely: fullscreen apps receive wheel input when they own scrolling, while herdr keeps host scrollback for panes that are behaving like a normal terminal transcript.
• Pane scrollbars now only appear when herdr has real host scrollback for that pane, instead of implying a host-managed scroll position for app-owned scrolling.

Fixed

• Fixed Codex and pi panes becoming unscrollable in herdr by preserving recoverable host history for top-anchored normal-screen output, without relying on alternate-screen scrollback retention.
• Fixed pane wheel routing so apps using mouse reporting or alternate-scroll behavior can receive scroll input directly instead of having herdr always intercept it.

Fixed

• Fixed pane scrollbars so they reserve their own lane instead of drawing over terminal content, which makes scrolling and scrollbar dragging behave more cleanly in narrow panes.
• Fixed alternate-screen scrollback handling so full-screen terminal apps can preserve recoverable history inside herdr panes instead of losing rows that scroll off.
• Fixed Codex in herdr panes losing transcript/history while running in alternate screen, so past output remains scrollable instead of disappearing as the session grows.
• Hid the rendered terminal cursor while a pane is scrolled back, avoiding stray cursor blocks appearing in the wrong place during history navigation.