| 🇩🇰 Dansk | 🇪🇸 Español | 🇮🇷 Farsi | 🇫🇮 Suomi | 🇯🇵 日本語 | 🇳🇴 Norsk | 🇵🇹 Português | 🇷🇺 Русский | 🇦🇱 Shqip | 🇨🇳 中文 |

git-lrc

Free, Micro AI Code Reviews That Run on Commit

 

     

AI agents write code fast. They also silently remove logic, change behavior, and introduce bugs -- without telling you. You often find out in production.

git-lrc fixes this. It hooks into git commit and reviews every diff before it lands. 60-second setup. Completely free.

See It In Action

See git-lrc catch serious security issues such as leaked credentials, expensive cloud operations, and sensitive material in log statements

https://github.com/user-attachments/assets/cc4aa598-a7e3-4a1d-998c-9f2ba4b4c66e

Why

• 🤖 AI agents silently break things. Code removed. Logic changed. Edge cases gone. You won't notice until production.
• 🔍 Catch it before it ships. AI-powered inline comments show you exactly what changed and what looks wrong.
• 🔁 Build a habit, ship better code. Regular review → fewer bugs → more robust code → better results in your team.
• 🔗 Why git? Git is universal. Every editor, every IDE, every AI toolkit uses it. Committing is mandatory. So there's almost no chance of missing a review — regardless of your stack.

Get Started

Install

Via IPM (Recommended):

# Linux/macOS
curl -L https://hexmos.com/ipm-install | bash && ipm i HexmosTech/git-lrc

# Windows
iwr https://hexmos.com/ipm-install-ps | iex; ipm i HexmosTech/git-lrc

Alternative (direct install):

Linux / macOS:

curl -fsSL https://hexmos.com/lrc-install.sh | bash

Windows (PowerShell):

iwr -useb https://hexmos.com/lrc-install.ps1 | iex

curl -fsSL https://git.new/lrc-install | bash

Binary installed. Hooks set up globally. Done.

Setup

git lrc setup

Here's a quick video of how setup works:

https://github.com/user-attachments/assets/392a4605-6e45-42ad-b2d9-6435312444b5

Two steps, both open in your browser:

1. LiveReview API key — sign in with Hexmos
2. Free Gemini API key — grab one from Google AI Studio

~1 minute. One-time setup, machine-wide. After this, every git repo on your machine triggers review on commit. No per-repo config needed.

How It Works

Option A: Review on commit (automatic)

git add .
git commit -m "add payment validation"
# review launches automatically before the commit goes through

Option B: Review before commit (manual)

git add .
git lrc review          # run AI review first
# or: git lrc review --vouch   # vouch personally, skip AI
# or: git lrc review --skip    # skip review entirely
git commit -m "add payment validation"

Either way, a web UI opens in your browser.

https://github.com/user-attachments/assets/ae063e39-379f-4815-9954-f0e2ab5b9cde

The Review UI

• 📄 GitHub-style diff — color-coded additions/deletions
• 💬 Inline AI comments — at the exact lines that matter, with severity badges
• 📝 Review summary — high-level overview of what the AI found
• 📁 Staged file list — see all staged files at a glance, jump between them
• 📊 Diff summary — lines added/removed per file for a quick sense of change scope
• 📋 Copy issues — one click to copy all AI-flagged issues, ready to paste back into your AI agent
• 🔄 Cycle through issues — navigate between comments one by one without scrolling
• 📜 Event log — track review events, iterations, and status changes in one place

https://github.com/user-attachments/assets/b579d7c6-bdf6-458b-b446-006ca41fe47d

The Decision

📎 Screenshot: Pre-commit bar showing Commit / Commit & Push / Skip buttons

The Review Cycle

Typical workflow with AI-generated code:

1. Generate code with your AI agent
2. git add . → git lrc review — AI flags issues
3. Copy issues, feed them back to your agent to fix
4. git add . → git lrc review — AI reviews again
5. Repeat until satisfied
6. git lrc review --vouch → git commit — you vouch and commit

Each git lrc review is an iteration. The tool tracks how many iterations you did and what percentage of the diff was AI-reviewed (coverage).

Vouch

Once you've iterated enough and you're satisfied with the code:

git lrc review --vouch

This says: "I've reviewed this — through AI iterations or personally — and I take responsibility." No AI review runs, but coverage stats from prior iterations are recorded.

Skip

Just want to commit without review or responsibility attestation?

git lrc review --skip

No AI review. No personal attestation. The git log will record skipped.

Git Log Tracking

Every commit gets a review status line appended to its git log message:

LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)

LiveReview Pre-Commit Check: vouched (iter:2, coverage:50%)

LiveReview Pre-Commit Check: skipped

• iter — number of review cycles before committing. iter:3 = three rounds of review → fix → review.
• coverage — percentage of the final diff already AI-reviewed in prior iterations. coverage:85% = only 15% of the code is unreviewed.

Your team sees exactly which commits were reviewed, vouched, or skipped — right in git log.

Bring Your Own AI Connector (BYOK)

In addition to the default Gemini setup, you can bring your own API keys for:

• OpenAI
• Claude
• DeepSeek
• OpenRouter

Use:

lrc ui

From the UI, you can:

• Re-authenticate your account
• Add or update AI connectors
• Reorder connectors to set priority

By default, the first connector in the list is used for reviews.

Security You Can Trust

• Security is treated as a core product requirement in git-lrc.
• We document reporting channels, response commitments, and operational safeguards clearly.
• Automated security checks and SBOM workflows support transparent verification.
• For complete details, see SECURITY.md.

FAQ

Review vs Vouch vs Skip?

Review is the default. AI analyzes your staged diff and gives inline feedback. Each review is one iteration in the change–review cycle.

Vouch means you're explicitly taking responsibility for this commit. Typically used after multiple review iterations — you've gone back and forth, fixed issues, and are now satisfied. The AI doesn't run again, but your prior iteration and coverage stats are recorded.

Skip means you're not reviewing this particular commit. Maybe it's trivial, maybe it's not critical — the reason is yours. The git log simply records skipped.

How is this free?

git-lrc uses Google's Gemini API by default for AI reviews, and also supports BYOK connectors (OpenAI, Claude, DeepSeek, OpenRouter) — see Bring Your Own AI Connector (BYOK). Gemini offers a generous free tier. You bring your own API key(s) — there's no middleman billing. The LiveReview cloud service that coordinates reviews is free for individual developers.

Which AI providers can I use with BYOK?

You can connect Gemini (default), OpenAI, Claude, DeepSeek, and OpenRouter.

Manage connectors from:

lrc ui

How do I choose which connector is used for review?

Open:

lrc ui

Then reorder your connector list. The first connector is used by default when a review runs.

Can I re-authenticate or change connectors later?

Yes. Run lrc ui anytime to re-authenticate, add/remove connectors, and update connector priority.

What data is sent?

Only the staged diff is analyzed. No full repository context is uploaded, and diffs are not stored after review.

Can I disable it for a specific repo?

git lrc hooks disable   # disable for current repo
git lrc hooks enable    # re-enable later

Can I review an older commit?

git lrc review --commit HEAD       # review the last commit
git lrc review --commit HEAD~3..HEAD  # review a range

Quick Reference

Tip: git lrc <command> and lrc <command> are interchangeable.

It's Free. Share it with your friends and colleagues.

git-lrc is completely free. No credit card. No trial. No catch.

If it helps you — share it with your developer friends. The more people review AI-generated code, the fewer bugs make it to production.

⭐ Star this repo to help others discover it.

Community

Pick the right place based on what you need:

• Discord: discord.gg/sGdnKwB3qq - Best for joining the community, asking general Q&A, and having quick back-and-forth with the team.
• GitHub Discussions: github.com/HexmosTech/git-lrc/discussions - For in-depth idea proposals, scoping, design discussions, modification proposals, and constructive criticism.
• GitHub Issues: github.com/HexmosTech/git-lrc/issues - For concrete, scoped tasks such as bugs, focused feature requests, and actionable implementation work.

License

git-lrc is distributed under a modified variant of Sustainable Use License (SUL).

For detailed terms, examples of permitted and prohibited uses, and definitions, see the full LICENSE.md.

For Teams: LiveReview

Using git-lrc solo? Great. Building with a team? Check out LiveReview — the full suite for team-wide AI code review, with dashboards, org-level policies, and review analytics. Everything git-lrc does, plus team coordination.