Use case
Review a pull request properly, from your phone
You have ten minutes away from the desk. The pull request needs more than a skim, and a useful review depends on running the code.
What you do
- Open Pull requests. PRCHD reads the list and full PR details through the
ghCLI already signed in on your Mac. - Choose Review PR. Pick the agent model and reasoning effort. You see the task before it starts.
- Let setup run. Your Mac fetches the pull request into a disposable worktree and runs the project setup script there.
- Follow it in Activity. The review appears under Running with elapsed and quiet-time cues. The phone does not need to stay open.
- Open the durable result. The agent can inspect files, build, and run tests in Work mode. PRCHD validates the structured findings after the agent finishes.
- Read the review that landed. The Mac posts one GitHub review: a verdict, a summary, and inline comments anchored to real changed lines.
What it relies on
This flow requires a GitHub remote and the gh CLI installed and authenticated on the Mac. PRCHD stores no GitHub token. It asks gh for repository state and owns the final write to GitHub itself.
The review runs in a disposable worktree rather than your checked-out branch. That gives the agent the actual project, toolchain, dependencies, and setup script without mixing review files into your current work. The worktree is removed when the task ends; the result stays in Activity.
Why posting is host-owned
The agent is explicitly told not to write to GitHub. It returns structured findings to the Mac instead. PRCHD repairs an invalid line anchor by moving the finding into the summary, guards against duplicate posting, and refuses to approve a self-review. One task produces one review, even if reconnect or restart reconciliation runs more than once.
What it does not do
It does not replace your judgment and it does not turn the phone into a GitHub administration console. The agent can still misunderstand a change or miss an important path. You read the result in GitHub and decide what happens next. PRCHD does not merge the teammate’s pull request as part of this review task.
If the Mac is unreachable, you cannot start a new review from an offline queue. A review already running continues on the Mac and reappears when you reconnect. Push is optional; when enabled, the Mac must be connected to the PRCHD notification service, and the notification contains no repository, PR, or comment text.
Keep the review on your machine
Use the toolchain already on your Mac, then read the review wherever you are.