Herdr

Dotfiles-managed Herdr session config and plugins.

Herdr is the shared agent terminal multiplexer. Product behaviour, concepts, and configuration options live in the official docs. This page covers only what these dotfiles customise. Clients attach from Ghostty.

Layout

Piece	Why
`herdr/` package	Stow source for managed session and plugin config
Runtime `~/.config/herdr/`	Herdr-owned logs, sockets, and session state stay untracked beside stowed files
`config.toml`	Reproducible session layer (prefix commands, theme, sidebar, plugin chords). Edit the file; do not mirror every setting here
`plugins/config/`	Selected third-party plugin config stowed with the package
`scripts/.local/share/herdr-plugins/`	Local `dotfiles.*` plugin sources linked on `dot update`

Local plugins

dot update links each directory under scripts/.local/share/herdr-plugins/ into the live Herdr plugin tree (herdr plugin link … --enabled) and starts the terminal-title watcher:

Plugin	Role
`dotfiles.repository-picker`	Open or focus configured repository workspaces
`dotfiles.terminal-title`	Mirror pane titles into Herdr tab labels
`dotfiles.yazi`	Yazi explorer in a split or tab
`dotfiles.mise-task-runner`	Pick and run the current project’s mise tasks
`dotfiles.plannotator`	Review or annotate via Plannotator

Lazy plugins

plugins/config/herdr-lazy/plugins.list and plugins.lock pin third-party plugins. When a Herdr session is available, dot update restores them through herdr-lazy. Stowed companion config covers lazygit, sessionizer, usagebar, and reviewr. Everything else under ~/.config/herdr/ remains runtime-owned.

Dot helpers

Command	Purpose
`dot update`	Restore Lazy lockfile, relink local plugins, restart the title watcher
`dot doctor`	Warn when Herdr, the OpenCode integration, or required local plugins are missing
`dot herdr-repo-open`	Open or focus a managed repo workspace once the shared server is up