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

> ## Agent Instructions
> Agents: start with https://docs.pre.dev/agents.md, which has complete recipes, plan access, polling rules, errors and limits.
> Authenticate with the workspace API key (pdk_…) from Integrations → Built-in, sent as Authorization: Bearer <key>.
> REST API: https://api.pre.dev (OpenAPI: https://docs.pre.dev/api-reference/openapi.json). AI Gateway: https://api.pre.dev/v1, OpenAI-compatible (OpenAPI: https://docs.pre.dev/api-reference/ai-gateway.openapi.json).
> pre.dev MCP server: npx -y @predotdev/mcp setup adds it to every local coding agent with every pre.dev tool plus the user's own Chrome; the hosted server is https://api.pre.dev/mcp. Search these docs over MCP at https://docs.pre.dev/mcp.

# GitHub integration

> Connect the right GitHub account, import code, and review branch changes.

Use GitHub to import a repository, keep hosted project code in a repository, and review changes through branches and pull requests.

## Select the account

Connect GitHub in **Project setup → Connections** or workspace Integrations. Complete GitHub's authorization flow with access to the repositories you need.

A workspace can connect multiple GitHub accounts. In the project, select a specific account or inherit the workspace default. Team projects use team workspace connections. If a repository is missing, check the selected account, organization authorization, and repository permissions.

## Work with a repository

[Import a repo](https://predev.mintlify.site/coding-agent/projects/importing-repos.md) to start from existing code. For a new project, use the available GitHub connection and repository setup controls to link its code.

Additional hosted sessions require a connected GitHub project. Session branches keep parallel work separate until integration. Review the target branch and [merge behavior](https://predev.mintlify.site/coding-agent/building/pull-requests.md) before combining changes.

## Keep work synchronized

The Code and history views show repository information when available. After pushing changes outside pre.dev, use **Refresh from GitHub** when offered and confirm the active branch is current.

The CLI edits your local checkout; use its normal Git workflow to exchange code with GitHub. Sharing a pre.dev project record does not replace that synchronization.

If you rotate or disconnect an account, update affected project pins and confirm repository operations still work with the replacement connection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.