### Getting Started with Roborev

Source: https://github.com/kenn-io/roborev/blob/main/docs/development.md

Clone the repository and install the project. Use 'make install' for a versioned installation or 'go install' for quick iteration.

```bash
git clone https://github.com/kenn-io/roborev
cd roborev
go test ./...
make install    # Installs with version info (e.g., v0.7.0-5-gabcdef)
```

--------------------------------

### Run Roborev Quickstart Guide

Source: https://github.com/kenn-io/roborev/blob/main/docs/automation/post-commit-reviews.md

Initiates the Roborev quickstart guide, which helps in finishing the repository's configuration. It can output a human-readable guide or machine-readable JSON state for agents.

```bash
roborev quickstart            # human-readable
roborev quickstart --json     # machine-readable state for agents
```

--------------------------------

### Developer Setup with Prek and Mise

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Set up the development environment by installing prek for pre-commit hooks and using mise to manage Node.js versions for Renovate. Install and run the local git hooks.

```bash
brew install prek     # or use your preferred prek install method
 mise use --global npm:renovate@latest
 prek install          # install the local git hook
 prek run --all-files  # run the configured checks manually
```

--------------------------------

### Initialize Roborev in Your Repo

Source: https://github.com/kenn-io/roborev/blob/main/docs/quickstart.md

Set up roborev in your project directory by running 'roborev init'. This installs a post-commit hook and starts the roborev daemon for automatic AI code reviews on each commit.

```bash
cd your-repo
roborev init
```

--------------------------------

### Initialize Roborev Post-Commit Hook

Source: https://github.com/kenn-io/roborev/blob/main/docs/automation/post-commit-reviews.md

Installs the git post-commit hook, starts the Roborev daemon, and registers the current repository. This is the initial setup step for Layer 1 automation.

```bash
roborev init      # installs the hook, starts the daemon, registers the repo
```

--------------------------------

### Install Roborev using Go

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

If you have Go installed, you can install Roborev using the `go install` command. Ensure your `$GOPATH/bin` is included in your system's PATH.

```bash
go install go.kenn.io/roborev/cmd/roborev@latest
```

```bash
export PATH="$PATH:$(go env GOPATH)/bin"
```

--------------------------------

### Install Docs Toolchain

Source: https://github.com/kenn-io/roborev/blob/main/docs/README.md

Installs the necessary tools for developing and building the documentation.

```bash
make docs-install
```

--------------------------------

### Build and Install Roborev from Source

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Clone the Roborev repository and use `make install` to build and install the latest version from source. This embeds version information into the binary.

```bash
git clone https://github.com/kenn-io/roborev
cd roborev
make install
```

--------------------------------

### Installing and Building Documentation

Source: https://github.com/kenn-io/roborev/blob/main/docs/development.md

Commands to install the documentation toolchain, build the documentation site, and serve it locally for preview.

```bash
make docs-install
make docs-build

make docs-serve
```

--------------------------------

### Quick Install Script for Windows

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Execute this PowerShell command to install the latest Roborev release binary on Windows. It installs to `%USERPROFILE%\.roborev\bin` and adds it to your PATH, supporting both x64 and ARM64 architectures. The installer verifies SHA256 checksums by default.

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://roborev.io/install.ps1 | iex"
```

--------------------------------

### Quick Build for Development (Go)

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

For rapid iteration during development, use `go install ./cmd/...` to build and install the command-line tools.

```bash
go install ./cmd/...
```

--------------------------------

### Standard Test Repository Setup

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Performs a standard setup for a test repository, including initialization and a base file. Use this for common test repository needs.

```go
testutil.InitTestRepo(t)
```

--------------------------------

### Install RoboRev

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Installs the RoboRev executable to `~/.local/bin`. This command is typically used after building.

```bash
make install
```

--------------------------------

### Manual GitHub Actions Workflow Setup

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

This YAML configuration defines a GitHub Actions workflow for running Roborev CI reviews. It includes steps for checking out code, installing Roborev, and executing the review command.

```yaml
name: roborev
on:
  pull_request:
    types: [opened, synchronize]

permissions:
  contents: read
  pull-requests: write

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install roborev
        run: |
          curl -fsSL https://roborev.io/install.sh | bash
          echo "$HOME/.roborev/bin" >> "$GITHUB_PATH"

      - name: Run review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: roborev ci review --comment --agent claude-code
```

--------------------------------

### Serve Docs Locally

Source: https://github.com/kenn-io/roborev/blob/main/docs/README.md

Starts a local server to preview the documentation site.

```bash
make docs-serve
```

--------------------------------

### Enable Roborev Systemd Service on Linux

Source: https://github.com/kenn-io/roborev/blob/main/docs/configuration.md

Enable and start the Roborev systemd user service. This command assumes the necessary unit files are already installed.

```bash
systemctl --user enable --now roborev
```

--------------------------------

### Tap and Install Roborev via Homebrew

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Alternatively, first tap the 'kenn-io/tap' repository and then install Roborev using Homebrew. This is useful if you want to manage the tap separately.

```bash
brew tap kenn-io/tap
brew install roborev
```

--------------------------------

### Verify Roborev Installation

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

After installation, run this command to verify that Roborev is installed correctly and to check its version.

```bash
roborev version
```

--------------------------------

### Install Kilo Agent

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Use this command to install the Kilo agent globally via npm.

```bash
npm install -g @kilocode/cli
```

--------------------------------

### Install Antigravity CLI

Source: https://github.com/kenn-io/roborev/blob/main/docs/agents/index.md

Install the Antigravity CLI, which is preferred for Gemini agent interactions. This script handles the installation process.

```bash
# Preferred: Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash
```

--------------------------------

### Install Copilot Agent

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Use this command to install the Copilot agent globally via npm.

```bash
npm install -g @github/copilot
```

--------------------------------

### Start Roborev Daemon

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Starts the background Roborev daemon process.

```bash
roborev daemon start
```

--------------------------------

### Per-Repo CI Configuration Example

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

Example of a .roborev.toml file in a repository root, demonstrating how to override global CI settings. This snippet shows how to specify a custom agent, CI panel, and reasoning level for the repository.

```toml
# .roborev.toml (in repo root)

agent = "codex"   # agent for post-commit reviews (unrelated to CI)

[ci]
panel = "ci"                         # run named [review.panels.ci] for this repo
# Or omit panel and use the compatible matrix:
# agents = ["gemini"]
# review_types = ["security", "default"]
reasoning = "standard"               # override reasoning level (thorough, standard, fast)

```

--------------------------------

### Quick Install Script for macOS/Linux

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Use this command to download and execute the latest Roborev release binary for macOS and Linux systems. It installs to `~/.local/bin` by default.

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

--------------------------------

### Install Pre-commit Hooks

Source: https://github.com/kenn-io/roborev/blob/main/AGENTS.md

Install the project's pre-commit hooks managed by 'prek'. This ensures code quality checks are run automatically before each commit.

```bash
prek install
```

--------------------------------

### Example Design Review Invocation

Source: https://github.com/kenn-io/roborev/blob/main/skills/roborev-design-review.md

An example of how a user might invoke the /roborev-design-review skill with a specific design document path.

```bash
/roborev-design-review docs/design/auth-redesign.md
```

--------------------------------

### Install Legacy Gemini CLI

Source: https://github.com/kenn-io/roborev/blob/main/docs/agents/index.md

Install the legacy Gemini CLI using npm. This is supported as a fallback if the Antigravity CLI is not available.

```bash
# Legacy CLI (still supported)
npm install -g @google/gemini-cli
```

--------------------------------

### Install Gemini Agent via npm

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Alternatively, install the Gemini agent globally via npm.

```bash
npm install -g @google/gemini-cli
```

--------------------------------

### Building Roborev

Source: https://github.com/kenn-io/roborev/blob/main/docs/development.md

Commands for building the Roborev project. 'go build' compiles all packages, while 'make install' installs the project with version information.

```bash
go build ./...

make install
```

--------------------------------

### Install OpenCode Agent

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Install the OpenCode agent globally via npm. Refer to the anomalyco/opencode repository for more details.

```bash
npm install -g opencode-ai@latest
```

--------------------------------

### Install Roborev via Homebrew

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Install Roborev on macOS or Linux using the Homebrew package manager.

```bash
brew install roborev-dev/tap/roborev
```

--------------------------------

### Install and Update Agent Skills

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Commands to manage agent skills. Use 'install' to add new skills and 'update' to refresh existing ones.

```bash
roborev skills install           # Install skills for agents
```

```bash
roborev skills update            # Update installed skills
```

--------------------------------

### Agent Hook Configuration Example

Source: https://github.com/kenn-io/roborev/blob/main/docs/agent-hook.md

Sets thresholds and custom instructions for agent hook triggers in the TOML configuration file.

```toml
[agent_hook]
turn_threshold = 5
commit_threshold = 0
failed_review_threshold = 4
instruction = "Invoke the $roborev-fix skill now."
```

--------------------------------

### TUI Control Socket Protocol Examples

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/tui.md

Examples demonstrating how to send JSON commands to the Roborev TUI's control socket and receive responses. This includes querying state and setting filters.

```json
{"command": "get-state"}
```

```json
{"command": "set-filter", "params": {"repo": "myrepo", "branch": "main"}}
```

```json
{"command": "close-review", "params": {"job_id": 42}}
```

```json
{"ok": true, "data": {"view": "queue", "job_count": 15, ...}}
```

```json
{"ok": false, "error": "job not found"}
```

```bash
# Find the socket path from runtime metadata
SOCKET=$(python3 -c "import json,glob; f=glob.glob('$HOME/.roborev/tui.*.json')[0]; print(json.load(open(f))['socket_path'])")

# Query current state
echo '{"command":"get-state"}' | nc -U "$SOCKET"

# Set filter to a specific repo
echo '{"command":"set-filter","params":{"repo":"myproject"}}' | nc -U "$SOCKET"
```

--------------------------------

### Initialize Roborev Post-Commit Hook

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Run this command to install the git post-commit hook for automated reviews on every commit. This is the first layer of automation.

```bash
roborev init                  # layer 1: per-commit reviews
```

--------------------------------

### Install Roborev using RPM package (Fedora/RHEL)

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Install Roborev on Fedora or RHEL-based systems using the provided .rpm package. Replace `<version>` with the actual package version.

```bash
sudo dnf install ./roborev_<version>_linux_amd64.rpm
```

--------------------------------

### Example: Comment and Close Roborev Review

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/claude/roborev-respond/SKILL.md

Demonstrates the bash command to comment on and close a Roborev review when a message is provided.

```bash
roborev comment --job 1019 "Fixed all issues" && roborev close 1019
```

--------------------------------

### Cost Usage Endpoint Response Example

Source: https://github.com/kenn-io/roborev/blob/main/docs/configuration.md

Example JSON response for the cost usage endpoint, compatible with 'agentsview session usage --format json'.

```json
{
  "session_id": "session-123",
  "agent": "codex",
  "project": "myrepo",
  "total_output_tokens": 28800,
  "peak_context_tokens": 118000,
  "has_token_data": true,
  "cost_usd": 0.42,
  "has_cost": true
}
```

--------------------------------

### Install Roborev using DEB package (Debian/Ubuntu)

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Install Roborev on Debian-based or Ubuntu systems using the provided .deb package. Replace `<version>` with the actual package version.

```bash
sudo apt install ./roborev_<version>_linux_amd64.deb
```

--------------------------------

### Example comment for generated code

Source: https://github.com/kenn-io/roborev/blob/main/docs/guides/responding-to-reviews.md

Inform the AI to ignore style issues in generated code files, such as those from protobuf, and explain that they are not modified directly.

```text
This is generated code from protobuf - we don't modify it directly.
Please ignore style issues in *.pb.go files.
```

--------------------------------

### Hydrate Assets and Build Docs

Source: https://github.com/kenn-io/roborev/blob/main/docs/README.md

Fetches documentation assets and builds the static site.

```bash
make docs-build
```

--------------------------------

### Default Branch Look-ahead Review Example

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-lookahead-review-branch/SKILL.md

Demonstrates a typical user interaction for initiating a default branch look-ahead review and the agent's subsequent actions, including presenting results and offering to fix findings.

```bash
$roborev-lookahead-review-branch
```

--------------------------------

### Install Roborev via Homebrew

Source: https://github.com/kenn-io/roborev/blob/main/docs/installation.md

Install Roborev using Homebrew on macOS or Linux. This command adds the 'kenn-io/tap' repository and installs the 'roborev' package.

```bash
brew install kenn-io/tap/roborev
```

--------------------------------

### Roborev Insights Command Examples

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Demonstrates various ways to use the roborev insights command with different flags to filter and format the analysis.

```bash
roborev insights                          # Analyze last 30 days
roborev insights --since 7d              # Last 7 days
roborev insights --branch main           # Filter to main branch
roborev insights --repo /path/to/repo    # Specific repository
roborev insights --agent gemini          # Use specific agent
roborev insights --wait=false            # Enqueue without waiting
roborev insights --json                  # Output as JSON
```

--------------------------------

### Initialize Repository and Daemon

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Initializes the repository, daemon, and hook. Use `--no-daemon` to skip auto-starting the daemon.

```bash
roborev init [--agent <name>]    # Initialize repo + daemon + hook
                                 # --no-daemon: skip auto-starting daemon
```

--------------------------------

### Install Claude Chic

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/claudechic.md

Install Claude Chic using pip or uv. Ensure roborev and Claude Code are on your PATH. Install roborev agent skills if using the /roborev-fix command.

```bash
uv tool install claudechic   # recommended
```

```bash
pip install claudechic        # alternative
```

```bash
roborev skills install
```

--------------------------------

### Run Initial Review with --since

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/claude/roborev-refine/SKILL.md

Use this command to perform an initial review when a specific commit is provided as a reference point. This is the closest manual equivalent to `roborev refine --since`.

```bash
roborev review --since <commit> --wait
```

--------------------------------

### Install Agent Hook with Binary Path

Source: https://github.com/kenn-io/roborev/blob/main/docs/agent-hook.md

Installs agent-hook entries, pinning the exact binary path used by the hook command. This is useful when roborev is installed via a version manager.

```bash
roborev agent-hook install --binary ~/.local/share/mise/shims/roborev
```

--------------------------------

### Default Branch Design Review Example

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-design-review-branch/SKILL.md

Demonstrates a typical user interaction for initiating a default branch design review. The agent executes the review, presents results, and offers to fix findings if any exist.

```bash
$roborev-design-review-branch
```

--------------------------------

### CI Configuration with Mixed Installation IDs

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

Configure Roborev CI using a mix of a singular fallback installation ID and a map for specific organization installations. This allows for a general fallback while overriding for particular owners.

```toml
[ci]
github_app_id = 123456
github_app_private_key = "~/.roborev/roborev.pem"
github_app_installation_id = 111111   # fallback for unlisted owners

[ci.github_app_installations]
roborev-dev = 222222                  # this org uses a different installation
```

--------------------------------

### Default Branch Review Example

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-review-branch/SKILL.md

Demonstrates a typical user interaction for initiating a default branch review and the agent's expected response, including offering to fix findings.

```bash
$roborev-review-branch
```

--------------------------------

### Make Docs Deploy Staging

Source: https://github.com/kenn-io/roborev/blob/main/docs/README.md

Create a Vercel preview/staging deployment before production using the make docs-deploy-staging command.

```bash
make docs-deploy-staging

```

--------------------------------

### Install Codex Agent

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Use this command to install the Codex agent globally via npm.

```bash
npm install -g @openai/codex
```

--------------------------------

### Configure Repository-Specific Review Guidelines

Source: https://github.com/kenn-io/roborev/blob/main/cmd/roborev/quickstart_guide.md

Add standing instructions to all reviews by defining `review_guidelines` in the `.roborev.toml` file. This ensures consistent feedback based on team priorities.

```toml
# .roborev.toml
review_guidelines = """
Every change to UI components must include or update a Playwright e2e test.
Flag any PR that changes UI without a corresponding e2e test.
"""
```

--------------------------------

### Start RoboRev Daemon

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Starts the RoboRev daemon process in the foreground. Useful for debugging and monitoring.

```bash
roborev daemon run
```

--------------------------------

### Create Temporary Test Repository

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Creates a temporary Git repository initialized with `git init`. Useful for setting up isolated test environments.

```go
testutil.NewTestRepo()
```

--------------------------------

### Initialize GitHub Actions Workflow

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

Use this command to quickly set up a Roborev CI review workflow in your repository. It generates the necessary `.github/workflows/roborev.yml` file.

```bash
cd your-repo
roborev init gh-action --agent claude-code
```

--------------------------------

### Install Roborev Agent Skills

Source: https://github.com/kenn-io/roborev/blob/main/docs/agent-hook.md

Installs the necessary agent skills for roborev. This is a prerequisite for using agent-hook.

```bash
roborev skills install
```

--------------------------------

### Create Repository in Storage

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Creates a repository entry in the database. Use this when only repository creation is needed.

```go
createRepo(t, db, path)
```

--------------------------------

### Install Claude Code Agent

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Use this command to install the Claude Code agent globally via npm.

```bash
npm install -g @anthropic-ai/claude-code
```

--------------------------------

### Install Agent Hook

Source: https://github.com/kenn-io/roborev/blob/main/docs/agent-hook.md

Installs the agent-hook entries, updating hook configurations. By default, it updates both ~/.codex/hooks.json and ~/.claude/settings.json.

```bash
roborev agent-hook install
```

--------------------------------

### Example: Default Design Review of HEAD

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-design-review/SKILL.md

Demonstrates the agent's actions for a default design review of the latest commit (HEAD). Includes executing the review command and presenting results or offering fixes.

```bash
roborev review --wait --type design
```

--------------------------------

### Full Worker Pool Test Setup

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Sets up a complete test context for a worker pool, including necessary configurations and mock objects. Use this for comprehensive worker pool testing.

```go
newWorkerTestContext(t, n)
```

--------------------------------

### Install Roborev Post-Commit Hook

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Installs the git post-commit hook for Roborev. This hook is called automatically by git after each commit.

```bash
roborev install-hook
```

--------------------------------

### Install Gemini Agent via Antigravity CLI

Source: https://github.com/kenn-io/roborev/blob/main/README.md

This command installs the Gemini agent using the preferred Antigravity CLI.

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
```

--------------------------------

### Example: Default Design Review of HEAD

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/claude/roborev-design-review/SKILL.md

Demonstrates the user interaction and agent actions for a default design review of the current HEAD commit. Includes submission, confirmation, and follow-up actions.

```text
User: /roborev-design-review

Agent:
1. Launches background task: roborev review --wait --type design
2. Tells user: "Design review submitted for HEAD. I'll present the results when it completes."
3. When complete, presents the verdict and findings grouped by severity
4. If findings exist: "Would you like me to address these findings? Run /roborev-fix 1042"
5. If passed: "Design review passed with no findings."
```

--------------------------------

### Make Docs Deploy

Source: https://github.com/kenn-io/roborev/blob/main/docs/README.md

Execute the make docs-deploy command for production documentation deployment. Use this when the asset branches and local build state are confirmed to be correct.

```bash
make docs-deploy

```

--------------------------------

### Run Project Tests

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/claude/roborev-refine/SKILL.md

Execute the project's test suite to verify fixes. Use the appropriate command for your project.

```bash
go test ./...

```

--------------------------------

### Verify gh CLI Installation

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

Check if the `gh` CLI tool is installed on your system. This is a prerequisite for using `gh` CLI authentication.

```bash
gh --version
```

--------------------------------

### Check All Installed Agents

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

Perform a smoke test on all AI agents detected by Roborev. This helps verify that your agents are installed and functioning correctly.

```bash
roborev check-agents
```

--------------------------------

### Smoke-Test All Installed Agents

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Run `roborev check-agents` to perform a smoke test on all installed agents. This command verifies the basic functionality of each agent.

```bash
roborev check-agents                # Smoke-test all installed agents
```

--------------------------------

### Example: Design Review of a Specific Commit

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-design-review/SKILL.md

Illustrates the process for requesting a design review of a particular commit. It includes input validation and executing the review command.

```bash
git rev-parse --verify -- abc123^{commit}
```

```bash
roborev review abc123 --wait --type design
```

--------------------------------

### Look-ahead Review Against Specific Base Branch Example

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-lookahead-review-branch/SKILL.md

Illustrates how a user can request a look-ahead review against a specific base branch, and the agent's process of validating the branch and executing the review.

```bash
$roborev-lookahead-review-branch --base develop
```

--------------------------------

### Configure Roborev with TOML

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Set up project-specific review behavior by defining agent, snapshot directory, and review guidelines in `.roborev.toml`. Ensure `snapshot_dir` is repo-relative.

```toml
agent = "claude-code"
snapshot_dir = ".roborev"
review_guidelines = """
Project-specific review instructions here.
"""
# Optional: use repo guidelines instead of appending global review_guidelines.
review_guidelines_supersede_global = false

# Optional: metadata for roborev-owned fix commits and prompt hints for agent-owned fix commits.
fix_commit_author = "Your Name <you@example.com>"
fix_commit_co_authored_by = ["Pair Reviewer <pair@example.com>"]
```

--------------------------------

### Initialize Roborev Go Client

Source: https://github.com/kenn-io/roborev/blob/main/docs/advanced/streaming.md

Import and initialize the public daemon client for external Go integrations. Ensure the daemon is running at the specified address.

```go
import roborevclient "go.kenn.io/roborev/pkg/client"

func main() {
    c, err := roborevclient.New("http://127.0.0.1:7373")
    if err != nil {
        panic(err)
    }
    _ = c
}
```

--------------------------------

### Roborev Summary Command Examples

Source: https://github.com/kenn-io/roborev/blob/main/docs/commands.md

Generate review statistics for the current or all repositories. Supports filtering by time, branch, and repository path, with JSON output for scripting.

```bash
roborev summary                     # Last 7 days, current repo
roborev summary --all               # Last 7 days, all repos
roborev summary --since 30d         # Last 30 days
roborev summary --branch main       # Filter by branch
roborev summary --repo /path/to/repo
roborev summary --json              # Structured output for scripting
```

--------------------------------

### Install ACP Wrapper Package

Source: https://github.com/kenn-io/roborev/blob/main/docs/advanced/acp.md

Install the ACP wrapper package using npm. This is required to resolve 'no Codex ACP wrapper command was found' errors.

```bash
npm install -g @zed-industries/codex-acp
```

--------------------------------

### Create Test Repository with Initial Commit

Source: https://github.com/kenn-io/roborev/blob/main/CLAUDE.md

Creates a temporary Git repository and adds an initial commit. Useful for tests requiring a commit history.

```go
testutil.NewTestRepoWithCommit()
```

--------------------------------

### Install Pi JSON Schema Extension

Source: https://github.com/kenn-io/roborev/blob/main/docs/agents/index.md

Install the default JSON schema extension for the Pi agent using its package manager. This enables structured output for classifier jobs.

```bash
pi install npm:@nqbao/pi-json-schema
```

--------------------------------

### Configure Review Guidelines in TOML

Source: https://github.com/kenn-io/roborev/blob/main/docs/guides/reviewing-code.md

Set project-specific or global review guidelines using TOML configuration files. Guidelines provide context to reviewers.

```toml
# ~/.roborev/config.toml
review_guidelines = """
Prefer concrete, actionable findings.
Do not flag localhost-only data paths as remote trust boundaries.
"""

# .roborev.toml
review_guidelines = """
This repo has no production database yet.
Public APIs must keep backward-compatible JSON fields.
"""
```

--------------------------------

### Install Roborev Post-Commit Hook

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Navigate to your repository and install the post-commit hook to enable automatic code reviews. You can also specify a binary path if Roborev is managed by a version manager.

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

```bash
roborev init --binary ~/.local/share/mise/shims/roborev
```

```bash
roborev agent-hook install --binary ~/.local/share/mise/shims/roborev
```

--------------------------------

### Install Roborev Agent Hook

Source: https://github.com/kenn-io/roborev/blob/main/README.md

Install the agent hook to enable a mid-session fix loop, allowing roborev to interact with your AI coding agent during development. This is the second layer of automation.

```bash
roborev agent-hook install    # layer 2: mid-session fix loop
```

--------------------------------

### List All Configuration Values

Source: https://github.com/kenn-io/roborev/blob/main/docs/configuration.md

List all configuration values. By default, it shows merged effective values. Use --global or --local to list values from specific config files. The --show-origin flag indicates where each value is sourced from.

```bash
roborev config list                    # merged config (effective values)
roborev config list --global           # global config only
roborev config list --local            # repo config only
roborev config list --show-origin      # show where each value comes from
```

--------------------------------

### Verify post-commit hook installation

Source: https://github.com/kenn-io/roborev/blob/main/docs/guides/troubleshooting.md

Check if the roborev post-commit hook is installed and contains the necessary enqueue call. This script resolves the hooks path correctly, even with linked worktrees.

```bash
# Resolves core.hooksPath (relative or absolute) against the main
# repo root, falling back to .git/hooks. Works from linked worktrees.
COMMON="$(git rev-parse --path-format=absolute --git-common-dir)"
HP="$(git config core.hooksPath || true)"
if [ -n "$HP" ]; then
  case "$HP" in /*) HOOKS="$HP" ;; *) HOOKS="${COMMON%.git}/$HP" ;; esac
else
  HOOKS="$COMMON/hooks"
fi
cat "$HOOKS/post-commit"
```

```bash
#!/bin/sh
# roborev post-commit hook - auto-reviews every commit
roborev enqueue --quiet 2>/dev/null
```

--------------------------------

### Inject Standing Instructions for Reviews

Source: https://github.com/kenn-io/roborev/blob/main/docs/configuration.md

Use repository-specific review guidelines to inject standing instructions for every review, such as enforcing testing requirements.

```toml
review_guidelines = """
Every change to UI components must include or update a Playwright e2e test.
Flag any PR that changes UI without a corresponding e2e test.
"""
```

--------------------------------

### Design Review Against Specific Base Branch Example

Source: https://github.com/kenn-io/roborev/blob/main/internal/skills/codex/roborev-design-review-branch/SKILL.md

Illustrates initiating a design review against a specific base branch. The process includes validating the base branch ref and then executing the review command with the specified base.

```bash
$roborev-design-review-branch --base develop
```

--------------------------------

### Install Agent Hook for Specific Agent

Source: https://github.com/kenn-io/roborev/blob/main/docs/agent-hook.md

Installs agent-hook entries for a specific agent harness, either 'codex' or 'claude'. Use --dry-run to preview changes without writing.

```bash
roborev agent-hook install --agent codex
```

```bash
roborev agent-hook install --agent claude
```

--------------------------------

### List Roborev Repository Commands

Source: https://github.com/kenn-io/roborev/blob/main/docs/guides/repository-management.md

Provides a quick overview of available repository management commands in roborev.

```bash
roborev repo list                     # List all repos with review counts
roborev repo show my-project          # Show repo details and stats
roborev repo rename old-name new-name # Rename display name
roborev repo move my-repo .           # Update root path after a directory move
roborev repo delete old-project       # Remove from tracking
roborev repo merge source target      # Merge reviews into another repo
```

--------------------------------

### GitHub App Configuration for Multiple Installations

Source: https://github.com/kenn-io/roborev/blob/main/docs/integrations/github.md

Configure Roborev with a GitHub App to manage multiple installations across different organizations or users. This allows for centralized management of reviews for diverse repositories.

```toml
[ci]
enabled = true
poll_interval = "5m"
repos = ["wesm/my-project", "roborev-dev/core", "roborev-dev/docs"]
review_types = ["security"]
agents = ["codex"]

github_app_id = 123456
github_app_private_key = "~/.roborev/roborev.pem"

# Each org/user has its own app installation
[ci.github_app_installations]
wesm = 111111
roborev-dev = 222222
```