Skip to main content
Kodus integrates with GitLab via OAuth and webhooks. Once configured, merge requests are reviewed automatically.

​
Steps

  1. Create an account at kodus.io or self-host Kodus
  2. Connect GitLab — in the Connect your Git tool step of onboarding, click Install Gitlab app to authorize via OAuth, or Connect via token (you can also connect later from Repositories in the sidebar)
  3. Select projects — choose which GitLab projects Kodus should review
  4. Webhooks — Kodus registers the merge request webhook automatically when you save the selection. If that didn’t happen (for example on some self-hosted installs), add it manually with the GitLab Webhooks guide
  5. Open a merge request — Kodus reviews it automatically

​
What you get

  • Automated reviews on every MR
  • Comments posted directly in the merge request
  • Customizable rules, review categories, and a minimum severity threshold
  • Business logic validation against linked tasks

​
Custom configuration

Drop a kodus-config.yml in your repo root to customize behavior per project. The file overrides web settings once kodus Config File Overrides Web Preferences is on for that project (Code review → General). For the full setup guide, see GitLab OAuth and GitLab Webhooks.