Review a git diff on your iPhone

The agent changed twelve files. Four of them deserve to land. Deciding which is a review — and a review needs a real diff, not a wall of terminal text.

Where the changes are

An agent's work sits uncommitted in the working tree on your Mac. That rules out two common phone tools: a pull-request app only sees what has already been pushed, and a git client with its own clone on the phone does not see your Mac's working tree at all. The diff you want to review lives on the Mac.

Reviewing it with ShiftStage

The real diff of the Mac's repository: syntax colour, changes marked inside the line, counts per file.
Stage line by line — take the four files that deserve to land, or just some lines of them.
Commit and push from the phone; history and branches are there too.
Ask for a fix in the same agent session if something is off, then read the new diff.

Nothing is cloned to the phone and nothing goes through a server of ours: the phone reads the repository on your Mac over an end-to-end encrypted connection.

A habit that makes phone review work

Give each agent task its own git worktree (git worktree add ../app-task-x) and ask the agent to finish with a one-paragraph summary. Then each review on the phone is one branch, one story, one diff.

Set it up once

Install the agent on the Mac. A signed, notarised app from our open Homebrew tap. It shares only the folders you name.
```
brew install --cask shiftstage/shiftstage/shiftstage-agent
```
Install the app on the iPhone from the App Store.
Pair them. Scan the code on the Mac's screen and confirm the same words on both devices. No account. The first pairing needs both on the same network.

That is the whole setup: no VPN, no port forwarding, no SSH keys. On the same Wi-Fi the phone talks to the Mac directly; away from home the connection goes peer to peer, or through a relay that forwards only end-to-end encrypted bytes.

Get it

The Mac agent: download page — one Homebrew command or a notarised disk image. The iPhone app: App Store. Free forever for one Mac on your own network, no account; $7.99 a month or $69.99 a year to reach it from anywhere.

More guides: all guides.