luoyuejun9/dsh-workstate

Packets what an agent is doing into a machine-readable state with a git fingerprint, so another agent can resume it safely.

Replaces a prose handoff with a state packet: task state, progress, decisions, failures, verification, changed paths, next actions and a git integrity fingerprint, checked against the workspace before another agent resumes it — so a handoff that no longer matches the tree fails loudly instead of quietly resuming onto the wrong code. Four commands cover the cycle: checkpoint to pause and preserve, transfer to produce a shareable export, resume to validate and inject, and diff to compare two checkpoints by stable work-item ids rather than by text diff. It is explicitly not a conversation dump; the argument is that preserved prose loses exactly the structure a resuming agent needs.

Workflow & Automation ★ 1
View on GitHub ↗

Install

dsh plugin --profile web add dsh-workstate

The npm line, then one manual step the README spells out: add an insert row with id: workstate and name: dsh-workstate to ~/.dsh/profiles/web/cordis.patch.yml, preserving existing rows, and restart DSH. A source checkout points an equivalent patch at the locally installed package. Packets use the dsh.workstate/v1alpha1 schema and live under .dsh/workstate/.

Compatibility

Node.js 22.19 or newer and DeepSeek Harness 0.1.0-rc.6. Storage is local-first: checkpoint history is gitignored and only transfer exports are intentionally trackable. The packets contain paths and hashes, never file contents or diffs, and known credential patterns are rejected before persistence — a transfer export still reveals file paths and git state, so it is a deliberate export rather than something that happens in the background. resume validates a packet and injects it; it never changes git state.

Details

Alternatives

taoshi1999/dsh-workspace-hygiene · Jungod1121/dsh-anchored-standard · Pheobe-Southwood/dsh-better-workspaces

More plugins in Workflow & Automation

Browse more in Workflow & Automation

Guides for Workflow & Automation plugins