Guides
Review Changes
See what an agent changed in its last turn, in its whole session, or since the last commit. Read each diff on your phone.
The Changes view shows the files an agent changed, and opens each one as a diff. It works on the worktree of the Pane you have open.
Open Changes
- Open a Pane.
- Tap ⋯ in the top right corner, then Changes.
You can also swipe left from the right edge of the screen. The Files drawer opens where you left it. To close it, drag it to the right, or tap the close button.
Pick What to Compare
The bar at the top of Changes has three choices:
| Choice | Shows |
|---|---|
| Last turn | Only what the agent changed since it last started work. |
| Session | Every change in the agent’s session, turn after turn. |
| Uncommitted | Everything since the last commit: staged, not staged and new files, like git diff HEAD. |
A line under the bar tells you when the turn or the session started.
Last turn and Session need the daemon on the host. The daemon saves a snapshot of the worktree each time an agent goes to working. A blocked agent stays in the same turn, so a turn diff keeps the changes it made before it asked you.
Uncommitted needs only git. pocketty reads it without changing the repo: your index and git status stay as they were.
Read a Diff
Tap a file to open its diff.
- Added lines are green, and removed lines are red. The words that changed are marked inside each line.
- Long runs of unchanged lines fold. Tap a fold to open it.
- The arrows at the bottom go to the Previous change and the Next change.
- Wrap lines in the top bar wraps long lines, or lets them scroll sideways.
- On iPad, a diff shows side by side.
The code colors come from Settings → Files → Color Scheme.
Copy
Use the copy button in the top bar of a diff:
- Copy path: the path from the root of the repo.
- Copy full path: the path on the host.
- Copy diff: the change as a unified patch, ready for
git apply.
Hold a line of a diff to copy that line. Hold a file in the list to copy its path.
Commits
The Commits view lists the last 30 commits, newest first. Tap a commit to see its changes. In a commit, the folder button shows the files as they were at that commit, in the file browser.
When There Is Nothing to Show
- pocketty is not on this host: install the daemon for Last turn and Session. Uncommitted works without it.
- Update pocketty: the daemon on the host is too old for turn diffs. Update it.
- No turn yet: no agent has worked in this Pane since the daemon started.
- No Changes view: the Pane’s folder is not in a git repo. The Files view still works.