dsh-plugin-herdr

English | 简体中文

Herdr control-plane plugin for DeepSeek Harness (DSH): observe and drive Herdr — a terminal workspace manager for AI coding agents — directly from DSH sessions.

Features

• Control plane — 19 herdr_* tools over Herdr's Unix-domain socket (snapshot, agents, panes, workspaces, layout, notifications)
• Session-scoped UI — Herdr tab and side panel show only the current session's workspace; hidden outside Herdr mode
• Herdr mode — create a session in Herdr mode to get a dedicated workspace that lives and dies with the session

Install

Prerequisites: a DSH profile (e.g. web) and a running Herdr server. The plugin talks to the local Herdr socket; the panel can start the server from PATH if needed.

# npm (published as dsh-plugin-herdr)
dsh plugin --profile web add dsh-plugin-herdr

# local directory
dsh plugin --profile web add /path/to/dsh-plugin-herdr

# tarball (pnpm pack output)
pnpm pack
dsh plugin --profile web add ./dsh-plugin-herdr-*.tgz

# git
dsh plugin --profile web add github:sunny0826/dsh-plugin-herdr

Restart the profile after install. Verify with dsh plugin --profile web list.

Uninstall

dsh plugin --profile web remove dsh-plugin-herdr

Restart the profile to unload tools, panel, and Herdr mode. The preset copy at $DSH_HOME/.agent-presets/herdr/ is left behind — remove it manually if needed.

Development

pnpm install
pnpm build        # tsdown (node entries + web client bundle)
pnpm quality      # typecheck + gen-types drift check + unit tests
pnpm test         # unit tests (node --test)
pnpm test:integration  # against a live herdr server; SKIPs when unavailable
pnpm gen:types    # regenerate protocol types from the herdr schema fixture