https://github.com/nayjest/gito
An AI-powered GitHub code review tool that uses LLMs to detect high-confidence, high-impact issues—such as security vulnerabilities, bugs, and maintainability concerns.
https://github.com/nayjest/gito
ai code-analysis code-review github github-actions llm
Last synced: 13 days ago
JSON representation
An AI-powered GitHub code review tool that uses LLMs to detect high-confidence, high-impact issues—such as security vulnerabilities, bugs, and maintainability concerns.
- Host: GitHub
- URL: https://github.com/nayjest/gito
- Owner: Nayjest
- License: mit
- Created: 2025-04-30T10:49:12.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T01:17:03.000Z (7 months ago)
- Last Synced: 2025-06-17T01:33:46.037Z (7 months ago)
- Topics: ai, code-analysis, code-review, github, github-actions, llm
- Language: Python
- Homepage:
- Size: 350 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
**Gito** is an open-source **AI code reviewer** that works with any language model provider.
It detects issues in GitHub pull requests or local codebase changes—instantly, reliably, and without vendor lock-in.
Get consistent, thorough code reviews in seconds—no waiting for human availability.
## 📋 Table of Contents
- [Why Gito?](#-why-gito)
- [Perfect For](#-perfect-for)
- [Quickstart](#-quickstart)
- [1. Review Pull Requests via GitHub Actions](#1-review-pull-requests-via-github-actions)
- [2. Running Code Analysis Locally](#2-running-code-analysis-locally)
- [Configuration](#-configuration)
- [Guides & Reference](#-guides--reference)
- [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md) ↗
- [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md) ↗
- [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) ↗
- Integrations
- [Linear Integration](https://github.com/Nayjest/Gito/blob/main/documentation/linear_integration.md) ↗
- [Atlassian Jira Integration](https://github.com/Nayjest/Gito/blob/main/documentation/jira_integration.md) ↗
- [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md) ↗
- [Documentation generation with Gito](https://github.com/Nayjest/Gito/blob/main/documentation/documentation_generation.md) ↗
- [Development Setup](#-development-setup)
- [Contributing](#-contributing)
- [License](#-license)
## ✨ Why Gito?
- [⚡] **Lightning Fast:** Get detailed code reviews in seconds, not days — powered by parallelized LLM processing
- [🔧] **Vendor Agnostic:** Works with any language model provider (OpenAI, Anthropic, Google, local models, etc.)
- [🌐] **Universal:** Supports all major programming languages and frameworks
- [🔍] **Comprehensive Analysis:** Detect issues across security, performance, maintainability, best practices, and much more
- [📈] **Consistent Quality:** Never tired, never biased—consistent review quality every time
- [🚀] **Easy Integration:** Automatically reviews pull requests via GitHub Actions and posts results as PR comments
- [🎛️] **Infinitely Flexible:** Adapt to any project's standards—configure review rules, severity levels, and focus areas, build custom workflows
## 🎯 Perfect For
- Solo developers who want expert-level code review without the wait
- Teams looking to catch issues before human review
- Open source projects maintaining high code quality at scale
- CI/CD pipelines requiring automated quality gates
✨ See [code review in action](https://github.com/Nayjest/Gito/pull/99) ✨
## 🚀 Quickstart
### 1. Review Pull Requests via GitHub Actions
Create a `.github/workflows/gito-code-review.yml` file:
```yaml
name: "Gito: AI Code Review"
on:
pull_request:
types: [opened, synchronize, reopened]
workflow_dispatch:
inputs:
pr_number:
description: "Pull Request number"
required: true
jobs:
review:
runs-on: ubuntu-latest
permissions: { contents: read, pull-requests: write } # 'write' for leaving the summary comment
steps:
- uses: actions/checkout@v6
with: { fetch-depth: 0 }
- name: Set up Python
uses: actions/setup-python@v6
with: { python-version: "3.13" }
- name: Install AI Code Review tool
run: pip install gito.bot~=3.5
- name: Run AI code analysis
env:
LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
LLM_API_TYPE: openai
MODEL: "gpt-5.2"
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
PR_NUMBER_FROM_WORKFLOW_DISPATCH: ${{ github.event.inputs.pr_number }}
run: |
gito --verbose review
gito github-comment --token ${{ secrets.GITHUB_TOKEN }}
- uses: actions/upload-artifact@v6
with:
name: ai-code-review-results
path: |
code-review-report.md
code-review-report.json
```
> ⚠️ Make sure to add `LLM_API_KEY` to your repository's GitHub secrets.
💪 Done!
PRs to your repository will now receive AI code reviews automatically. ✨
See [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) for more details.
### 2. Running Code Analysis Locally
#### Initial Local Setup
**Prerequisites:** [Python](https://www.python.org/downloads/) 3.11 / 3.12 / 3.13
**Step 1:** Install [gito.bot](https://github.com/Nayjest/Gito) using [pip](https://en.wikipedia.org/wiki/Pip_(package_manager)).
```bash
pip install gito.bot
```
> **Troubleshooting:**
> pip may also be available via cli as `pip3` depending on your Python installation.
**Step 2:** Perform initial setup
The following command will perform one-time setup using an interactive wizard.
You will be prompted to enter LLM configuration details (API type, API key, etc).
Configuration will be saved to `~/.gito/.env`.
```bash
gito setup
```
> **Troubleshooting:**
> On some systems, `gito` command may not become available immediately after installation.
> Try restarting your terminal or running `python -m gito` instead.
#### Perform your first AI code review locally
**Step 1:** Navigate to your repository root directory.
**Step 2:** Switch to the branch you want to review.
**Step 3:** Run following command
```bash
gito review
```
> **Note:** This will analyze the current branch against the repository main branch by default.
> Files that are not staged for commit will be ignored.
> See `gito --help` for more options.
**Reviewing remote repository**
```bash
gito remote git@github.com:owner/repo.git ..
```
Use interactive help for details:
```bash
gito remote --help
```
## 🔧 Configuration
Change behavior via `.gito/config.toml`:
- Prompt templates, filtering and post-processing using Python code snippets
- Tagging, severity, and confidence settings
- Custom AI awards for developer brilliance
- Output customization
You can override the default config by placing `.gito/config.toml` in your repo root.
See default configuration [here](https://github.com/Nayjest/Gito/blob/main/gito/config.toml).
More details can be found in [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
## 📚 Guides & Reference
For more detailed information, check out these articles:
- [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md)
- [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
- [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md)
- Integrations
- [Linear Integration](https://github.com/Nayjest/Gito/blob/main/documentation/linear_integration.md)
- [Atlassian Jira Integration](https://github.com/Nayjest/Gito/blob/main/documentation/jira_integration.md)
- [Documentation generation with Gito](https://github.com/Nayjest/Gito/blob/main/documentation/documentation_generation.md)
- [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md)
Or browse all documentation in the [`/documentation`](https://github.com/Nayjest/Gito/tree/main/documentation) directory.
## 💻 Development Setup
Install dependencies:
```bash
make install
```
Format code and check style:
```bash
make black
make cs
```
Run tests:
```bash
pytest
```
## 🤝 Contributing
**Looking for a specific feature or having trouble?**
Contributions are welcome! ❤️
See [CONTRIBUTING.md](https://github.com/Nayjest/Gito/blob/main/CONTRIBUTING.md) for details.
## 📝 License
Licensed under the [MIT License](https://github.com/Nayjest/Gito/blob/main/LICENSE).
© 2025–2026 [Vitalii Stepanenko](mailto:mail@vitaliy.in)