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

# Link GitHub

> Connect your GitHub account so Cake Agents can interact with GitHub on your behalf.

Link your GitHub account so Cake Agents can interact with GitHub on your behalf.

## What This Enables

After linking, Cake can use your GitHub identity within the permissions granted by the application and the GitHub App.

This is what enables workflows such as:

* opening pull requests
* pushing commits
* working with GitHub-backed repos and actions in sessions

## Link Flow

1. Start the GitHub link flow from settings.
2. Sign in to GitHub if needed.
3. Authorize the Cake Agents GitHub App.
4. Return to Cake Agents after the link succeeds.

## Troubleshooting

* If GitHub linking is unavailable, your administrator may not have finished the environment GitHub setup.
* If Cake cannot push or open PRs for you, reconnect GitHub.
* If your GitHub link stops working later, refresh or reconnect it from settings.

For commit identity, see [Set Git Author Info](./set-git-author-info).