Docs › Using the editor › Reviewing the agent's changes

Reviewing the agent's changes

Keep or undo what the agent changed: one change at a time at the cursor, a file at a time, or a whole run, and ask for a second look.

On this page

Every change the agent makes is written to your files straight away, so you can run and test it, but it stays pending until you decide. You can keep or undo it a hunk at a time, a file at a time, or the whole run at once, from the editor or from the chat. Edit Selection changes are reviewed the same way.

In the file

Open a file the agent changed and each pending change is marked, with buttons above it:

At the cursor, from the keyboard

CommandKeys
AstraCode: Keep the Agent's Change at the CursorCmd+Y (Ctrl+Y on Windows and Linux)
AstraCode: Undo the Agent's Change at the CursorCmd+N (Ctrl+N on Windows and Linux)
AstraCode: Next ChangeOption+Cmd+] (Ctrl+Alt+] on Windows and Linux)
AstraCode: Previous ChangeOption+Cmd+[ (Ctrl+Alt+[ on Windows and Linux)

Cmd+Y and Cmd+N act on the change the cursor is in, and only there: anywhere else they keep their usual meaning in the editor. Next Change and Previous Change jump between pending changes across files, so you can walk a whole run with the keyboard: next, read, keep or undo, next. With nothing pending they say No changes from this run are awaiting review.

In a diff

Run AstraCode: Review Agent Changes to open every pending change, from every run, in one diff editor titled Agent Changes. Review on a run card opens the same view for that run only.

With nothing pending, it says No agent changes are waiting to be reviewed.

In the chat

See The chat panel for the run card in full.

Where the controls sit

Review Control Location in AstraCode Settings, General (astracode.review.controlLocation) chooses where the run-level controls go:

OptionValueWhat you get
Breadcrumb (default)breadcrumb✓ Keep (agent change), ↩ Undo and ⚑ Report above the change in each file.
Status barislandA status bar item, N to review, that opens Review Agent Changes. Fewer buttons in your code.

Keep and Undo on each change appear either way.

What undo does

Find Issues in Agent Changes

A second look before you keep a run. AstraCode: Find Issues in Agent Changes, or Find issues in the panel's review view, asks the agent to review only the pending changes, not your whole branch.

  1. Run AstraCode: Find Issues in Agent Changes.
  2. A review runs in the chat, titled Find issues in this change (or these N changes), so you can watch what it reads.
  3. Findings land in the Problems panel, from AstraCode review, on the line they are about. A new review replaces the last one's findings.

It needs no git: it works on a new file, a repository with no commits, or a folder that is not a repository. Up to 120,000 characters of diff are sent. With nothing pending it says No agent changes are waiting. Use "Review This Branch" to review everything since the branch point. To review the whole branch, see Git.

If something goes wrong

More in Agent run problems.

← Edit and ask about a selection Git: commit messages, branch review and conflicts →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference