Integration

GitHub

GitHub is where your code lives. Connecting it lets the agent read the repository, write a change on a branch, and open a pull request you review.

What it does

  • Reads the repositories you granted, so a Plan is written against your real files.
  • Writes a change on a branch and opens a pull request.
  • Reads test and check results, so you see whether a change passed before you merge.
  • Changes a workflow file when the Plan you approved calls for it.
  • Waits for you. The agent never ships code on its own, on any plan.

Connecting

In the app, open Workspace settings, then Connections, and choose GitHub. GitHub asks which repositories to grant, and you can pick one rather than all of them.

What each permission is for

  • Contents, read and write Read the code a Plan is written against, and commit the change on a branch.
  • Pull requests, read and write Open the pull request you review, and read its state back.
  • Workflows, read and write Change a GitHub Actions workflow file when the Plan you approved includes one.
  • Actions, read-only Read whether a workflow run passed.
  • Checks, read-only Read check results, so the review screen shows whether tests passed.
  • Commit statuses, read-only Read the status a check or a deploy reported on a commit.
  • Metadata, read-only Required by GitHub alongside the rest. It lists the repositories the installation can reach.

We do not ask for repository administration, Actions secrets, packages, or your organisation members. Nothing in a Build Run touches them. GitHub shows you the exact list on the install screen before you approve, and that screen is the authority: it is the grant, not this page.

How your credentials are held

This Connection stores no token. The installation id is the only thing kept, and every token is minted at the moment of use, scoped to a single repository, and revoked when the work finishes.

Removing it

Disconnect under Workspace settings, then Connections, and we uninstall the app at GitHub. You can also remove it at github.com/settings/installations, which ends our access immediately.

To have everything Selfbase holds about you deleted, see data deletion.

Support

Email hello@selfbase.com. Our privacy policy and terms cover every integration.