Connecting GitHub
Install the app on the repository, so the coding agent's fixes can merge on their own.
GitHub is the first row of a project's Settings › GitHub & coding agent, above the agent that works on it. Broken Here uses it only to review and merge the pull requests the coding agent opens. Reports do not become GitHub issues; tickets go to Notion or Linear.
Install the app
Under GitHub & coding agent, press Connect GitHub. GitHub asks which repositories to share with the Broken Here app; tick the one the agent works on. It then asks you to authorize the app, so we can tell the installation is yours rather than a number somebody typed into a link. That is the whole setup. You paste nothing and we store no token. Our access comes from the installation, limited to the repositories you ticked, and uninstalling the app on GitHub ends it.
An installation belongs to one Broken Here workspace. Every project in that workspace can use it.
Back on GitHub & coding agent, choose the repository from the list. The coding agent below it works on the same repository. Once GitHub has one, the agent's row shows it instead of asking again. A pull request anywhere else is never merged.
What the app may do, and why:
- Contents: write and Pull requests: write: the merge.
- Commit statuses: read and Checks: read: naming a failed check on the pull request straight away.
- Deployments: read: which commit a preview's address serves, so a bug reported on a preview is handed to the agent on that preview's branch. An installation made before this permission existed asks you to accept it on GitHub; until then, the agent starts from your default branch.
- Pull request, check suite and status events: GitHub tells us the moment the agent's pull request opens, whoever opened it, so the review starts then, and the moment its checks finish, so an approved change merges then.
It reads only the changes in the pull requests the agent opens, and it touches no repository you did not tick.
Turning on automatic merging
The switch that puts all this to use, Merge the agent's trivial fixes on this project without waiting for a review, is in the project's Settings › Auto-merge. That section lists what is still missing before anything can merge, with a link to where each is fixed. Automatic merging is on the Team and Agency plans. The coding agent page describes the switch and its gates.