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

# GitHub

> Connect GitHub so Squasher can link repositories and open pull requests for hosted fix runs.

Connect GitHub when you want Squasher to associate a project with one or more repositories and open fix pull requests from hosted auto-fix workflows.

## What you configure

* The repositories Squasher should use for the project.
* The primary repository and default base branch for pull requests.
* GitHub deployment, deployment status, and workflow events Squasher should associate with service releases when commit or release metadata is available.
* Any review workflow you want to pair with [auto-fix](/features/auto-fix).

## Setup

1. Open **Integrations** in the dashboard.
2. Connect GitHub for the account or organization that owns the repository.
3. Add the repositories that belong to the project.
4. Choose the primary repository and default branch for hosted fix pull requests.
5. Save the mapping and verify it matches your deployment workflow.

## Notes

* Repository mappings are project-specific and can include multiple repos.
* The primary repository is used when a workflow needs one default pull request target.
* Squasher creates reviewable pull requests; you stay in control of merging.

## Agent handoff

```text theme={null}
Review the GitHub integration for Squasher project <project_id>. List linked repositories and recent GitHub activity first, verify the primary repo and base branch, and ask before linking, unlinking, or starting hosted fix work.
```

Use `squasher integrations connect github`, `squasher github ...`, provider capability reads, or MCP `search("github")` and `search("providerCapabilities.github")`.