Skip to content

Diff & Review

After an agent completes its work, Shellarium provides a full review workflow before you merge any changes.

The Diff tab shows all changes made by the agent:

  • File tree — list of all modified, added, and deleted files with change counts
  • Inline diff — unified diff with line-level coloring for additions, deletions, and hunk headers
  • Change statistics — lines added, removed, and modified per file

Click any file in the file tree to see its diff. The viewer highlights:

  • Green lines for additions
  • Red lines for deletions
  • Context lines around each change

Agents may create multiple commits during their work. You can see the full commit history in the workspace, and review the combined file diff in the Files changed tab.

When you’re satisfied with the changes:

  • Squash merge — combine all agent commits into a single commit on your branch
  • Merge commit — preserve the full commit history
  • Create PR — use the Create PR action to prepare and open a GitHub pull request

Before merging, Shellarium checks:

  • No conflicts — the worktree branch can be cleanly merged
  • CI status — if a PR exists, GitHub CI checks are passing
  • Review decision — if a PR exists, approval/changes-requested state is shown