> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to set up AI code review on GitLab

> Install and configure Kodus for GitLab projects to get automated AI code review on every merge request.

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

## Steps

1. **Create an account** at [kodus.io](https://kodus.io) or [self-host Kodus](/en/how_to_deploy/deploy_kodus/generic_vm)
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](/en/how_to_deploy/platforms/gitlab/gitlab_webhook) 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](/en/how_to_deploy/platforms/gitlab/gitlab_oauth) and [GitLab Webhooks](/en/how_to_deploy/platforms/gitlab/gitlab_webhook).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.