Add checkpoint rewind menu

[lintowe]

Summary

• Restoring via checkpoints already was in codebase but it was behind a hover-able action, so this makes reverting easier by adding a revert button next to your sent messages (alongside the option to double-press the Esc button like Claude Code) in your projects that show you if it's an available checkpoint target that lets you revert, alongside showing things like changed-file context & disabled states before dispatching the existing restore command.

Screenshots

What Changed

• Added a checkpoint rewind dialog for active server threads.
• Added the checkpoint.rewind command with the default Esc Esc shortcut.
• Added a command palette action for opening the rewind menu.
• Lists rewind targets from existing checkpoint/revert data, newest first.
• Restores by dispatching the existing thread.checkpoint.revert command.
• Keeps the existing user-message hover action, now opening the rewind flow.
• Adds focused unit and browser coverage for candidate derivation, dialog behavior, keybinding handling, and dispatch.

Verification:

• bun fmt
• bun lint
• bun typecheck
• bun run test --filter @t3tools/web
• bun run test -- src/keybindings.test.ts in packages/contracts
• bun run test -- src/keybindings.test.ts -t "checkpoint rewind|double-Escape" in apps/server
• bun run test:browser -- src/components/ChatView.browser.tsx -t "checkpoint rewind" in apps/web

---

Note

Medium Risk
Adds a new checkpoint rewind UI flow and extends keybinding handling to support 2-step sequences, which can affect global keyboard handling and checkpoint revert UX. Risk is mitigated by extensive unit/browser test coverage and limited scope to a new command and dialog.

Overview
Adds a checkpoint rewind dialog that lets users select a prior prompt/checkpoint (with diff stats) and restore by dispatching thread.checkpoint.revert, including disabled states and automatic closing on thread/navigation changes.

Introduces the checkpoint.rewind command surfaced via a new Command Palette action and a default double-Escape shortcut (esc esc). The keybinding system is extended end-to-end (contracts/shared/server/web) to support 2-key sequences (conflict detection, label formatting, encoding/decoding), and the existing per-message rewind affordance now opens the dialog pre-selected instead of immediately reverting.

^{Reviewed by Cursor Bugbot for commit 109c7c0. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add checkpoint rewind dialog triggered by double-Escape or command palette

• Adds a RewindCheckpointDialog that lets users select and restore a prior conversation checkpoint, dispatching thread.checkpoint.revert without a confirmation modal.
• Opens via a double-Escape key sequence (esc esc) when terminal is not focused, or via a new 'Rewind checkpoint' action in the command palette.
• Computes rewind candidates in deriveRewindCheckpointCandidates, associating each user prompt with the next assistant checkpoint and aggregating diff stats, sorted newest first.
• Extends the keybinding system to support ordered key sequences (up to 2 steps), including conflict detection and label formatting (e.g. Esc Esc).
• Behavioral Change: onRevertUserMessage no longer triggers an immediate revert — it now opens the rewind dialog pre-selected instead.

^{Macroscope summarized 109c7c0.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 536047e6-842c-4c7e-9fe2-127d0ba8ac09

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[macroscopeapp]

Approvability

Verdict: Needs human review

New feature adding a checkpoint rewind menu with a dialog component, command palette integration, and double-Escape keybinding. Introduces new user-facing behavior and UI components that warrant human review.

^{You can customize Macroscope's approvability policy. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 277e57a. Configure here.}