Superconductor Docs

Diff & Guided Review

Review every code change your agent makes with a full diff view and AI-powered guided review.

Guided Review interface showing file changes with AI-generated comments and diff view

Every implementation includes a diff view showing all code changes made by the agent. You can also launch a Guided Review Agent to analyze the code changes and walk you through each changed file in logical order with in-line review comments.

Raw diff

Raw diff view showing code additions and deletions

The raw diff view shows all changed files in a standard diff format. You can see additions (green) and deletions (red) at a glance, navigate between changed files, and expand or collapse individual files.

Diff settings

Diff display options showing Unified, Split, Wrap, and No Wrap toggles

Click Options in the diff header to toggle display settings:

  • Unified — Shows old and new code interleaved in a single column. This is the default.
  • Split — Shows old and new code side by side in two columns.
  • Wrap — Wraps long lines so you can see the full content without scrolling horizontally. This is the default.
  • No Wrap — Keeps lines on a single line with horizontal scrolling for long lines.

Your preferences are saved automatically and persist across sessions.

Reviewing files

Files are displayed alphabetically by file path, grouped by repository. Each repository section shows a header with the repo name, base branch, and total lines added and removed.

You can manage your review progress with these controls:

  • Collapse All / Expand All — Use the button in the diff header to collapse or expand every file at once.
  • Mark as Viewed — Check the Viewed checkbox on any file to mark it as reviewed. Viewed files automatically collapse so you can focus on what's left. If the agent makes further changes to a viewed file, it will automatically be unmarked so you can re-review it.
  • Expand or collapse individual files — Click a file's header row to toggle it open or closed.

Chatting with agents about diffs

Comment widget on a diff line with Cancel and Add Comment buttons

You can click the + button on any line of code in the diff to open a comment box for that line. Type your feedback and click Add Comment (or press Cmd/Ctrl+Enter). The comment—along with the file name, line number, and code context—is copied into the agent chat and can be sent to the agent.

This is useful when you want the agent to make specific adjustments to specific lines of code. For example, you might comment on a line to ask the agent to rename a variable, add error handling, or change an implementation detail. The agent receives full context about which code you're referencing, so you can iterate quickly.


Guided review

Guided Review showing organized file changes with AI-generated comments

AI agents are great at writing code that is 90% perfect, but the last 10% still requires experienced humans in the loop. Guided Review uses AI to significantly reduce the review burden by:

  • Organizing files in a logical review order (dependencies first, then dependents)
  • Adding text summaries that explain what each group of changes accomplishes
  • Placing in-line comments on specific lines to highlight important details, potential issues, or patterns that need attention

This helps you focus your review time on the parts that matter most.

Launching a guided review

To start a guided review, click the Guided Review tab in the diff panel. If no review exists yet, clicking the tab sends a request to launch the Guided Review agent. The agent analyzes all code changes in the implementation and produces a structured walkthrough.

The review typically finishes within a few minutes. You can watch its progress in real time if you'd like—a work log appears while the agent is running. All guided review agents use Claude Opus 4.6, but you can launch Guided Review on any implementation, for all implementation agents.

Guided Review requires a Claude plan connection or API key to be set. See Claude Code for setup instructions.

Once the review is ready, the Guided Review tab shows a structured walkthrough of the code changes:

  • Text sections — The agent adds narrative text summarizing the code changes, the files that were reviewed, and providing action items.
  • File diffs with in-line comments — Changed files are displayed in a logical order chosen by the agent (typically dependencies first, then the files that depend on them). Each file can have in-line comments highlighting significant changes, potential issues, or things to pay attention to.
  • Toggling comments — Each file header shows a comment count badge. Click it to show or hide the agent's in-line comments on that file.
  • Marking files as viewed — Just like in the raw diff, you can check the Viewed checkbox on each file to track your progress. Viewed state syncs between the Diff and Guided Review tabs.

If the agent makes additional code changes after a review was generated, you'll see an outdated warning with an option to rerun the review.

Outdated warning banner reading "Code has changed since review was created" with a Rerun button

On this page