LLM-powered code review for your local commits — before another human sees them.
CommitBrief is a developer-first toolchain that brings AI code review into the terminal, right next to git. No web UI, no SaaS dashboard, no telemetry — just a faster feedback loop on the code you are about to commit. Website: commitbrief.com.
Note
🎉 v1.18.1 is out. CommitBrief has grown well past a diff reviewer — it writes Conventional Commit messages (commitbrief commit), gates merges on a declarative policy (commitbrief guard), reviews a GitHub pull request inline (commitbrief remote pr <ID>), audits your tree and history for committed credentials (commitbrief leaks), and runs as an MCP server (commitbrief mcp) so coding agents can use it as a review gate. Ten providers out of the box, strict semver since v1.0.0. Install via Homebrew, Scoop, or go install, and update in place with commitbrief upgrade. → Release notes
Every modern engineer ships code under two opposing pressures: review thoroughness and review latency. Today the options are:
- Re-read your own diff — slow, easy to miss issues, inconsistent.
- Ask a colleague — high-quality, but a costly synchronous round-trip.
- Paste into a chat UI — friction, no project rules, no caching, no git context.
CommitBrief fills the gap: a quick AI-assisted pre-check on the diff in front of you, using rules you defined, run against the AI provider you chose (including local-only Ollama).
brew install CommitBrief/tap/commitbrief # macOS + Linux
# or
go install github.com/CommitBrief/commitbrief/cmd/commitbrief@latest
# or, on Windows
scoop bucket add commitbrief https://github.com/CommitBrief/scoop-bucket && scoop install commitbrief
commitbrief setup # one-time interactive provider + API key setup
commitbrief # review your currently staged changesWant a fully local, privacy-first setup? Point CommitBrief at Ollama and your favorite local model — no data leaves your machine.
| Project | Description | Status |
|---|---|---|
| commitbrief | The CLI: review --staged / --unstaged, any git diff range, a single file, or a GitHub PR (remote pr); generate commit messages (commit); gate merges (guard); serve an MCP review gate (mcp). Structured findings in your terminal, in your language. |
Stable — v1.18.1 |
| commitbrief-action | Composite GitHub Action that runs CommitBrief on pull requests: inline comments + verdict (comment), a severity gate (gate), or the policy gate (guard). Pin @v1. |
Stable — v1 |
Built in already:
- An MCP server (
commitbrief mcp) so coding agents can call CommitBrief as a review gate over stdio. - PR review from the terminal (
commitbrief remote pr <ID>) via your localghCLI — inline comments plus a verdict.
Planned for the next major line:
- IDE extensions that wrap the CLI for in-editor reviews.
- Privacy-first. No telemetry, no remote config, no shared state. Your code stays where you put it.
- Provider-agnostic. Ten providers out of the box — Anthropic, OpenAI, Gemini and local Ollama natively; DeepSeek, Mistral and Cohere over their OpenAI-compatible APIs; plus
claude-cli,gemini-cliandcodex-clithat reuse a CLI subscription you already pay for. No vendor lock-in. - Developer-controlled. You define the review rules in plain Markdown in your repo. CommitBrief reads them as the system prompt — no DSL to learn.
- Terminal-native. Colored finding cards and glamour-rendered Markdown in the terminal; strict JSON when you need to script around it.
- Open source. All projects under GPL-3.0-or-later.
- General questions: open a discussion on the relevant repo.
- Bug reports: open an issue with the bug-report template.
- Security: report privately via GitHub's private vulnerability reporting (see each repo's
SECURITY.md), or email info@muhammetsafak.com.
Free your commits from the "looks good to me" reflex. Run
commitbriefand let the diff speak.
