Skip to main content

Review a run

When a coding agent finishes, the run moves to Waiting for review and stops. Nothing merges and nothing is thrown away until somebody decides.

Find what is waiting​

Reviews in the left navigation lists every run waiting on somebody, newest first, with a count beside the heading.

Reviews screenshot placeholder showing the queue with two runs waiting

Each row carries the run reference, the issue title, which agent ran it on which machine, the diffstat, and when it finished. Empty, it reads Nothing is waiting. A run appears here when a coding agent has finished and somebody has to say whether the work is good.

What changed​

The What changed section is the result, as one change, however many repositories it spans.

Execution screenshot placeholder showing the What changed section with two repositories and their pull requests

At the top, the coding agent's own summary and a line reading 3 commits across 2 repositories · +212 −48 · 14 files.

Then one block per repository: its name, its commits and diffstat, the branch it pushed, and the pull request it opened. Where none was opened it says so — Pushed to feat/retry-fix. No pull request was opened.

Show the diff expands the diff in place. Large diffs are cut off with a link to download the rest. The full diff was not kept for this repository. The branch still has every commit. means retention has already swept the upload, not that the work is gone.

Below the repositories, any checks the run ran show as Passed, Failed or Skipped.

The same section appears on the issue itself, folded across every attempt, with a Download the diff link instead of the expander.

Accept it​

Approve asks Accept this work?. Confirming moves the issue on and starts the clock on giving the workspace back.

A machine may not accept its own work. If an agent tries, Norn refuses with A machine may not accept its own work. Somebody else has to review this run.

Send it back​

Request changes opens a box: Say what should change. It is handed to the coding agent word for word.

Execution screenshot placeholder showing the request changes box with feedback typed in

Send it back resumes the same run — same branches, same preview addresses. New commits amend the result you were already looking at rather than starting a second one beside it.

Write it as you would to a colleague. It is not parsed; it is passed through.

How long things are kept​

While a run waits for review, the machine is holding its scratch workspace and its previews. The run says what is happening to them:

  • This machine is holding the workspace and its previews while you decide.
  • The workspace and its previews go at 24 Aug, 14:30.
  • The workspace and its previews went at 24 Aug, 14:30. Everything on this page stays.

Keep it an hour longer moves the deadline to an hour from now. Press it again nearer the time to move it again. It only appears while the run is waiting for review, and it never brings the deadline forward.

When the deadline passes, the machine gives back the scratch copy and closes the previews. The run, its timeline, its diff and its pull requests stay in Norn. Only the live workspace goes.

Stop it instead​

Stop this run ends a run without accepting or rejecting it. The branches it already pushed stay where they are.