dsh-plugin-herdr

Configuration

Key	Type	Default	Description
socketPath	string	–	herdr socket path (HERDR_SOCKET_PATH); POSIX only
session	string	–	herdr session name (HERDR_SESSION)
timeoutMs	number	30000	per-command timeout
allowBackground	boolean	false	expose run_in_background on pane run
events.enabled	boolean	false	subscribe to Herdr events
events.maxReconnectMs	number	30000	event subscription reconnect cap
reportState	boolean	true	report DSH→Herdr state inside a pane (HERDR_ENV)
projectRoot	string	–	project directory for server-side filtering; defaults to process.cwd()

Preset configuration (presets/herdr/agent.cordis.yml, herdr-session-mode):

Key	Default	Description
paneId	''	Fixed pane binding shared by all sessions; empty = every session creates its own dedicated workspace
label	''	Display label override; empty = auto `dsh:
(cwd basename, falls back todsh:`)
cwd	–	Workspace working directory; empty = the session's project directory

Output limits (CA-014):

• Per-command output is capped at 1 MiB per stream; pane_read/pane_run report truncated: true when the cap is hit (the server-reported truncated flag is surfaced as-is).

Platform support: the plugin is POSIX-only — all control-plane interaction goes over the herdr Unix-domain socket (JSONL), and the panel's start button spawns herdr server from PATH as the single bootstrap exception. Windows (named pipe) is not supported: the plugin refuses to load without a resolvable socket path. Use POSIX (macOS/Linux).

Example patch (cordis.patch.yml):

- id: dsh-plugin-herdr-client
  name: dsh-plugin-herdr/client-entry
  config:
    timeoutMs: 15000
- id: dsh-plugin-herdr
  name: dsh-plugin-herdr
  config:
    timeoutMs: 15000