Documentation | Quick Start | Installation

Continuous code review for AI coding agents. roborev runs in the background, reviews every commit as agents write code, and surfaces issues in seconds -- before they compound. Pull code reviews into your agentic loop while context is fresh.

How It Works

1. Run roborev init to install a post-commit hook
2. Every commit triggers a background review -- agents write, roborev reads
3. View findings in the TUI, feed them to your agent, or let roborev fix handle it

Quick Start

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

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, Kiro, Kilo, Droid, and Pi.
• 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.
• Review Verification - roborev compact verifies findings against current code, filters false positives, and consolidates related issues into a single review.
• Extensible Hooks - Run shell commands on review events. Built-in beads integration creates trackable issues from review failures automatically.

The Agentic Fix Loop

When reviews find issues, copy-and-paste the reviews into your interactive agent sessions, or invoke the roborev:fix skills. You can also address open reviews on the command line non-interactively with roborev fix.

roborev 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 (advanced feature), 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.

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

Commands

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

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
• Hooks
• Agent Skills
• PostgreSQL Sync

License

MIT