# Connect GitHub

Connect **GitHub**, and your apps can work with your repositories, issues, and pull requests as you. The agent builds the app with GitHub wired in, and the app signs you in the first time you use a feature that needs it. It's the foundation for any app that needs to do something with your GitHub data.

## Connect GitHub

You add GitHub to your app while building it. Signing in happens later, in the running app, and it's always you who authorizes it, never the agent.

1. **Open the Integration menu**: In the **Agent Chat**, click **the Plus button** in the composer and click ** Integration**.
2. **Choose GitHub**: Select **GitHub** from the list of built-in connectors. Glaze uses a ready-made GitHub preset, so there's nothing to register and no credentials to paste.
3. **Build with it**: Describe how you want to use GitHub in your app and the agent builds the feature.
4. **Sign in when you use it**: The first time you use a feature that needs GitHub in your app, the app opens GitHub's authorization page in your browser. Sign in, review what's being requested, and approve. GitHub hands back to the app, which acts as you from then on.

> [!NOTE]
> The agent doesn't sign you in or hold your credentials. It builds the app with GitHub wired in; you authorize GitHub yourself, in the running app, the first time you use it.

## Permissions You Grant

When you sign in, GitHub shows its OAuth authorization screen, which you approve before your app can use any of your GitHub data. If your app only reads public data, you may not need to sign in at all; GitHub asks you to authorize only when the app needs your identity, your private data, or the ability to act on your behalf.

## Using GitHub in a Prompt

With GitHub added to your app, describe what you want in plain language and the agent builds it:
- Show my open pull requests across all my repositories, grouped by repo.
- Create a dashboard of issues assigned to me, with a button to open each on GitHub.
- Let me file a new issue in a repository I pick from a dropdown.

> [!NOTE]
> GitHub is connected per project, so each app you build gets its own connection, which keeps each app's access scoped to what it actually needs.

## Managing the Connection

To re-authorize or revoke GitHub access later, see [Managing Connections](/integrations/managing-connections). Your access token is stored encrypted on your Mac, protected by the Keychain, never in plain text. See [Glaze Privacy & Data](/account/privacy-and-data) to learn more.
