Docs

Getting started

1. Continue with GitHub. Diffbox asks for repository access so it can read pull requests and post your reviews.
2. Choose which repositories Diffbox should watch. Only these appear in your inbox.
3. You get a team automatically. Invite teammates from Settings → your team, and start the free trial from Settings → Billing to turn on change write-ups.

To add repositories or an organization later, open Settings → Repositories → Manage access on GitHub, choose what Diffbox may see, then press Refresh. You can do this at any time; there's no need to reconnect. Diffbox only uses repositories you've enabled, plus public pull requests you open by link.

The inbox

The inbox lists pull requests waiting on your review across your repositories, with views for your own pull requests, ones you've reviewed, and all of them. Use the filters, or paste a pull request link into the search box and press Enter to open it.

Diffbox analyzes pull requests in the background, so most open ready. Under each one, the inbox shows how many changes still need you, how many are high risk or missing from the description, and which changed since you last looked.

Reviewing a pull request

A pull request opens as a write-up, one section per change. Each change has:

• a title and a factual summary of what the code does, with the real names from the diff;
• a risk level and the concrete reason for it;
• a tag when the pull request's description doesn't mention it, which catches agents going beyond the task;
• the files it touches, and its diff a click away.

Mechanical changes such as generated files, whitespace, moved code, consistent renames and import-only edits are found by exact rules, not AI, and grouped at the end so they don't cost you attention.

Approve or flag each change. A flag takes a note, and your notes are added to the review you submit. Verdicts stay put across new pushes until that change's code changes; then it's marked “changed since you looked”.

You can still review file by file: switch to Files (or press m). Comment on any line, then submit your review as Comment, Approve or Request changes; it's posted to GitHub as you.

Keyboard shortcuts

Press ? in a pull request to see these at any time. In the inbox, j/k move, Enter opens, / searches and 1–4 switch views.

Teams, seats and billing

Diffbox is used and paid for as a team. Everyone gets a team when they sign up, and you can create more or be invited to others. Plans are priced per seat (see pricing), and team admins manage the plan, seats, payment method and invoices in Settings → Billing. Members see who to ask.

PR analyses

Writing up a new version of a pull request uses one analysis from your team's monthly allowance, which grows with each seat. Later pushes only send what changed, and a pull request a teammate already analyzed is free to open. The ring at the bottom of the sidebar shows how much of the allowance is used and when it resets.

If the allowance runs out, Diffbox keeps working: diffs, comments and reviews are unaffected, and changes are grouped by folder without write-ups until the allowance resets or you add seats.

Settings

Open settings from the sidebar. They cover:

• GitHub: the connected account; reconnect or disconnect.
• Repositories: which repositories Diffbox watches.
• Sound: interface sounds, volume and sound set, saved per device.
• Privacy: whether review data is shared to improve Diffbox. Turning it off deletes what was recorded. See the privacy policy.
• Account: profile, emails and sign-in, notifications, active sessions, and deleting your account.
• Teams: members, invitations, team details and leaving a team.