deepseekplugins

DeepSeek Harness plugin

dsh-workstate

A structured work-state protocol for DeepSeek Harness agent handoffs

Workflow & Automation
Jump to install

Source facts

Repository
luoyuejun9/dsh-workstate
Latest update
Aug 16, 2026
Category
Workflow & Automation
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/luoyuejun9/dsh-workstate
Plugin: dsh-workstate
Author: luoyuejun9

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-workstate

A structured work-state protocol for handing off AI coding tasks between agents.

dsh-workstate is a local-first plugin for DeepSeek Harness. It captures what an agent is doing now: task state, progress, decisions, failures, verification, changed paths, next actions, and a Git integrity fingerprint. It is not a conversation dump.

中文文档

Why

Normal handoffs preserve prose. Workstate preserves a machine-readable state packet and checks that the workspace still matches before another agent resumes it.

  • checkpoint: pause and preserve current work.
  • transfer: create a shareable export for another agent or developer.
  • resume: validate and inject an existing packet; never changes Git state.
  • diff: compare two checkpoints by stable work-item IDs.

Install

Requires Node.js 22.19+ and DeepSeek Harness 0.1.0-rc.6.

dsh plugin --profile web add dsh-workstate

Add this insert to ~/.dsh/profiles/web/cordis.patch.yml, preserving existing rows:

- insert:
    - id: workstate
      name: dsh-workstate

Restart DSH. For a temporary source checkout, point an equivalent patch at the locally installed package.

Commands

/workstate checkpoint [note]
/workstate transfer [target]
/workstate list
/workstate inspect [id]
/workstate diff <from> <to>
/workstate validate [id]
/workstate resume [id]
/workstate resume [id] --allow-diverged

The model also receives workstate_capture, workstate_list, workstate_read, workstate_diff, workstate_validate, and workstate_resume tools.

Storage and safety

Packets use dsh.workstate/v1alpha1 and live under .dsh/workstate/. Checkpoint history is local and gitignored. Only transfer exports are intentionally trackable. Packets contain paths and hashes, never file contents or diffs. Known credential patterns are rejected before persistence.

Resume validation compares Git branch, commit, dirty state and a content fingerprint. Divergence fails closed. The plugin never checks out, resets, stashes, stages, commits, or pushes.

Development

npm install
npm run check

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category