Setup
Install the Blitzy GitHub App
Navigate to Settings > Integrations in your Blitzy dashboard and click Connect GitHub. You will be redirected to GitHub to authorize the application.
Organization admins must install the Blitzy GitHub App before team members can connect repositories.
Granting Repository Access
If you initially selected specific repositories, you can add more later:- Go to GitHub Settings > Applications > Blitzy
- Click Configure next to the Blitzy application
- Scroll to Repository access
- Select Select repositories and add the repositories you want Blitzy to access
- Click Save
Permissions
The Blitzy GitHub App requires specific permissions scoped to the minimum level needed.| Permission | Access Level | Purpose |
|---|---|---|
| Actions | Read & Write | Trigger, monitor, and cancel workflow runs |
| Attestations API | Read & Write | Sign and verify build artifact provenance |
| Checks | Read & Write | Post check runs and status annotations on commits and PRs |
| Code | Read & Write | Clone repos, read files, create branches, and push commits |
| Codespaces | Read & Write | Launch and manage development environments for code generation |
| Codespaces metadata | Read | List available codespaces and their configuration |
| Commit statuses | Read & Write | Set pass/fail status indicators on individual commits |
| Custom properties for repositories | Read & Write | Read and update repository-level custom metadata fields |
| Dependabot alerts | Read | Surface known dependency vulnerabilities during code analysis |
| Deployments | Read & Write | Create deployments and update deployment status |
| Discussions | Read & Write | Create and respond to repository discussion threads |
| Environments | Read & Write | Configure deployment targets and environment protection rules |
| Issues | Read & Write | Open, update, close, and comment on issues |
| Merge queues | Read & Write | Add and remove pull requests from merge queues |
| Metadata | Read | Discover repositories, branches, and collaborators |
| Packages | Read & Write | Publish and install GitHub Packages artifacts |
| Pages | Read & Write | Configure and deploy GitHub Pages sites |
| Pull requests | Read & Write | Open, update, close, and review pull requests |
| Repository advisories | Read | Review security advisories tied to repository dependencies |
| Repository hooks | Read & Write | Register and manage webhook endpoints for event delivery |
| Secret scanning alerts | Read & Write | Triage and resolve detected secrets in code |
| Security events | Read & Write | Access code scanning and audit log security data |
| Workflows | Read & Write | Create and modify GitHub Actions workflow definition files |
Permission Mapping Reference
| Operation | Required Permission | Documentation |
|---|---|---|
| Create branch | Contents: write | Permissions Required for GitHub Apps |
| Create/push commits | Contents: write | Permissions Required for GitHub Apps |
| Create pull request | Pull requests: write | Create Pull Request |
| Close pull request | Pull requests: write | Update Pull Request |
| Push branches | Contents: write | Permissions Required for GitHub Apps |
| Clone repository | Contents: read | Permissions Required for GitHub Apps |
HTTP-based Git access (clone, push) requires Contents permission as documented in GitHub’s permissions guide.
Organization Repositories
Organization admins must install and approve the Blitzy GitHub App:- Verify you have admin access to the organization
- Install the app (organization owners may need to approve)
- Select which organization repositories to grant access
- Team members can then connect their accounts to access authorized repositories