dsh-rollback

Usage

30-second quickstart

1. Open a session whose working directory is a git repository.
2. write a file notes.md with the content hello.
3. write it again with goodbye — the first content is silently checkpointed.
4. Tell the model "restore the file you just overwrote" (it calls rollback_files), or type /rollback yourself.
5. Read notes.md: it says hello again.

For humans — /rollback [count]

Type it in the chat input (base web and headless profiles mount the command registry the command needs):

• /rollback — undo the single most recent captured mutation in this session's working directory,
• /rollback 3 — undo the three most recent ones.

The output lists every restored file and its action:

rollback: restored 2 file mutation(s):
  restored  /ws/src/lib/parse.ts
  deleted   /ws/src/lib/generated.ts

For models — rollback_files

One model-facing tool, rollback_files {count} (no prompt section). It is meant for the model to undo its own write/edit mistakes instead of asking the user. Restores are scoped to the calling session's working directory and reported as a per-file summary — restored file contents are not echoed.

What is captured

Only successful write/edit tool results that carry a before pre-image. Mutations through bash, str_replace_editor, or raw subprocesses carry no pre-image and are not captured (see Known Limitations). A session can only restore records at or under its own working directory.