AI-powered code reviews for every pull request

Kitsu is your open-source AI PR reviewer for GitHub. It reads a pull request patch, posts inline review comments for actionable findings, and falls back to a general PR comment when a finding cannot be placed safely in the diff.

SETUP GUIDE

Get up and running in minutes

1

Add your API key

Create a repository secret named KITSU_API_KEY that stores your provider API key.

2

Create the workflow

Create a GitHub workflow file with the configuration below.

3

Open a PR

Kitsu automatically reviews your pull requests and posts inline comments.

kitsu.yml
name: Kitsu AI Maintainer

on:
  pull_request:
    types: [opened]

jobs:
  run-kitsu:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Use Kitsu Action
        uses: Souvikns/kitsu@main
        with:
          provider: openai
          api_key: ${{ secrets.KITSU_API_KEY }}
          model: gpt-4o-mini
          github_token: ${{ secrets.GITHUB_TOKEN }}
FEATURES

Why use Kitsu?

Inline PR Comments

Posts actionable review comments directly on the relevant lines of code.

Fallback Comments

When a finding cannot be placed in the diff, it falls back to a general PR comment.

Multi-Provider Support

Works with OpenAI and Gemini. Choose the provider and model that fits your needs.

Open Source

Fully open source and free. Self-host or fork to customize for your workflow.