sunny0826/dsh-plugin-herdr 预览 preview

sunny0826/dsh-plugin-herdr

插件Plugin 原生Native ⭐ 2 MIT cat_label.herdr-plugincat_label.herdr-plugin

Herdr 控制平面插件,用于 DeepSeek Harness(DSH):从 DSH 会话中观察并驱动 Herdr —— 一个面向 AI 编程代理的终端工作区管理器。

项目介绍Project Overview

dsh-plugin-herdr 是 DSH 的 Herdr 控制面插件,通过 Unix 套接字提供 19 个 herdr_* 工具,可查看快照、代理、窗格、工作区、布局与通知,并在会话内显示 Herdr 标签页和侧栏。需要在 DSH 会话中观察或驱动 Herdr 终端工作区、创建随会话生命周期存在的 Herdr 模式工作区时使用。注意:需运行 Herdr 服务器并配置 DSH profile;卸载后预置文件需手动删除。

dsh-plugin-herdr is a DSH control-plane plugin for Herdr, a terminal workspace manager for AI coding agents. It exposes 19 herdr_* tools over Herdr's Unix-domain socket for snapshots, agents, panes, workspaces, layout, and notifications, plus a session-scoped Herdr tab and side panel. Use it to observe or drive Herdr from DSH sessions, including Herdr-mode workspaces tied to a session. It requires a running Herdr server and a DSH profile; uninstall leaves a preset copy to remove manually.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add dsh-plugin-herdr

sunny0826/dsh-plugin-herdr 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-herdr

English | 简体中文

home

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
上一个 Prev dsh-refined 下一个 Next dsh-edit-resend