> For the complete documentation index, see [llms.txt](https://pharaoh.so/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pharaoh.so/docs/connect/github-app.md).

# GitHub access

[Install Pharaoh](https://github.com/apps/pharaoh-so/installations/new) on the personal account or organization that owns your repositories. Choose all repositories or select individual ones, then continue to [setup](https://mcp.pharaoh.so/setup).

The app reads repository contents and metadata to build the map. It can publish GitHub check results; it cannot push commits or edit your files. GitHub displays the requested permissions before you authorize installation.

If a repository is missing, use “Choose repos on GitHub” in setup, grant access, then refresh. Organization installations may require an owner to approve access.

Each person connects their own AI client with GitHub. Authentication uses your numeric GitHub user ID; a username change does not change that ID. Repository transfers and access changes are separate from a username change.

See [security](/docs/use-pharaoh/security.md) for processing and storage details.