Skip to content
roborev
GitHub stars

Quick Start

Install

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

Initialize in Your Repo

Terminal window
cd your-repo
roborev init          # Install post-commit hook
# do some work, generate commits
roborev fix           # Fix open reviews
roborev tui           # View reviews in interactive UI

What Happens

  1. roborev init installs a post-commit hook in your repo
  2. On each commit, the hook notifies the roborev daemon
  3. The daemon queues the commit for review by an AI agent
  4. Reviews are stored locally in SQLite
  5. View results with roborev tui or roborev show

Check the daemon status at any time:

roborev status output

Addressing Reviews

With roborev fix

The quickest way to address a review is to let an agent fix it:

Terminal window
roborev fix                        # Fix all open reviews on this branch
roborev fix 123                    # Fix a specific review by job ID

The agent applies changes, commits, and closes the review. This is a one-shot fix. Use refine (below) if you want automatic re-review.

With roborev refine

For a fully automated loop that re-reviews fixes and keeps iterating:

Terminal window
roborev refine                     # Fix all failed reviews, re-review, repeat
roborev refine --max-iterations 5  # Limit iterations

Refine finds failed reviews, runs an agent to fix them, waits for re-review, and repeats until everything passes. See Auto-Fix with Refine.

In the TUI

You can also browse reviews in the TUI, mark them closed with the a key, and press y to copy a review to your clipboard for pasting into your agent session. You can also use the agent skills for supported agents.

roborev TUI with closed review

Next Steps