Run history and revert
Short answer: Every agent or workflow run gets its own card in the Workers panel’s History tab, and a finished run with file changes gets a one-click Revert this run that restores every file it touched to how it was before. It’s separate from a chat’s per-reply undo; this is the run-level version.
What does run history show?
Each run (a single agent execution, or one full workflow run across all its steps) shows up as one card in the History tab, with its status (Running, Done, Needs approval, Failed, or Cancelled), how long it took, and a link to View log, the full run report. The card also shows a live elapsed timer and a Stop control while the run is still going.
For a finished run, Build Perch snapshots the pre-run state of every file the run touched, the first time it touches each one, so Revert this run restores each of those files to exactly how they looked before the run started, in one action. This is separate from a chat message’s own “Undo edits” (which reverts one reply’s changes); a run card reverts everything an entire agent or workflow run did, across every step.
If a file the run changed has since been modified again (by a later run or edited outside the app), reverting warns you first (“File changed since this ran”) rather than silently discarding that newer work; you confirm before it proceeds.
You can also Delete this run from the card’s right-click menu, which removes it from History (the files it changed and its full log stay on disk; you just lose the ability to revert it afterward), or clear a whole workspace’s undo history (every run and reply snapshot) from the Manage Workspaces window.
How do I revert a run?
- Open the Workers panel and switch to the History tab.
- Find the run; cards are listed newest first.
- Click View log to see the full report, or Revert this run to restore every file it changed.
- If the file changed again since the run finished, confirm Revert anyway to proceed, or cancel to keep the newer version.
Good to know
- History keeps a capped number of run cards (adjustable in Settings under “Run history kept”); older runs age out of the list, but the underlying report and files aren’t touched; only the card and its undo snapshots go.
- A run with no file changes (a chat-only or read-only task) won’t show a Revert option: there’s nothing to restore.
- AI file deletions never bypass the Recycle Bin, so a deleted file is always separately recoverable even without a run revert.
- Reverting is exempt from any scoped folders confinement the run itself was under: restoring a file is your action, so the run’s confinement doesn’t apply.