Skip to main content

An AI-powered Agent and CLI for Gerrit Code Review

Project description

🤖 Gerrit Agent

AI-Powered Code Review Assistant for Gerrit

PyPI version License: MIT Python 3.10+

Transform your Gerrit code reviews with AI-powered analysis using Claude Code, Gemini CLI, and other advanced Code Agents.

FeaturesQuick StartUsageDocumentationContributing


📖 Overview

Gerrit Agent is an AI-powered code review platform that integrates cutting-edge Code Agents (Claude Code, Gemini CLI, etc.) with Gerrit Code Review. It provides automated code analysis, intelligent inline comments, and multi-agent review workflows - all directly from your terminal.

Why Gerrit Agent?

  • 🧠 Multiple AI Agents: Use Claude, Gemini, or any Claude Agent Skill Protocol-compatible agent
  • 🎯 Smart Reviews: Multi-agent analysis with confidence scoring (only shows high-confidence findings ≥80%)
  • 💬 Inline Comments: Automatically posts structured feedback directly to Gerrit changes
  • Fast CLI: Modern, GitHub CLI-like interface for Gerrit operations
  • 🔌 Extensible: Built on open protocols, works with any compatible Code Agent

✨ Features

🤖 AI Agent Integrations:

  • Claude Code Skill (multi-agent review, confidence scoring)
  • Gemini CLI Extension (natural language reviews)
  • Compatible with Claude Agent Skill Protocol

💻 CLI Operations: List, view, checkout, review changes • Inline comments • JSON/Table output

🛡️ Developer-Friendly: HTTP token auth • Rich terminal UI • .env config • Comprehensive tests


🚀 Quick Start

Install:

pip install gerrit-agent-skill

Configure:

export GERRIT_URL=https://gerrit.example.com
export GERRIT_USERNAME=your_username
export GERRIT_TOKEN=your_http_token

Verify:

gerrit --help

🎯 Usage Modes

🤖 Claude Code Skill

Multi-agent code review with confidence scoring.

# Install skill
claude --skill-dir /path/to/gerrit-agent-skill/skills/gerrit

# Use it
/gerrit:review 12345

Features: 3 specialized analyzers, confidence scoring (≥80%), user confirmation before posting.

📚 Full documentation →


🧠 Gemini CLI Extension

Natural language code reviews with "Principal Software Engineer" persona.

# Install
gemini extensions link https://github.com/madroidmaq/gerrit-agent-skill/gemini-cli-extensions

# Use it
gemini "Review change 12345"
gemini /gerrit:review 12345

📚 Full documentation →


💻 Standalone CLI

GitHub CLI-like experience for Gerrit operations.

# List changes
gerrit list --owner me --status open

# View change
gerrit show 12345 --diff

# Checkout and review
gerrit checkout 12345
gerrit review 12345 --code-review +2 -m "LGTM!"

📚 Full CLI reference →


📚 Documentation


🤝 Contributing

Contributions welcome! See Issues for planned features.

git clone https://github.com/madroidmaq/gerrit-agent-skill.git && cd gerrit-agent-skill
uv sync --extra dev && uv run pytest

📄 License

MIT License - see LICENSE file.


Built with Click, Rich, httpx, Pydantic

If you find this helpful, please ⭐ star the repo!

Report BugRequest Feature

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

gerrit_agent_skill-0.1.0.tar.gz (81.2 kB view details)

Uploaded Source

Built Distribution

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

gerrit_agent_skill-0.1.0-py3-none-any.whl (27.5 kB view details)

Uploaded Python 3

File details

Details for the file gerrit_agent_skill-0.1.0.tar.gz.

File metadata

  • Download URL: gerrit_agent_skill-0.1.0.tar.gz
  • Upload date:
  • Size: 81.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for gerrit_agent_skill-0.1.0.tar.gz
Algorithm Hash digest
SHA256 44ddcf21d0f3756cb8c96c772ddce501df0d1c8e0b5a757846d3c050d6fb2f39
MD5 c01c25cc5c94aa8d2e429670345d0a94
BLAKE2b-256 c11abe63a3dc1fbf5b4136b14dfca0978a47189a314be79cddb7cc043d222b12

See more details on using hashes here.

File details

Details for the file gerrit_agent_skill-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for gerrit_agent_skill-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 462e63b6285b449e06d08c6b0aadf5207014632bf776784161948f115c5eff04
MD5 227f906470ce0cb0f8aa3c000e85f309
BLAKE2b-256 bad755498c3fb4a90e2df9f8597f4e83f8a66acb6658f8a79397ce008aec7294

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