Documentation | Quick Start | Installation

Continuous code review for coding agents. roborev reviews every commit as you work, catches issues before they reach a pull request, and can automatically fix what it finds.

tui-hero.webm

Why roborev?

AI coding agents write code fast, but they make mistakes. Most people still operate in a "commit when it's ready" mindset, which means review feedback comes too late to be useful. The agent has moved on and context is lost. roborev changes this by giving your agents continuous review feedback while they are working on your prompts:

1. Agents commit often - ideally every turn of work
2. roborev reviews each commit in the background
3. Feed findings into your agent sessions, or fix them autonomously with roborev fix

Every commit gets reviewed. Issues surface in seconds, not hours. You catch problems while context is fresh instead of waiting for PR review.

Features

• Background Reviews - Every commit is reviewed automatically via git hooks. No workflow changes required.
• Auto-Fix - roborev fix feeds review findings to an agent that applies fixes and commits. roborev refine iterates until reviews pass.
• Code Analysis - Built-in analysis types (duplication, complexity, refactoring, test fixtures, dead code) that agents can fix automatically.
• Multi-Agent - Works with Codex, Claude Code, Gemini, Copilot, OpenCode, Cursor, and Droid.
• Runs Locally - No hosted service or additional infrastructure. Reviews are orchestrated on your machine using the coding agents you already have configured.
• Interactive TUI - Real-time review queue with vim-style navigation.

Installation

Shell Script (macOS / Linux):

curl -fsSL https://roborev.io/install.sh | bash

Homebrew (macOS / Linux):

brew install roborev-dev/tap/roborev

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://roborev.io/install.ps1 | iex"

With Go:

go install github.com/roborev-dev/roborev/cmd/roborev@latest

Quick Start

cd your-repo
roborev init          # Install post-commit hook
git commit -m "..."   # Reviews happen automatically
roborev tui           # View reviews in interactive UI

tui-navigation.webm

The Fix Loop

When reviews find issues, fix them with a single command:

roborev fix                     # Fix all unaddressed reviews
roborev fix 123                 # Fix a specific job

fix shows the review findings to an agent, which applies changes and commits. The new commit gets reviewed automatically, closing the loop.

For fully automated iteration, use refine:

roborev refine                  # Fix, re-review, repeat until passing

refine runs in an isolated worktree and loops: fix findings, wait for re-review, fix again, until all reviews pass or --max-iterations is hit.

Code Analysis

Run targeted analysis across your codebase and optionally auto-fix:

roborev analyze duplication ./...           # Find duplication
roborev analyze refactor --fix *.go         # Suggest and apply refactors
roborev analyze complexity --wait main.go   # Analyze and show results
roborev analyze test-fixtures *_test.go     # Find test helper opportunities

Available types: test-fixtures, duplication, refactor, complexity, api-design, dead-code, architecture.

Analysis jobs appear in the review queue. Use roborev fix <id> to apply findings later, or pass --fix to apply immediately.

Commands

Command	Description
roborev init	Initialize roborev in current repo
roborev tui	Interactive terminal UI
roborev status	Show daemon and queue status
roborev review <sha>	Queue a commit for review
roborev review --branch	Review all commits on current branch
roborev review --dirty	Review uncommitted changes
roborev fix	Fix unaddressed reviews (or specify job IDs)
roborev refine	Auto-fix loop: fix, re-review, repeat
roborev analyze <type>	Run code analysis with optional auto-fix
roborev show [sha]	Display review for commit
roborev run "<task>"	Execute a task with an AI agent
roborev address <id>	Mark review as addressed
roborev skills install	Install agent skills for Claude/Codex

See full command reference for all options.

Configuration

Create .roborev.toml in your repo:

agent = "claude-code"
review_guidelines = """
Project-specific review instructions here.
"""

See configuration guide for all options.

Supported Agents

Agent	Install
Codex	npm install -g @openai/codex
Claude Code	npm install -g @anthropic-ai/claude-code
Gemini	npm install -g @google/gemini-cli
Copilot	npm install -g @github/copilot
OpenCode	npm install -g opencode-ai
Cursor	cursor.com
Droid	factory.ai

roborev auto-detects installed agents.

Documentation

Full documentation available at roborev.io:

• Quick Start
• Installation
• Commands Reference
• Configuration
• Auto-Fixing with Refine
• Code Analysis and Assisted Refactoring
• Agent Skills
• PostgreSQL Sync

Development

git clone https://github.com/roborev-dev/roborev
cd roborev
go test ./...
make install

License

MIT