Skip to main content
Setting up Kodus on GitHub takes a few minutes. Once connected, every pull request gets reviewed automatically.

Steps

  1. Create an account at kodus.io or self-host Kodus
  2. Connect GitHub — install the Kodus GitHub App when prompted during setup
  3. Select repositories — choose which repositories Kodus should review
  4. Open a PR — Kodus reviews it automatically and posts comments

What you get

  • Automated reviews on every PR (or on-demand with @kody start-review)
  • Comments posted directly in the PR with code suggestions
  • Customizable rules, severity filters, and suggestion limits
  • Business logic validation against linked tasks

Custom configuration

Drop a kodus-config.yml in your repo root to customize behavior per repository. The file overrides web settings automatically.

Using a Personal Access Token

For private repositories or organizations with stricter permissions, you may need to configure a GitHub Personal Access Token (PAT). For the full setup guide, see Quickstart and GitHub App setup.