GitHub Integration

PushBackLog integrates with GitHub via the PushBackLog GitHub App. Once connected, AI Pods can clone repositories, push commits, open pull requests, and respond to PR events — all without storing long-lived credentials.

How It Works

PushBackLog uses a GitHub App (not a personal OAuth token) for repository access. This means:

• Access is installation-scoped — PBL can only access the repositories you explicitly grant it
• Tokens are short-lived and automatically refreshed
• Your organisation’s GitHub audit log shows PushBackLog (not a personal account) for all operations
• You can revoke access at any time by uninstalling the GitHub App from your GitHub settings

Connecting GitHub

1. Go to Settings → GitHub in the sidebar.
2. Click Connect GitHub.
3. You will be redirected to GitHub to install the PushBackLog GitHub App.
4. Select the repositories you want PushBackLog to have access to (you can choose all repositories in your account/organisation, or specific repositories only).
5. Click Install & Authorize.
6. You are redirected back to PushBackLog with a success confirmation.

Associating Repositories with Projects

After connecting, you can associate specific repositories with specific PushBackLog projects:

1. On the GitHub settings page, the list of accessible repositories is shown.
2. For each repository, select the PushBackLog project it belongs to from the dropdown.
3. Click Save for that repository.

An AI Pod dispatched against a project will use the associated repository as its codebase target.

Disconnecting GitHub

Currently, disconnection is managed from your GitHub account directly:

1. Go to your GitHub account Settings → Applications → Installed GitHub Apps.
2. Find the PushBackLog app and click Configure or Uninstall.
3. Uninstalling removes PushBackLog’s access to all repositories immediately.

Troubleshooting

“GitHub App not configured” — the administrator has not yet connected GitHub for this organisation. Ask your Admin to complete the setup.

“Connection cancelled” — you cancelled the GitHub App installation on the GitHub side. Click Connect GitHub again to retry.

“Invalid state / connection expired” — the connection request timed out (10-minute window). Click Connect GitHub again to start a fresh request.

Repos not appearing — ensure the GitHub App installation includes the expected repository. Go to GitHub → Your account → Settings → Applications → PushBackLog → Configure, and verify the repo list.

Security Notes

• PushBackLog never stores your GitHub personal access token or password.
• Installation access tokens are short-lived (1 hour) and scoped to the selected repositories only.
• All git operations use HTTPS with these tokens — no SSH keys are generated or stored.
• Tokens are refreshed automatically at runtime; no manual rotation is needed.