GitHub App
Pharaoh needs read-only access to your repos to build the knowledge graph. This is the first step before connecting any AI tool.
Install
Click Install
Choose your organization or personal account
Select All repositories or pick specific repos
Click Install
Pharaoh requests two permissions:
Repository contents (read) - to parse code structure
Repository metadata (read) - to detect pushes and branches
It cannot write to your repos, push commits, or modify code.
What happens after install
Pharaoh clones each selected repo using read-only installation tokens, parses the code with tree-sitter, builds a Neo4j knowledge graph of the architecture, and discards the source code.
This takes 1-3 minutes per repo depending on size. The graph contains function names, file paths, dependencies, complexity scores, and entry points. No source code is stored.
The graph re-maps automatically on every push to your default branch via webhooks. No maintenance required.
Managing repos
To add or remove repos after install:
Go to GitHub > Settings > Applications > Pharaoh
Click Configure
Change repository access
Changes take effect within minutes. Added repos are mapped. Removed repos are purged from the graph.
Next step
Connect your AI tool: Claude Code | Claude.ai | Cursor | Windsurf | OpenClaw | Headless
Last updated