Skip to content
dsh-market Browse plugins GitHub 中文

yongshuai0314/dsh-turnsnap

Zero-config per-turn git checkpoints: after every completed agent turn in a git workspace, stages all changes into one tagged \[turnsnap] commit (serialized queue, sandbox-policy aware), so any turn is a rollback point.

Stars ★ 0 Category Git & Code Review Listed 2026-08-27 npm dsh-turnsnap

Install

Inside DeepSeek Harness, with dsh-market

dsh plugin --profile web add dshmarket

Or from the command line

dsh plugin --profile web add dsh-turnsnap

Installing runs third-party code with your own permissions — it can read your files, use your credentials and reach the network. Review the source first, and pin a commit (github:owner/repo#sha) when you can.

README

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

Content from the project README on GitHub ↗

Comments

Comments live in GitHub Discussions. Sign in with GitHub to post or react.