Running Your First Code Review

Create a review session and watch VibeRails orchestrate AI agents to analyze your codebase file-by-file, discovering issues across 17 categories.

Starting a New Review

Navigate to the Reviews tab and click the New Review button. This opens the four-step review wizard that configures your session.

Step 1: Select Project

Choose which project to review. The wizard shows all registered projects with their file counts and last-scanned timestamps.

Review wizard Step 1 — project selection — Step 1: Select the project you want to review.

Step 2: Choose AI Backend

Select which AI backend to use for the discovery pass. If you have both Claude Code and Codex installed, you can also enable a verification pass with a second backend.

Tip: For your first review, start with a single-pass Claude Code session. You can experiment with dual-pass verification once you are familiar with the workflow.

Step 3: Configure Categories

Select which issue categories to scan for. All 17 categories are enabled by default. For a faster review, you can narrow the focus to specific categories like Security, Bugs, and Performance.

Step 4: Review & Launch

The final step shows a summary of your configuration: project, backend, categories, estimated file count, and token budget. Click Start Review to begin.

Watching the Review Progress

After launching, the review session appears in the Reviews table. You can see real-time progress as the AI processes each file:

Status — Running, Paused, Completed, or Error
Progress — Files processed out of total (e.g., 42/128)
Issues found — Running count of discovered issues
Elapsed time — How long the session has been running

A review session row showing progress indicators — The session row shows real-time progress, issue count, and elapsed time.

Note: Review sessions stream results in real-time via Socket.IO. Issues appear in the Issues tab as they are discovered — you do not need to wait for the full session to complete before starting triage.

Full Walkthrough

Here is the complete flow from clicking New Review through to seeing the session running:

Animated walkthrough of creating a review session — Creating a review session: wizard steps, launch, and progress tracking.

Pausing and Cancelling

You can pause or cancel a running review at any time. Paused sessions can be resumed from where they left off. Cancelled sessions retain all issues discovered up to the point of cancellation.

Next Steps

Once your review session has found issues, it is time to triage the results and optionally dispatch AI agents to implement fixes.