AI Code Review with Full Control Over Model Choice and Costs.
$git clone https://github.com/kodustech/kodus-aiInstalls into the current project.
Install kodus-ai by running `git clone https://github.com/kodustech/kodus-ai`, then use it for the current task and follow its documentation at https://github.com/kodustech/kodus-ai.
| 1 | <p align="center"> |
| 2 | <img alt="koduslogo" src="https://kodus.io/wp-content/uploads/2026/06/kodus-thumb-git-scaled.png"> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="http://makeapullrequest.com"> |
| 7 | <img alt="PRs Welcome" src="https://img.shields.io/badge/PRs-welcome-darkgreen.svg?style=shields" /> |
| 8 | </a> |
| 9 | <a href="https://github.com/kodustech/kodus-ai" target="_blank"> |
| 10 | <img src="https://img.shields.io/github/stars/kodustech/kodus-ai" alt="Github Stars" /> |
| 11 | </a> |
| 12 | <a href="./license.md"> |
| 13 | <img src="https://img.shields.io/badge/license-AGPLv3-red" alt="License" /> |
| 14 | </a> |
| 15 | </p> |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | <p align="center"> |
| 20 | <a href="https://kodus.io">Website</a> · |
| 21 | <a href="https://discord.gg/6WbWrRbsH7">Community</a> · |
| 22 | <a href="https://docs.kodus.io">Docs</a> · |
| 23 | <a href="https://docs.kodus.io/how_to_use/en/cli/overview">CLI Docs</a> · |
| 24 | <strong><a href="https://app.kodus.io">Try Kodus Cloud </a></strong> · |
| 25 | <strong><a href="https://docs.kodus.io/how_to_deploy/en/deploy_kodus/generic_vm">Self-Host Guide</a></strong> |
| 26 | </p> |
| 27 | |
| 28 | <p align="center"> |
| 29 | 🌐 |
| 30 | <a href="./README.md">English</a> · |
| 31 | <a href="./README.pt-BR.md">Português (BR)</a> · |
| 32 | <a href="./README.es.md">Español</a> · |
| 33 | <a href="./README.ja.md">日本語</a> · |
| 34 | <a href="./README.zh-CN.md">简体中文</a> · |
| 35 | <a href="./README.fr.md">Français</a> |
| 36 | </p> |
| 37 | |
| 38 | ## Why Teams Choose Kodus |
| 39 | |
| 40 | - **Model Agnostic**: Use Claude, GPT-5, Gemini, Llama, GLM, Kimi or any OpenAI-compatible endpoint. |
| 41 | - **Zero Markup on LLM Costs**: You pay model providers directly. No hidden multipliers. |
| 42 | - **Learns from Your Context**: Kody adapts to your architecture, standards, and workflow. |
| 43 | - **You Set the Rules**: Define custom review rules in plain language. |
| 44 | - **Privacy & Security**: Source code is not used to train models, data is encrypted in transit and at rest, and self-hosted runners are supported. Self-hosted instances send one anonymous heartbeat per day (aggregated counters only — no code, names, or identifiers); opt out with `KODUS_TELEMETRY_DISABLED=true`. See [Anonymous Telemetry](https://docs.kodus.io/how_to_deploy/en/deploy_kodus/telemetry). |
| 45 | - **Native Git Workflow**: Works directly in PRs with GitHub, GitLab, Bitbucket, and Azure Repos. |
| 46 | - **CLI + CI/CD Ready**: Run reviews locally and in pipelines. |
| 47 | - **Operational Impact**: Track technical debt and delivery metrics while keeping review quality high. |
| 48 | |
| 49 | ## Product Highlights |
| 50 | |
| 51 | <details> |
| 52 | <summary><strong>🔑 Bring Your Own Key</strong></summary> |
| 53 | <br /> |
| 54 | Connect your own provider credentials and choose the models behind Kodus reviews: OpenAI, Anthropic, Google Gemini, Vertex AI, Novita, or any OpenAI-compatible endpoint. Keep billing and usage under your own provider account, without hidden LLM markups. |
| 55 | |
| 56 | <br /> |
| 57 | <br /> |
| 58 | |
| 59 | <p align="center"> |
| 60 | <img src="https://kodus.io/wp-content/uploads/2026/06/byok-scaled.png" alt="Kodus BYOK model provider configuration" width="900"> |
| 61 | </p> |
| 62 | |
| 63 | </details> |
| 64 | |
| 65 | <br /> |
| 66 | |
| 67 | <details> |
| 68 | <summary><strong>📈 Token Usage</strong></summary> |
| 69 | <br /> |
| 70 | Track token consumption across AI code reviews, understand cost drivers, and keep model spend predictable as adoption grows. |
| 71 | |
| 72 | <br /> |
| 73 | <br /> |
| 74 | |
| 75 | <p align="center"> |
| 76 | <img src="https://kodus.io/wp-content/uploads/2026/06/token-usage-scaled.png" alt="Kodus token usage dashboard" width="900"> |
| 77 | </p> |
| 78 | |
| 79 | </details> |
| 80 | |
| 81 | <br /> |
| 82 | |
| 83 | <details> |
| 84 | <summary><strong>⚙️ Kody Rules</strong></summary> |
| 85 | <br /> |
| 86 | Kody Rules let teams define review instructions in plain language and apply them across organizations, repositories, paths, or specific review scopes. Kody uses those rules as context when reviewing pull requests, helping enforce architecture decisions, security expectations, testing practices, and repository-specific conventions without relying on reviewers to repeat the same feedback manually. |
| 87 | |
| 88 | <br /> |
| 89 | <br /> |
| 90 | |
| 91 | <p align="center"> |
| 92 | <img src="https://kodus.io/wp-content/uploads/2026/06/rules-scaled.png" alt="Kody rules" width="900"> |
| 93 | </p> |
| 94 | </details> |
| 95 | <br /> |
| 96 | <details> |
| 97 | <summary><strong>📊 Cockpit</strong></summary> |
| 98 | <br /> |
| 99 | Coc |