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

Automation, two layers

• Post-commit reviews - a git hook reviews every commit in the background (any agent).
• Agent hook - watches your Claude Code / Codex session and tells the agent to run the roborev-fix skill when findings pile up.

roborev init                  # layer 1: per-commit reviews
roborev skills install
roborev agent-hook install    # layer 2: mid-session fix loop (Codex/Claude)
roborev agent-hook install --agent droid  # layer 2: mid-session fix loop (Factory Droid)

Before you ship, run the /roborev-refine skill: it re-reviews and fixes your whole branch until every review passes, catching bugs before the PR.

New here? Run roborev quickstart and point your agent at 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, roborev agent-hook install --binary ~/.local/share/mise/shims/roborev, or roborev agent-hook install --agent droid --binary ~/.local/share/mise/shims/roborev.

Features

• Background Reviews - Every commit is reviewed automatically via git hooks. No remote review workflow 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, Claude Code, and Factory Droid harness hooks can prompt active sessions to run the fix skill 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 /roborev-fix in Claude Code or $roborev-fix in Codex. 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, Claude Code, and Factory Droid sessions, roborev agent-hook install can add an optional harness hook that prompts the active session to invoke $roborev-fix (or /roborev-fix for Droid) 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: