Skip to content
LogoLogo

Reviewing changes

diffx opens on Reviews, your review bench: every current stream with changes, one per source, checkout, branch and comparison, newest activity first. Each stream shows its newest snapshot only; clean streams and superseded snapshots are hidden. Needs attention lists new streams and streams updated since you opened or marked them viewed; All open lists every current stream and Closed merged or closed pull requests and stale branches. Drafts wait under All open until they are ready. On a first visit, work idle for a day counts as already seen. Filter by repository or agent, or type to search. Move with ↑ and ↓, press Space to peek at a review's size, progress and description without opening it, and Enter to open it. While the peek shows, a click previews a review and a double click opens it; drag the peek's edge to resize it. Without the peek, a click opens. Mark all viewed clears Needs attention; Alt+Shift+V and Alt+Shift+U mark the selected review viewed or unread. Views and filters stay in the address, so you can bookmark them.

Inside a review, ‹ Reviews (Alt+Shift+B) returns to the bench as you left it. The header's arrows (Alt+Shift+J and Alt+Shift+K) step to the next or previous review in the bench's order, and its check marks the review viewed or unread. Once every file is reviewed, a notice offers the next review. The header names the open review's repository, branch and worktree; the repository and branch are menus you can type into to filter, then press Enter to switch. Collapsed files and folders are remembered across reloads in the same tab. When a newer snapshot arrives for the stream you are reviewing, a notice offers View latest without replacing the open review.

Search reviews (the header magnifier or Ctrl/Cmd+K) to reach older or empty snapshots. Select a repository, then an observation. Search/filter stored metadata to find a branch, worktree, host, source or agent run. Switch between its collected all, staged and unstaged scopes. Use the file tree to navigate, mark files as reviewed and comment on lines. Alt+J and Alt+K move between files; Alt+[ and Alt+] (or the toolbar's arrows) move between changed blocks across expanded files; Alt+M marks the selected file reviewed and moves to the next one, or unmarks a reviewed file. Hide reviewed files, beside the file filter, removes reviewed files from both the tree and the diff for that tab. Copy unresolved and Copy all export comments as agent-ready XML, including each thread's replies.

Each comment names its author: You, or an agent's reported name beside a bot icon. Reply answers a comment in a one-level thread (Ctrl/Cmd+Enter sends, Esc cancels); you can edit your own replies and delete any reply. Resolved threads show who resolved them. Replies and resolutions from agents or other tabs appear live without losing what you are typing. The link button copies a permalink that reopens the review at that comment. In the Review panel, the comment filter also narrows comments to Everyone, Me or Agents.

Observations are immutable. New content creates another observation; matching submissions associate new provenance with an existing review without changing its captured diff. Comments and reviewed marks belong to the checkout's stream and are stored with the snapshots: later snapshots re-anchor comments to moved code, flag outdated ones, and keep marks on files whose patch is unchanged. Deleting one snapshot keeps them; they end with the stream's last snapshot. Display preferences remain in the browser.