Keep and revert
In a folder with Track Changes on, you can Keep or Revert each change that other apps (AI tools included) made: Keep accepts the change, and Revert changes it back to what you last accepted. You can also handle a whole file, several selected files, or everything at once.
This is a Plus feature, with a free 14-day trial. For how changes are worked out, see Track Changes. Git repositories don't have Keep and Revert; see Uncommitted changes in a Git repository.
Where to handle them
Section titled “Where to handle them”- The Changes section in the sidebar: at the top of the folder page, listing the changed files and the lines added and removed. File name colors: green for added, red for deleted, yellow for modified.
- In the text: open a changed file and the changes are marked in the formatted text, with Keep and Revert buttons floating next to the current one. This needs Show Diff on, which it is by default; see See differences in the text.
- The review bar at the top of the file: says Changed Externally, with which change you're on out of how many (such as 2 of 5), up and down arrows, and Revert File and Keep File.
One change at a time
Section titled “One change at a time”- Open the file and go to a change with the up and down arrows on the review bar, or press ⌃⌥↑ / ⌃⌥↓.
- Click Keep (⌃⌥↩) or Revert (⌃⌥⌫) next to it; you move on to the next change automatically.
- At the first or last change, the arrows take you to the previous or next file in Changes.
The shortcuts only act on a change you can see on screen. If that change isn't in view, pressing them only plays an alert sound and does nothing.
A whole file, a selection, or everything
Section titled “A whole file, a selection, or everything”- A whole file: Keep File (⇧⌃⌥↩) or Revert File (⇧⌃⌥⌫) on the review bar, or right-click a file in Changes. After you keep a file from the review bar, the next file in Changes opens.
- Several selected files: in Changes, hold ⌘ or ⇧ to select two or more files, and the two buttons under the heading become Keep N Files and Revert N Files, acting only on the selection.
- Everything: Keep All or Revert All under the Changes heading, for the whole Workspace.
What you keep is recorded in Workspace History.
Before you revert
Section titled “Before you revert”- Reverting in the text or on the review bar can be undone right away with ⌘Z.
- Reverting in the sidebar asks you first. Except for the file showing in the editor, reverts in the sidebar can't be undone.
Special kinds of files
Section titled “Special kinds of files”- Added files: the review bar says Added Externally, and the buttons are Move to Trash and Keep File. Reverting an added file moves it to the Trash; to get it back, put it back from the Trash.
- Files deleted by another app: shown as deleted in Changes. Open one to see its content as you last accepted it; at the top you can choose Keep Deletion or Restore File.
- Files renamed by another app: shown as one row, with the original name after the new one. Keeping or reverting the row does it for both names together.
- Images, PDFs and other files reported as changed only: can be kept. Their changes and deletions can't be reverted, because no old versions are stored; only added ones can be reverted (moved to the Trash).
- Text files over 1 MB: can't be handled one change at a time, only kept or reverted as a whole.