# Changelog ## Unreleased ## [0.2.0] - 2026-03-30 ### Added - Added a local Unix socket API for controlling running herdr sessions, including workspace and pane management, pane reads, text/key input, pane splitting, and output waits. - Added event subscriptions over the socket API for workspace and pane lifecycle events, pane output matches, and agent state changes. - Added CLI wrappers on top of the socket API with `herdr workspace ...`, `herdr pane ...`, and `herdr wait ...`, using compact public ids like `1` and `1-2` for scripting and agent orchestration. - Added a settings popup with mouse support for changing themes, sound alerts, and toast notifications from inside herdr. - Added 9 built-in themes: catppuccin, tokyo night, dracula, nord, gruvbox, one dark, solarized, kanagawa, and rosé pine. - Added interactive pane scrollbars, manual sidebar resizing, and upstream git ahead/behind indicators in the workspace sidebar. ### Changed - Redesigned the sidebar into a two-section layout that separates workspace-level triage from per-agent detail, making it easier to supervise multiple agents in parallel. - Agent state names exposed in the UI and integration surfaces now use `working` and `blocked`. - Herdr now blocks nested launches by default when started inside a herdr-managed pane; set `advanced.allow_nested = true` to opt back in. ### Fixed - Improved terminal keyboard protocol parsing and input forwarding across terminal variants, including better handling for shifted printable keys. - Fixed Ghostty on macOS misparsing some arrow-key and modifier/enhanced key sequences. - Refined sidebar rollups and pane ordering so workspace status and agent lists stay more stable and predictable. ### Documentation - Refreshed the README, socket API reference, and reusable agent skill docs to better explain herdr's agent multiplexer model and integration surface. ## [0.1.2] - 2026-03-28 ### Added - Added first-run onboarding flow that lets you choose notification preferences (sound and toast) on startup. - Added optional visual toast notifications in the top-right corner for background workspace events (completion and attention-needed alerts). - Added configurable keybindings for all navigate mode actions: new workspace, rename workspace, close workspace, resize mode, and toggle sidebar. See `CONFIGURATION.md` for the full key reference. - Added configuration validation with startup diagnostics. Invalid key combinations or duplicate bindings now fall back to safe defaults with a visible warning. ### Changed - **Breaking:** Default prefix key changed from `ctrl+s` to `ctrl+b` to avoid common terminal flow control conflicts. - Workspaces now derive their identity from the repository or folder of their root pane, updating automatically as you navigate. Custom names act as overrides rather than static labels. - Sidebar now shows workspace numbers again in expanded view. - Refined sidebar presentation with consistent marker/name/state ordering and comma-separated agent summaries. - Keybinding parser now accepts special keys (`enter`, `esc`, `tab`, `backspace`, `space`) and function keys (`f1`–`f12`). ### Documentation - Split configuration reference into a dedicated `CONFIGURATION.md` file with full keybinding documentation and config diagnostics explanation. ## [0.1.1] - 2026-03-28 ### Added - Added optional sound notifications for agent state changes, including a completion chime when background work finishes and an alert when an agent needs input. - Added per-agent sound overrides under `[ui.sound.agents]`, so you can mute or enable notifications by agent instead of using one global setting. Droid notifications are muted by default. ### Changed - Request alerts now play even when the agent is in the active workspace, while completion sounds remain limited to background workspaces. ### Fixed - Improved foreground job detection on Linux and macOS so herdr can recognize agents that run through wrapper processes or generic runtimes, including cases like Codex running under `node`. - Made Claude Code state detection more stable by handling more spinner variants and smoothing short busy/idle flicker during screen updates. ## [0.1.0] - 2026-03-27 ### Added - Initial release.