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.
Install
dsh plugin --profile web add dsh-workstateThe 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
- Repo: luoyuejun9/dsh-workstate
- Category: Workflow & Automation
- Stars: 1
- Version: 0.1.0 (npm)
Alternatives
taoshi1999/dsh-workspace-hygiene · Jungod1121/dsh-anchored-standard · Pheobe-Southwood/dsh-better-workspaces