What is GitHub?
GitHub is the world's largest code hosting platform. Engineering teams store not just code but also architecture decision records, runbooks, API references, and internal documentation in GitHub repositories.
How Kelu works with GitHub
Everything you can do once the integration is connected.
Selective path indexing
Kelu picks documentation files by convention: Markdown, MDX, reStructuredText, text, and README files. Optionally limit it to paths like docs/, README.md, ADRs/, or runbooks/.
Webhook auto-sync on push
Add a push webhook, verified with X-Hub-Signature-256. Every push triggers an incremental re-index — docs stay current without manual intervention. Without it, the repository is re-read every hour.
Self-hosted GitHub Enterprise
The GitHub integration supports GitHub Enterprise Server installations in addition to GitHub.com.
Branch-aware indexing
Configure which branch is indexed — main for stable docs, or a separate docs branch. Switch branches without re-configuring the integration.
How to set it up
- 01
In Kelu, add a GitHub Files source and enter the repository's owner and name, plus an access token for a private repository.
- 02
Optionally set the branch and include paths. Copy the webhook secret Kelu shows, then add a push webhook in the repository's settings.
- 03
The first sync starts right away. After that, the repository is re-read hourly, and on every push once the webhook is connected.
Got questions?
GitHub — Frequently Asked Questions
Common questions about connecting Kelu to GitHub.
Kelu re-reads the repository every hour. Add a push webhook, verified with X-Hub-Signature-256, and every push also triggers a re-index. Only the changed files are re-embedded, so syncs are fast even for large repositories.
Include paths takes path prefixes or file names, such as docs/, README.md, ADRs/, or runbooks/. Only matching documentation files are indexed. GitHub Files never indexes source code; add a GitHub Code source for that.
Yes. Kelu supports GitHub Enterprise Server in addition to GitHub.com. Set the API URL (for example https://github.example.com/api/v3) during source configuration, and API calls will route to your self-hosted instance.
Yes. A single Kelu knowledge base can have multiple GitHub sources, each pointing to a different repository or branch. All indexed content is searched together in a single RAG query, with citations identifying the source repository for each answer.
Yes. Kelu stores GitHub credentials encrypted at rest. Credentials are never logged or exposed in responses. You can revoke access at any time by revoking the access token in GitHub.
Ready to connect GitHub?
Start free, no credit card required. Connecting GitHub needs the Pro plan, which comes with a 14-day free trial.