roborev

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

If roborev is managed by a version manager, roborev init and roborev agent-hook install try to install hooks with the stable shim/symlink. You can also choose the exact binary path with roborev init --binary ~/.local/share/mise/shims/roborev or roborev agent-hook install --binary ~/.local/share/mise/shims/roborev.

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.
• Agent Hook - Optional Codex and Claude Code harness hooks can prompt active sessions to run $roborev-fix when roborev has open failed reviews.
• Code Analysis - Built-in analysis types (duplication, complexity, refactoring, test fixtures, dead code, security) 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 and kata integrations create 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 Codex and Claude Code sessions, roborev agent-hook install can add an optional harness hook that prompts the active session to invoke $roborev-fix after configured turn, commit, or failed-review thresholds are met. The hook uses a separate local roborev-agent-hook daemon for session counters; it does not run inside the main roborev daemon.

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
roborev analyze security ./...              # Find security risks in existing code

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

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

Installation