Installing the GitHub App
Sign in with GitHub
Go to app.detail.dev and sign in using GitHub OAuth.
Install the Detail GitHub App
After signing in, you’ll be prompted to install the Detail GitHub App on your account or organization. Click Install.
Select repositories
Choose which repositories you want Detail to access. You can start with a single repository and expand later — you don’t need to grant access to everything upfront.
Permissions Detail requests
Detail requests the minimum permissions needed to scan your code and open fix PRs.| Permission | Access | Purpose |
|---|---|---|
| Code | Read | Scan repository contents for bugs, security issues, dead code, and documentation drift |
| Commits | Read | Associate findings with the commit that introduced them |
| Pull requests | Read | Read CI check results on existing PRs |
| Pull requests | Write | Open automated fix PRs from Dead Code, Doc Fixes, and Pass-CI agents |
| Webhooks | — | Listen for push events, PR events, and check suite completions |
Adding or removing repositories
You can adjust which repositories Detail can access at any time through two paths:- Via GitHub: Go to GitHub → Settings → Applications → Detail and modify the repository list under Repository access.
- Via Detail: Go to Settings → Repositories in the Detail dashboard, then click Add Repository or Remove from Detail.
Changes to GitHub App permissions take effect immediately. If you add a new repository, Detail will schedule an initial scan automatically.
GitHub Enterprise Server
Detail supports GitHub Enterprise Server (GHE) for teams on self-hosted GitHub installations. Because GHE requires a custom GitHub App registration against your own hostname, this is handled on a per-organization basis. Contact the Detail team at [email protected] to configure a custom GitHub App for your GHE instance.How automated pull requests work
When Detail’s Dead Code or Doc Fixes agents produce changes, they open a pull request in your GitHub repository just like any human contributor would. The PR includes a description of what was changed and why. Pass-CI agent: If CI checks fail on a Detail-created PR, the Pass-CI agent reads the failure logs and pushes a corrective commit to the same branch automatically — without any manual intervention from you.Detail never pushes directly to your main or default branch. Every change — including Pass-CI fix commits — goes through a pull request that you can review, request changes on, or close.