GitHub App
The recommended integration for GitHub-hosted repositories.
Kontrua uses a GitHub App rather than a personal access token. This means the integration is tied to your organisation (not a personal account), permissions are scoped precisely, and tokens rotate automatically.
Installation
Install the app
Go to Dashboard - Settings - Integrations and click Install GitHub App. You will be redirected to GitHub to select which repositories to grant access to. You can grant access to all repositories in an organisation or pick specific ones.Repository sync
After installation, Kontrua immediately syncs all accessible repositories. They appear under your dashboard within seconds.Configure each repo
Open a repository in the dashboard and set the watch branch. Context artifacts (AGENTS.md, codemap, conventions) are enabled by default; adjust them and the doc views as needed. Kontrua starts maintaining the context on the next qualifying event.
Permissions requested
| Permission | Level | Why |
|---|---|---|
| Contents | Read | Read source files and existing context artifacts and docs |
| Pull requests | Read/Write | Open context PRs and post progress comments |
| Metadata | Read | List repositories and branches |
Trigger
By default Kontrua fires when a pull request targeting your watch branch is approved. PR approval is the moment your repo's context goes stale, so the context update generates while the PR is still open and can be reviewed alongside the code change.
You can change the trigger to PR merged or manual only in the repository configuration panel.
PR comments
Kontrua posts a comment to the source PR when a run starts and links to the generated context PR when the run completes. On first run it notes that generation may take a few extra seconds as the model builds context for your repository.
Ready to keep your repo's context current?
Connect your first repository and Kontrua opens a reviewed PR with AGENTS.md, a codemap, and your conventions.