docs menu: reviewing work
docsusing easl
reviewing work
Review an agent's diff, stage or discard it, and undo any step.
on this page
The transcript stays in the terminal. The work lands on the board:
- a changes tile for the diff
- code tiles and notes for the evidence
- an arrow path for the walkthrough
the changes tile
File › Review Changes (⇧⌘R), or right-click the board › Review Changes, shows what changed, file by file, like a pull request. If the board has a changes tile for that folder and base, easl goes to it. Agents open one to show their work.
- A unified diff with 3 lines of context, added lines green, removed lines red. Hunk headers read
Lines 15–46 · <function>. - With more than one file, a file list sits on top. Click a file to jump to it.
/filters files by path. - A Viewed box folds a file until its diff changes. Deleted files start folded.
- Click a line to open it in a code tile beside.
pick the base
Click the tile’s summary to pick the comparison:
| Base | Shows |
|---|---|
| Uncommitted changes | Everything not yet committed, staged or not (the default) |
| Branch vs main | What the branch changed against its default branch, as a pull request shows it |
| A commit or ref | Typed into the picker’s field |
The header names it: Uncommitted changes · 3 files · +40 −12. File › Review Branch opens the branch view. A changes tile can review another worktree of the repository, named in its title.
stage, unstage, discard
Each works on a file, a hunk or selected lines. Drag over lines or ⇧-click one to select.
- Stage marks a change for the next commit (
git add). Unstage removes the mark. Neither touches your files. - Discard deletes an uncommitted change from your files. It asks first: the button turns into a red Discard? until you answer. Click again, or press ⌘⌫ after
r, to discard. Any other key keeps the change. A notice names what went: “Discarded gui.md, lines 13–20 from your files · ⌘Z undoes”. - In a branch review, a committed hunk says committed and has no Discard button. Reverting a commit is git’s job. No button discards everything.
- A hunk shows staged once the index holds it, partly staged if it changed after you staged it.
keys
Press Return or click to give the tile the keyboard. Until then, a key only reminds you to.
| Key | Action |
|---|---|
| j / k or ↓ / ↑ | Next / previous hunk |
| J / K or ] / [ | Next / previous file |
| ↩ | Open the line in a code tile |
| s | Stage |
| u | Unstage |
| r, then ⌘⌫ | Discard |
| m | Mention the hunk or selected lines |
| Esc | Clear a line selection, then give the keyboard back |
undo tells you what it undid
Each Stage, Unstage or Discard is one ⌘Z step, so a discarded hunk comes back. The notice names it: “Undid Stage of src/regex_helper.rs · ⇧⌘Z redoes”. ⌘Z undoes agents’ changes too. See agents.
evidence agents leave
- Captioned code tiles point at real code and say why it matters. See tiles.
- Notes quote live lines from disk and propose diffs. See tiles.
- Walkthroughs join stops with next-step arrows. Select the first stop and press ⌥⌘→. See navigation.
- Markers. A pink attention marker flags what the agent wants you to see. It clears once you’ve seen it.
- “by <terminal name>” in a title bar names the agent that made the tile.
To present a review, use Hide Board Chrome (⌥⌘T). See navigation.