Get it for macOS

Undo an agent's file changes turn by turn, and let the conversation go back with them. Checkpoints the workspace before each message and after each turn, on every provider, with no setup. Preview a restore as a per-file diff before it runs, and undo it afterwards. Restore the files and edit your message in one step, or fork from any message into a worktree whose files are as they were then. Flags turns that ran git push, a deploy, or other effects a restore cannot undo. Needs git on the thread's machine; the workspace itself does not have to be a git repository.


Overview

View source

Conversation forks don't bring the files back. Rewind does: it checkpoints every thread's workspace before each message and after each turn, with no setup, whichever agent provider the thread uses.

What you get

  • Rewind to here on your messages and on replies: preview what would change, then restore the files to before that message or to the end of that reply's turn. Or restore the files and edit your message, so the conversation rewinds with them.
  • A Checkpoints panel: every turn with its message, files changed, and per-file diffs, plus the restore history with Undo.
  • Fork from here with files: a new thread that continues from that point in a new worktree whose files are exactly as they were.
  • A checkpoint count in the thread header, palette commands, and bb rewind (list, diff, restore, undo, checkpoint, fork, …).
  • Agent tools rewind_checkpoint and rewind_list. There is no restore tool: restoring stays your call.

Safe by default

Every restore takes a checkpoint first, so it can be undone. It never touches ignored files such as node_modules or an ignored .env, never writes into .git or changes commits, and refuses while an agent is running in that workspace. It tells you what it cannot undo, like a turn that ran git push. A message is held a fraction of a second for its checkpoint; a slow one is queued until it is saved.

How it works

Snapshots go into a separate git repository Rewind keeps per workspace on the machine that holds it, so your repository is untouched and non-git workspaces work too. Only changed files are re-read, and a daily cleanup keeps the newest checkpoints per thread.

Requirements

git on the thread's machine. Forking with files needs a git repository and a provider that can fork mid-conversation. Workspaces over 100,000 files or 2 GB are skipped rather than slowed down.

More from MacHatter1

Agent TVSee what every running agent is doing, and which one needs you, from a live wall at the foot of the sidebar. Each tile shows the tool call in flight, the files touched in the last minute, a 60-second activity trace, and how much of its context window the thread has used. Threads blocked on a question or an approval are marked and sorted to the top. Pop the wall out as a monitor you can drag anywhere in BB. The bb agent-tv status command gives terminals and agents the same feed, and nothing leaves your BB server.107AnimationPlay technical diagrams as a sequence of beats, then export a looping HTML page. Open a .scene.json file to get a stage and a timeline: drag a step boundary to retime it, or click a part to quote its state into chat. Agents write the same JSON with ordinary file edits. GIF and MP4 export are not included; HTML is the shareable output. Requires BB 0.43 or later.59RecapGenerates concise, display-only summaries for BB threads on demand or after they become idle.168Composer PredictionsSuggests the message you're likely to send next as ghost text in the empty composer, one Tab from an editable draft. Nothing is sent for you: Tab only fills an empty message box, and typing, pasting or Escape hides the suggestion until the conversation moves on. Suggestions are saved across restarts and checked against the conversation before they reappear, so an unchanged thread costs no new request. Every reply in a thread you've opened costs one request in a hidden helper thread, which receives up to 48,000 characters of recent messages and tool output.31

More in Code & Reviews 61

Work with repositories, builds, changes, pull requests, issues, and reviews.

View all