Changes panel

The "did the agent do something I want?" surface. Every staged diff lands here.

Where it lives

The Changes tab in the right panel. A badge on the tab shows the number of staged files when there's pending work.

Anatomy

Top of the panel:

  • Apply all — applies every hunk in every file.
  • Reject all — discards everything.
  • Mode toggle — Suggest Only (no apply button) vs Apply with Approval (current default).
  • Files staged: N — count of files in the current stage.

Then a list of files. Click a file to expand its diff.

Inside a file's diff

Unified diff with line numbers and gutter colors:

  • Green = additions
  • Red = deletions
  • Gray = context

Each hunk has its own buttons: see Hunk-by-hunk review.

Apply flow

  1. Agent stages diffs.
  2. Banner appears in the agent panel: "Changes staged: N file(s)" + "Review & Apply" button.
  3. Click → Changes tab opens, files listed.
  4. Review hunks. Accept/reject each.
  5. Click Apply at the top.
  6. KrowForge:
  • Snapshots every touched file (before state).
  • Runs the write guard on every write.
  • Applies the accepted hunks.
  • Issues a receipt.
  1. Changes panel clears. The agent gets a confirmation and continues if there's more to do.

Suggest Only mode

A workspace flag for shadow-mode use:

  • The agent runs through everything as normal.
  • Diffs are staged and viewable.
  • No Apply button.
  • Receipts are still written (with applied: false).

Useful for: code review training, evaluating the agent before trusting it, regulatory contexts where AI changes can't be applied automatically.

Dismiss

The Dismiss button on the staged-changes banner clears the stage without applying. This isn't a rollback — nothing was applied to undo. It just discards the proposal.