Skip to main content

Supercharge your Gerrit workflow with LLM-powered code reviews and fixes

Project description

clerrit

PyPI version

Supercharge your Gerrit Code Review workflow with LLM-powered code reviews and fixes!

clerrit is a CLI tool to match Gerrit Code Review and Claude Code.

The current features are, for a given change and patchset:

  • Review a Gerrit change using Claude Code, identifying bugs, security issues, edge cases, style problems, and missing error handling.

    This command only shows a code review report in Claude Code, helping you write your actual review comments on Gerrit. It doesn't send anything to Gerrit.

  • Address Gerrit code review comments by having Claude Code fix the issues based on reviewer feedback.

    Claude Code fixes the code locally without running git add, git commit, or such. It doesn't send anything to Gerrit.

clerrit is meant to assist reviewers and developers, not to replace them.

Try it now!

  • Make clerrit review the latest patchset of change 27362 using the review remote of the current Git repository:

    $ uvx clerrit review 27362 --md
    

    You'll end up in Claude Code performing a code review, providing raw Markdown comments for specific files and line numbers.

  • Make clerrit address the code review of the latest patchset of change 1189 using the review remote of the current Git repository:

    $ uvx clerrit fix 1189
    

    You'll end up in Claude Code fixing the code to address the review comments.

See clerrit --help to learn more.

What clerrit does

  • review command:

    1. Fetches the patchset from the Gerrit remote.

    2. Creates a temporary local branch with the change.

    3. Launches Claude Code with a prompt to analyze the latest commit for bugs, security issues, edge cases, style problems, and missing error handling.

    4. If a CONTRIBUTING* file exists, mentions it as context.

  • fix command:

    1. Fetches the patchset from the Gerrit remote.

    2. Creates a temporary local branch with the change.

    3. Queries the Gerrit server via SSH to retrieve all review comments for the patchset.

    4. Launches Claude Code with the comments and instructions to fix the reported issues (without staging, committing, or creating new files unless requested).

Examples

  • Review latest patchset of change 15753:

    $ clerrit review 15753
    
  • Review patchset 3 of change 15753:

    $ clerrit review 15753 3
    
  • Review with Markdown output for Gerrit comments:

    $ clerrit review 15753 --md
    
  • Review using a different remote instead of gerrit:

    $ clerrit review 15753 --remote=gerrit
    
  • Review with extra context for Claude:

    $ clerrit review 15753 --extra-prompt="Focus on memory safety."
    
  • Fix latest patchset based on review comments:

    $ clerrit fix 8472
    
  • Fix a specific patchset:

    $ clerrit fix 8472 2
    
  • Fix using a specific Claude model:

    $ clerrit fix 8472 --model=sonnet
    

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clerrit-0.1.2.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clerrit-0.1.2-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file clerrit-0.1.2.tar.gz.

File metadata

  • Download URL: clerrit-0.1.2.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.17

File hashes

Hashes for clerrit-0.1.2.tar.gz
Algorithm Hash digest
SHA256 5e75d08f3112685d8565ccc6869cfde467b7cb539f445832334d3809be032d54
MD5 09b2ceb90b60d43b0cf5381b6fee323a
BLAKE2b-256 b73a9e385f38853081e191631a3524658a6a34b9cb89b1b7f4939b059960357b

See more details on using hashes here.

File details

Details for the file clerrit-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: clerrit-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.17

File hashes

Hashes for clerrit-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 69752f02dcb4afd9bf5d6d0f3feb6543dde0eb7cbf873dc4b33f288a373c147e
MD5 617bf2f4c10f941a992abfc76f0723a4
BLAKE2b-256 d898ebe3501bd573bf8ff86192da4e5219cc3127a831edc89c1f0be19f748e67

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page