GitHub Integration
Use GitHub integration to let Dawn discover repositories, read code, inspect issues and pull requests, and use wiki content in agent workflows.
Before you start
- A GitHub account with access to the repositories Dawn should use.
- A GitHub personal access token with repository read access.
- The GitHub base URL. Use
https://github.comfor GitHub.com, or your GitHub Enterprise Server base URL if applicable.
Dawn currently connects to GitHub with a personal access token. It does not require a GitHub App install for this integration flow.
Create the personal access token
- Create a GitHub personal access token for the account Dawn should use.
- Grant read access to the repositories Dawn should discover.
- If you use a fine-grained token, include read access for repository metadata, contents, issues, and pull requests.
- If you use a classic token,
repois the usual starting point, andread:orgmay be needed for some organization visibility cases. - Copy the token and store it safely.
Connect GitHub in Dawn
- Open Integrations in Dawn and click Add connection.
- Choose GitHub.
- Paste the personal access token into Personal access token.
- Leave Base URL set to
https://github.comunless you are connecting GitHub Enterprise Server. - Click Connect.
- Review the discovered repositories and link the sources you want available in the workspace.
- Assign those linked sources to the agents that should use them.
What Dawn discovers
For each discovered repository, Dawn creates a repository source plus separate issue, pull request, and wiki sources. That lets you assign only the GitHub context an agent actually needs.
Troubleshooting
- Invalid token: the token is expired, revoked, or copied incorrectly.
- Repositories missing from discovery: the token account likely cannot see those repositories or has not completed required org authorization.
- Enterprise validation fails: use the web base URL for your GitHub Enterprise Server instance. Dawn derives the API route automatically.
Validation Prompts
Use these prompts in Dawn chat to quickly validate this setup area.
List connected GitHub sources and verify I can read PRs, issues, and files.
Run a repository access check and flag any unauthorized source bindings.
Completion Checklist
- GitHub credentials validated.
- Required repositories linked.
- PR/issue tools return expected data.
- File/tree browse works for selected repos.