clerrit 0.6.0

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

clerrit

clerrit is a CLI tool which bridges Gerrit Code Review with 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:

  $ clerrit review 18263
  

  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:

  $ clerrit fix 2439
  

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

  Your typical workflow after having reviewed the changes would be something like:

  $ git add -u
  $ git commit --amend --no-edit
  $ git review
  

  You can also use the --no-fetch option to avoid creating a new branch for the fix: just work in your current tree as is.

• Delete all local clerrit-* branches created by the review and fix commands:

  $ clerrit clean
  

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.

Examples

• Review latest patchset of change 15753:

  $ clerrit review 15753
  

• Review patchset 3 of change 15753:

  $ clerrit review 15753 3
  

• Review with raw Markdown output for Gerrit comments:

  $ clerrit review 15753 --md
  

• Review using a custom remote instead of the default review:

  $ clerrit review 15753 --remote=gerrit
  

• Review with extra context for Claude Code:

  $ clerrit review 15753 --extra-prompt='Focus on memory safety.'
  

• Fix the latest patchset, addressing the review comments of the last patchset:

  $ clerrit fix 8472
  

• Fix a specific patchset:

  $ clerrit fix 8472 2
  

• Fix the latest patchset, addressing the review comments of all the patchsets, and don't create a new branch:

  $ clerrit fix 8472 all --no-fetch
  

• Fix with extra context for Claude Code:

  $ clerrit fix 8472 --extra-prompt='Do NOT take into account the comments of Jérémie.'
  

• Fix using a specific Claude Code model:

  $ clerrit fix 8472 --model=sonnet
  

• Fix in YOLO mode:

  $ clerrit fix 8472 all --permission-mode=acceptEdits
  

• Clean up all local clerrit-* branches:

  $ clerrit clean
  

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.

     If a CONTRIBUTING.adoc, CONTRIBUTING.md, or CONTRIBUTING.rst file exists and there's no CLAUDE.md file, mentions it as context.

• fix command:

  1. Without the --no-fetch option:

     1. Fetches the patchset from the Gerrit remote.

     2. Creates a temporary local branch with the change.

  2. Queries the Gerrit server via SSH to retrieve all review comments for the patchset(s).

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

• clean command:

  • Finds all local branches matching clerrit-* and deletes them, skipping the current branch if applicable.