> ## Documentation Index
> Fetch the complete documentation index at: https://docs.observerbee.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Connect GitHub so agents can open pull requests for proposed code changes.

The GitHub integration lets Observerbee's engineer [agents](/concepts/agents-and-governance) turn approved proposals into pull requests in your repositories.

## What it is used for

* **Pull request creation.** When an agent's proposed code change is approved, the work runs in an isolated sandbox and the result is opened as a pull request in the target repository. Agents never push to branches directly; your team reviews and merges like any other contribution.

## Connecting

1. Open the [Observerbee Dashboard](https://app.observerbee.com) and go to the **Integrations** page.
2. Choose **GitHub** and click connect.
3. Complete the OAuth flow, granting access to the repositories you want Observerbee to open pull requests against.

## Security

* OAuth tokens are stored AES-GCM encrypted and are only ever used server-side by a credential proxy.
* Agents never see the token. They receive a 30-minute capability token scoped to the approved action; the proxy injects the real credential when the request is made. See [Agents and governance](/concepts/agents-and-governance).
* Opening a pull request is a high-impact action. Unless an agent's autonomy explicitly allows it, it goes through the Actions approval queue first.