Review Mode

  • Desktop app
  • All plans

What it does

A full-screen review of everything your agents changed before you commit it. The left list names every modified file with its status color (added, deleted, modified) and a Files (3/8 reviewed) progress; the center shows the diff side by side (Original / Modified) with syntax highlighting and word-level differences inside each line, or the full file. You walk through the files one by one, mark each as reviewed, leave comments on specific lines and send them back to the agent, and when every file is checked a Review complete screen lets you write or generate the commit message and commit.

Where to find it

  • Right panel > Changes tab > Review button (Review all changes one by one).
  • The Review button can be hidden or restored from Settings > Interface elements > Right panel.

How to use it

  1. Open the Changes tab and click Review.
  2. Move between files with the left/right arrows or j/k, or click a file in the list. Toggle Diff / File to see the change or the whole file. The list is laid out like the Changes tab: a tree by folder (the default) or a flat list of full paths, following the same View options choice. In the tree, click a folder to fold it; the folder of the file under review always reopens, and Next / Previous walk the files in the order the tree shows them. Cmd+F (macOS) / Ctrl+F (Windows, Linux) opens a find bar at the top right of the diff or file: it searches the whole current file (not only the visible lines), shows 3 of 12, Enter / Shift+Enter or the arrows jump between matches, Escape closes the bar without leaving the review.
  3. Mark a file reviewed once you are satisfied; the progress bar updates.
  4. Disagree with a line? Comment on this line, type what the agent should change, Add. When you are done, Send comments (N): they are queued as one message to the agent that owns the changes.
  5. When every file is reviewed, Review complete appears: write a message or click Generate commit message with AI, then Commit. The modal closes on success.

The review can be filtered to one agent's files; see Per-Agent Review.

Discard changes. A change you do not want can be thrown away from the Changes tab: open the file's ... menu and pick Discard changes. A modified file goes back to its last committed version; a file that was never committed is deleted from disk. The confirmation takes two steps and says which of the two will happen, because the uncommitted changes are lost for good (there is no undo). The same action is in the file menu of the mobile Changes screen, where it runs on your desktop through the bridge.

Settings

  • uiElements.rightPanel.review (global, Settings > Interface elements): show or hide the Review button.
  • The AI commit message follows the settings of AI Commit Messages.

Agent tools (MCP)

None. Comments sent from the review reach the agent as a normal message.

Providers

All providers for the diff and the commit. Sending line comments requires a live agent to send them to (No agent to send these comments to otherwise). Per-agent filtering is not available for every provider; see Per-Agent Review.

Mobile

The phone has a Review changes entry on the project screen to read the diff of pending changes; marking files, line comments, the find bar (a keyboard shortcut) and the commit flow are desktop only.

Limits

  • The commit screen appears only when every file in the current list is marked reviewed.
  • Very large diffs disable syntax highlighting and inline word-diff to keep scrolling smooth; very large files are truncated in the file view.
  • The review works on the git working tree: the project must be a git repository.

Common questions

  • Do I have to review every file before committing? Yes, inside Review Mode. The Changes tab's own commit box commits without that gate.
  • Can I ask the agent to fix something I spot? Yes: comment the lines, then Send comments; the agent receives them as review feedback.
  • What do the colors mean? Green added, red deleted, orange modified.
  • Can I see the whole file, not just the diff? Yes, the File toggle at the top.
  • Can the review list group files by folder? Yes, it follows the layout of the Changes tab: Changes > View options > Tree by folder (the default) or Flat list.
  • Can I search inside the diff? Yes: Cmd+F / Ctrl+F in Review Mode opens a find bar for the current file (case-insensitive, both sides of the diff).
  • Can I revert a file's changes from the Changes tab? Yes: the file's ... menu > Discard changes. It restores the file to its last commit (like git restore), or deletes it if it was never committed. Confirm twice; the lost changes cannot be recovered. Also available from the phone's Changes screen.