Skip to content

Review changes

Next to its conversation, a Task shows the actual files and diff of the repository it works in, so you can judge the result yourself.

Working Tree showing a Task's changed files and the diff of one of them Working Tree showing a Task's changed files and the diff of one of them

Open it

In a Task, choose Working Tree or Branch next to Conversation. A Section of a repository offers the same view without a Task.

  • Working Tree shows the changes since the last commit: staged, unstaged, and untracked. A file's diff shows them together; the Staged and Unstaged groups say how the file is staged.
  • Branch shows everything the current branch changes since it left a base branch you choose, including changes not committed yet and new files.

The view follows the files as they change, so you can keep it open while the agent works.

Find a file

The left side lists either:

  • Changes, the changed files grouped by folder, each marked with its kind of change; or
  • Files, the whole repository, to read any file.

Settings → Files chooses whether folders come before files in these trees.

On a foldable or a tablet held upright, the list folds into a strip on the left edge; tap it to open the list over the file, and choosing a file closes it.

Read a file

The right side shows the selected file in one of these ways, as the file allows:

  • Diff, the unified diff of the change, with line numbers on both sides;
  • Visual, for images, the picture before and after the change: Side by side shows both with their size, and Difference paints the pixels that changed in red;
  • Source, the whole file as text, with what Working Tree or Branch changed marked beside the line numbers: a green number for an added line and a red line where lines were removed;
  • Preview, for Markdown, images, PDF files, Word documents (.docx), PowerPoint decks (.pptx), and Excel workbooks (.xlsx, .xlsm).

In Source and Preview, Show details at the top right of the file has Download, which saves the file to your device, including a large or binary file that Caffold cannot show.

On a phone, the file list and the file take turns on the screen; Back returns from the file to the list.

Act on what you found

Go back to Conversation and tell the agent what comes next: a fix for what you found, or a commit. For example:

Commit these changes with a message that explains why.

To compare any two refs or read the commit history, see Git.