Graph Diff View

Feature

Compare branches side-by-side with git-style diff coloring to understand exactly what would change on merge.

Overview

The Graph Diff View lets you compare two branches side-by-side, highlighting what's new, what's changed, and what would happen if you merged.

It works like a git diff but for your decision graph - making it easy to review proposed changes before committing them.

Accessing the Diff View

There are two ways to open the diff view:

From the branch indicator: When viewing a branch, click the "Review" button in the branch indicator bar at the top
From the branches page: Navigate to your team's Branches page and click "Compare" on any active branch

Comparison Modes

Merge Mode

Compare a branch against Main, like a pull request review. This is the default when you click "Review" from a branch.

• Left pane: Main (target)
• Right pane: Your branch (source)
• Center: Animated merge arrow

Shootout Mode

Compare any two branches against each other, like comparing competing strategies. Select both branches from the dropdowns.

• Left pane: Branch A
• Right pane: Branch B
• Center: VS badge

Understanding the Colors

The diff view uses git-style colors to highlight changes:

Added (Green)

New decisions that only exist in the branch, not in main.

Superseded (Amber)

Decisions that are being replaced by a supersedes relationship.

New Relationship (Blue)

Relationships created in the branch between existing decisions.

Unchanged (Dimmed)

Existing decisions that aren't affected by the branch. These fade to 25% opacity to focus attention on changes.

Diff Metrics

The header shows a summary of changes:

+N Added: New decisions in the branch
↑N Replaced: Superseded decisions
~N Relationships: New edges created

Click any metric badge to cycle focus through those specific changes in the graph.

Navigation

By default in merge mode, both panes sync their navigation. Pan or zoom on one side, and the other follows. This makes it easy to compare the same area of the graph.

Click the sync toggle button (chain link icon) to unlink the viewports and navigate independently.

In shootout mode, viewports are independent by default since the two branches may have completely different layouts.

Resizing Panes

Drag the center divider to resize the panes. This is useful when one branch has more content than the other.

Double-click the divider to reset to a 50/50 split.

Merging from Diff View

When you're satisfied with the changes, click the "Merge" button in the diff view header to open the merge modal. This pre-selects the branch you're viewing.

The merge modal offers two strategies:

Flat Merge: Each decision becomes a separate node on main
Summary Merge: AI generates a summary decision that represents the entire branch

Features

Pulse Dashboard

Command Palette