Robin docs: AI code review in GitHub Actions

Robin adds AI code review to a repository as a reusable GitHub Actions workflow. You add one workflow file and three secrets; Robin reviews every pull request with the LLM you choose, using your own API key. Setup takes a few minutes — here's the whole thing.

Quickstart

Run from the root of the Git repository you want Robin to review. The workflow and secrets are per repository; the companion agent skill is global per machine.

Do not run the installer from your home directory.

Install with npx — it adds the workflow file to the current repository:

npx robin-review

No npm? Install with curl instead (read the script first at /script):

curl -fsSL https://robinreview.dev/install.sh | bash

Run an installer separately in every repository that should use Robin. Re-running it keeps one canonical .github/workflows/robin.yml, archives recognized historical variants where GitHub cannot trigger them, and updates the global companion skill. Inspect and remove archived copies after confirming the migration.

Or add it manually — create .github/workflows/robin.yml:

name: Robin

on:
  pull_request:
    types: [opened, reopened, ready_for_review]
  issue_comment:
    types: [created]

permissions:
  actions: read
  contents: read
  pull-requests: write

jobs:
  review:
    uses: antongulin/robin/.github/workflows/review.yml@v1
    secrets:
      LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
      LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
      LLM_MODEL: ${{ secrets.LLM_MODEL }}

The three secrets

In your repo, go to Settings → Secrets and variables → Actions and add:

LLM_API_KEY — your provider API key.
LLM_BASE_URL — the provider's OpenAI-compatible base URL.
LLM_MODEL — the model to review with.

That's the only configuration Robin needs to start reviewing.

Choosing an LLM provider

Robin works with any OpenAI-compatible endpoint. Common choices for LLM_BASE_URL:

Provider	`LLM_BASE_URL`	Notes
OpenRouter (free models)	`https://openrouter.ai/api/v1`	Free-tier models available — run Robin at $0.
OpenAI	`https://api.openai.com/v1`	e.g. a small, fast model for cheap reviews.
Groq	`https://api.groq.com/openai/v1`	Fast inference on open models.
Ollama (self-hosted)	`http://localhost:11434/v1`	Fully local; requires a self-hosted runner.

Set LLM_MODEL to any model that provider offers. If you're cost-sensitive, start with a free OpenRouter model and upgrade only if you want stronger reviews.

Commands

By default Robin reviews once when a pull request opens. You can also comment:

/robin — run another review pass (after pushing fixes).
/summary — a short overview of the PR.
/help — list available commands.

Fork pull requests

GitHub does not expose repository secrets to workflows triggered by fork PRs, so Robin can't auto-review an external contributor's PR. After you've looked it over, comment /robin on the PR to run the review with your secrets. This is standard GitHub Actions security behavior, not a Robin limitation.

Pinning a version

The workflow references @v1. Pin to a specific release tag if you want fully reproducible runs and to control when you pick up changes. See the repository for the list of releases.

Going further

Advanced configuration — self-hosted runners, strict mode, and custom rules — is documented in the repository:

New to the idea? See what Robin is or read the blog.