dsh-turnsnap

Zero-config per-turn git checkpoints for DeepSeek Harness (DSH). After every completed agent turn, if the session's working directory is a git repository with uncommitted changes, TurnSnap stages everything and creates one tagged [turnsnap] commit — a rollback point you never had to ask for.

中文说明

Why

Long agent sessions rewrite many files. When a turn goes wrong you either reach for git by hand or lose the trail. TurnSnap makes the checkpoint automatic: one commit per turn, named after the turn number, file count and time:

[turnsnap] turn 12 · 7 files · 14:32:08

Install

dsh plugin --profile <your-profile> add dsh-turnsnap

No configuration, no client half, nothing to approve: the host half hot-reloads within seconds and starts guarding every session in a git workspace.

How it works

• Listens to the harness agent/turn-stopping event.
• Resolves the session workspace from agent.session.header.cwd.
• Skips silently when the directory is not a git repository or has a clean tree.
• Otherwise runs git add -A && git commit -m "[turnsnap] turn N · M files · HH:MM:SS" --no-verify.
• Checkpoints are serialized on one internal queue, so a parent session and its subagents closing turns at the same moment cannot race the git index.
• Git runs through the harness shell service; when the host exposes a sandbox-policy resolver, each request is stamped with the owning session's standing file policy.

Agent tools

Tool	Effect
turnsnap_pause	Stop auto-commits until resumed
turnsnap_resume	Resume auto-commits
turnsnap_status	Report enabled state, counters and the last checkpoint message

All three take no arguments. Ask the model to "pause turnsnap" mid-session, or call them yourself from any script that can invoke harness tools.

Caveats

• git add -A folds anything staged-but-uncommitted into the checkpoint. If you keep a deliberate partial stage across a turn boundary, pause first.
• Ignored files stay ignored (add -A respects .gitignore).
• Commits use --no-verify, so your pre-commit hooks do not run on checkpoints.
• One checkpoint per repository per turn: subagents sharing the workspace land in the same commit.

License

MIT