Repository navigation
Immutable
release. Only release title and notes can be modified.
Overview
v33.0.0 makes Herdr and HWT the exclusive terminal workspace and worktree workflow, completes the OpenCode V2 migration, and adds richer navigation and code-review tools.
Notable Changes
- Herdr and Vellum: Browse GitHub PRs with review/check previews and actions for HWT checkout, review, auto-merge, and closing PRs. New visible-file and URL pickers can open or copy references, and paste file paths into the active pane.
- Code review: Herdr’s command palette can review working-tree or branch changes using Hunk, tuicr, or Neovim CodeDiff. CodeDiff is available at
<leader>gD; Git’s default pager changes from Delta tohunk pager. - HWT: OpenCode is the default agent, with Linear ticket creation/search commands and a worktree URL palette. On PDQ repositories, interactive worktree removal can offer to mark the associated ticket Done.
- Coding agents: Shared inline shell commands now work across OpenCode, Claude Code, Codex, and Pi. OpenCode’s Vim editing gains visual-line selection, clipboard operations, and native undo/redo. Pi separates synced MCP servers from machine-local configuration.
- Neovim: SQL buffers gain
<leader>dqto send queries or selections to a nearby Herdrpsqlpane. - Tooling: Git hooks and checks move from Lefthook to hk; Betterleaks replaces Gitleaks and augments agent credential redaction. The macOS sudo-authentication task adds Apple Watch support alongside Touch ID.
Breaking Changes And Migration
- Tmux, workmux, and sesh are removed, including their configs, helper scripts, tasks, and editor integrations. Use Herdr/HWT instead; old Vimux runner mappings are also gone.
- Ghostty shortcuts change:
Cmd+Kopens the Herdr agent navigator;Cmd+Shift+Fopens visible files instead of forking a repository.Cmd+Gopens the PR palette, andCmd+Uopens visible URLs. - OpenCode V2: Use
opencode, not the removedopencode2wrapper. Move machine-local MCP overlays to~/.opencode/opencode.jsonc, remove the oldOPENCODE_CONFIGexport, and restart the service. This overlay applies to projects beneath your home directory. An optionalscripts/import-opencode-sessions.shmigrates older sessions, defaults to a dry run, and backs up databases when applying. - Raycast: Replace the parent script-directory registration with
raycast/scripts/sharedplus the applicablepdqorpersonaldirectory. - Run
task syncto update tools, links, and agent hooks. Start fresh Claude/Pi sessions afterward and trust the Codex hook through/hooks. Inline shell syntax executes without per-command approval, so only submit commands you intend to run.
33.0.0 (2026-11-01)
⚠ BREAKING CHANGES
- ghostty: change super+shift+f to visible files vellum
- ghostty: change cmd-k to herdr agents vellum
- tmux, workmux, and sesh are no longer included.
Features
- add hwt URL palette (80fa7e1)
- add independent Hunk review and Herdr workspace context (5a7f653)
- add REA and separate shared Pi MCP configuration (e45e616)
- add stakeholder translator skill (#480) (b138ca8)
- agent-guard: adopt betterleaks with batched redaction (628d903)
- agents: add going-forward rule persistence skill (d86a1a7)
- brew: add pam-watchid (99d79eb)
- expand inline commands across coding agents (17f33f2)
- ghtkn: add authentication task (3e5abc6)
- herdr: add command palette change reviews (ee36307)
- herdr: add fork repository command (9bfebb9)
- herdr: add GitHub PR palette popup and actions (2b4241f)
- herdr: add pull request review palette command (a232232)
- herdr: add Vellum pane inspection picker (ff6b44f)
- herdr: move pane to existing workspace tab (b497a50)
- herdr: paste path to active pane (aa1378f)
- herdr: pick visible URLs and files from panes (3d9f361)
- herdr: show agent icons in sidebar (f72a756)
- hk: add check for hk config + hide output when done (e6c91c4)
- hk: migrate hooks and checks (5f3c5db)
- hunk: add vim horizontal navigation (6f9331b)
- hunk: bind next and previous review notes (4479386)
- hwt: add ticket config (ca9cdc4)
- hwt: offer to close tickets before worktree removal (e61ca56)
- hwt: set default agent to opencode v2 (0ce9ddc)
- improve Herdr visible file and URL pickers (58108f6)
- ink: replace gum input prompts (7c85233)
- mise: add ink tui (9cd0108)
- mise: enable auto_prune (e79db82)
- nvim: add CodeDiff.nvim (06361a1)
- nvim: add new file action to Snacks picker (da1c7ca)
- nvim: automatically add schema for pitchfork and mise configs (81ea1ac)
- nvim: send SQL selections and DO blocks to Herdr psql (4a2ff92)
- open visible file references at their lines (58985cd)
- opencode: add pitchfork mcp (9b59dc4)
- opencode: add ShellFish notifications (bef3776)
- opencode: add vim clipboard and native undo history (c677224)
- opencode: add visual line mode to vim plugin (4b83808)
- opencode: complete v2 migration (f203ecb)
- opencode: show image previews in chat history (5b7ae14)
- pi: add chat scrolling keybindings (ad5bcdf)
- raycast: add PR Querydesk shortcut (3fcf14c)
- raycast: open PR Argo CD application (ba13904)
- raycast: split script commands by machine profile (327755f)
- skills: add OpenCode session teleportation for Herdr (f533584)
- skills: add show-me by Dex Horthy (cfd1bb3)
- task: add pitchfork:restart task (21c7980)
- tooling: migrate bootstrap template to hk (76245f2)
- tuicr: update config to use more features (f42c375)
- use hwt ticket workflows (00b03f8)
- vellum: add HWT checkout and close PR actions (4dc5900)
- vellum: add themes palette (a1d8c60)
- vellum: show icons in file picker (118049c)
- vellum: start Herdr pane previews at bottom (63c0d67)
- vellum: start herdr-agents palette in filter mode (c48bb2d)
- zsh: add vellum completions (83b7f4b)
Bug Fixes
- agents: respect repository commit conventions (aa75027)
- agents: tell agent to stop being an ass (960cfff)
- allow aarch64 in MACHTYPE detection (f6ba2d2)
- aube: update verified release and approve protobufjs build (9c4c029)
- detect executable files in visible pane listings (0731beb)
- exclude aube lockfiles from betterleaks scanning (2f4dbf7)
- ghostty: change cmd-k to herdr agents vellum (8f97fb7)
- ghostty: change super+shift+f to visible files vellum (d389508)
- git: force hunk pager for all diffs (ca7aeda)
- git: ignore herdr internal dirs (21f4211)
- herdr: enter Neovim command mode when opening files (c2c379c)
- herdr: make agent title more subdued (40e9a31)
- herdr: query hwt merged config for ticket_commands (8685ac5)
- herdr: resolve vellum through mise shims (96fbe71)
- herdr: simplify agent list (2290381)
- herdr: strip scrollbar padding from wrapped file paths (b6f946d)
- herdr: use ink input with --fullscreen in popups (71cbf65)
- herdr: use native workspace window title (966a1dc)
- hk: don't show std err for successful checks (755f335)
- hk: noisy hooks begone (09f5ed6)
- hk: silence gitleak info logs (3bf43cf)
- hunk: change theme to tokyo-night permanently (d94e180)
- hunk: update hunk settings for better compatibility (4b01d48)
- hwt,lnr: update to latest (a52b19e)
- hwt: set cwd for vellum source for hwt-urls (a9be279)
- ignore escaped newlines in visible URLs (537c849)
- mise: change lockfile_mode back to merge (c0addac)
- mise: commit dependency sidecars with lockfile (6e4c5e2)
- mise: handle paginated gcloud release dates (da2cc03)
- mise: ignore locks folder in config (39eea1d)
- mise: include dependency sidecars in commit task (05dab4f)
- mise: install gcloud through HTTP backend (f228988)
- mise: pin lolcrab to supported envs (9c3623e)
- mise: pin Playwright MCP trust exceptions (6df53c3)
- mise: remove outdated opencode package (bed85ff)
- mise: remove unsupported exe options and unused nvr (721d8df)
- mise: switch lock file to generate (3a91be1)
- mise: update deprecated tool definitions (2168773)
- nvim: correct lua ls lint error (f6d16ca)
- nvim: navigate from Snacks explorer to Herdr panes (b0a34d6)
- nvim: pin kulala before license prompt regression (bd2af0c)
- nvim: rebuild mason python packages after upgrades (1cc3a7c)
- nvim: remove mason tools that don't have arm binaries (cca1dbf)
- nvim: run fe tests in houston with correct command (80e5f0a)
- nvim: use locally built Kulala compatibility fork (735547f)
- nvim: use tree view for file list in CodeDiff (a73a3ab)
- opencode: herdr plugin support for opencodev2 (ef6583b)
- opencode: load local TUI plugins (168b3a9)
- opencode: machine local mcp config (890f28a)
- opencode: migrate shellfish notification plugin (94e8bb3)
- opencode: prevent visual word motion from freezing TUI (a80a596)
- opencode: repair stale plugin lockfiles (17b5b8a)
- opencode: stop git status idle refresh loop (4a9e78e)
- opencode: visual mode got stuck sometimes (816f657)
- pitchfork: detect existing boot registration (8a7a09f)
- pitchfork: remove user (96bc3fe)
- pitchfork: use 8443->443 port redirect for TLS (aca4af8)
- popup: include hidden files in picker (ee4bede)
- raycast: update PR QueryDesk database path (a0b90d4)
- release: load version state from manifest (92cddeb)
- resolve fast-uri security advisories (#478) (cc4df4e)
- resolve wrapped and nested visible file references (42c443a)
- route passing sniff-review test output to stdout (51d3555)
- skills: be clear about gh-stack being default (27ac86c)
- skills: improve title format for PDQ PRs (cc598b9)
- sync: commit mise lockfiles after all sync steps (3773f81)
- task: configure Apple Watch sudo authentication (a027cf0)
- taskfile: remove herdr title plugin (297f0fe)
- task: opencode completions shell command syntax (69ee4c8)
- task: update task mise:commit to include new folder (c7bca5b)
- vellum: use available schema for palettes (17c432a)
- vellum: use renamed vlm binary (64c565a)
- zsh: add libpq to path (8d926de)
Documentation
- document Herdr-only workflow (61adcd4)