Native DSH checkpoint and rewind workflow with approval-gated restore and read-only preview.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-24
License
Apache-2.0
01What can it help you accomplish?
Restore workspace, session, or config state after a mutation
A checkpoint record and an approved `/rewind` transaction that can restore selected states
DSH users who need reversible edits without rewriting the original session
Inspect a rewind without changing files
A read-only `/rewind preview <target>` impact report
DSH users who want to see which files would change before approval
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness profile
- Storage stack for checkpoints: dsh-storage, dsh-storage-json, and dsh-storage-domain
Installation steps
- 01
$ dsh plugin --profile web add "github:PerryLink/dsh-checkpoint-rewind#main"
- 02
Restart DSH and verify the plugin row.
Verify the integration
- dsh --profile web --dump-config | grep -A4 'id: checkpoint-rewind'
Rollback
- dsh plugin --profile web remove dsh-checkpoint-rewind
03DSH integration and capability boundaries
Native DSH capability-seam plugin for workspace, session, and config checkpoints with approved rewind commands.
Three-state checkpoints
Workspace mutations, session boundaries, and config state→Workspace, session cursor, and config snapshots
Checkpoint records use local storage.Approved rewind and preview
A checkpoint id, step number, or latest target→Restored files plus a forked child session, or a read-only impact report
A real rewind requires confirmation; preview does not write or fork.
04Who is it for? When not to use it?
Good for
- DSH users who need reversible edits without rewriting the original session
- DSH users who want to see which files would change before approval
Not for
- Restore requires approval and a missing or denying answerer fails closed.
- The default restore overwrites captured files rather than deleting files created after the checkpoint; reset-hard is opt-in.
- The plugin can mount without the storage domain, but checkpoint and rewind commands require the storage stack to be composed.
05Compatibility, maintenance and safety notes
- Restore requires approval and a missing or denying answerer fails closed.
- The default restore overwrites captured files rather than deleting files created after the checkpoint; reset-hard is opt-in.
- The plugin can mount without the storage domain, but checkpoint and rewind commands require the storage stack to be composed.
Apache-2.0 · latest release v0.6.18
06Frequently asked questions
What does dsh-checkpoint-rewind checkpoint?
Each checkpoint covers workspace state, the session cursor and turn boundary, and plugin configuration. Captures can be triggered automatically, manually, before mutations, or as a rewind guard.
Does rewind rewrite the original session?
No. Session rollback forks a new child session at the checkpoint boundary while the original session keeps its full history.
Can I preview a rewind safely?
Yes. `/rewind preview <target>` performs a read-only comparison and does not prompt, write, fork, or record a rewind event.
What happens when approval is unavailable?
The plugin fails closed, keeps the checkpoint, and returns an explanatory error.
Does it require the storage stack?
The plugin can mount without it, but checkpoint and rewind commands require the storage domain rows described in the README.
07Related DSH workflows
archify
by tt-a1i
Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
openviking
by volcengine
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
aitoearn
by yikart
Let's use AI to Earn!
learn-harness-engineering
by walkinglabs
Harness engineering beginner tutorial, from 0 to 1
08Data and sources
**Unified DeepSeek Harness checkpoints — session + workspace + config three-state snapshots with one-shot rollback.**
capture before every mutation, restore any of the three states with one approved command.
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-24. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.