setup-pr-review git:20260408.eb2947bA

Immutable. This exact content is served forever at /api/v1/blob/70b8d5fb44619412.

---
name: setup-pr-review
description: Set up the OpenHands automated PR review workflow in a GitHub repository. Creates the workflow file and asks the user for configuration preferences. Use when a user wants AI code review on their pull requests.
triggers:
- setup-pr-review
- set up pr review
- add code review workflow
- openhands pr review
---

# Set Up OpenHands PR Review

Add the PR review workflow to a GitHub repository so an OpenHands agent can
review pull requests and post inline comments.

**Docs**: https://docs.all-hands.dev/sdk/guides/github-workflows/pr-review

## Step 1: Create the workflow file

Create `.github/workflows/pr-review.yml` in the target repo. Fetch the latest
example from https://docs.all-hands.dev/sdk/guides/github-workflows/pr-review
and use it as the starting template. The workflow calls the
`OpenHands/extensions/plugins/pr-review` composite action directly.

## Step 2: Configure the LLM

Ask the user whether they are using the **OpenHands app** (app.all-hands.dev)
or their **own LLM provider** (e.g. Anthropic, OpenAI directly).

### OpenHands app (default)

OpenHands app users already have access to an LLM API key through the
OpenHands litellm proxy. Tell them:

> Go to https://app.all-hands.dev → Account → API Keys → OpenHands LLM Key, and copy your key.
> Then add it as a GitHub repository secret:
> Settings → Secrets and variables → Actions → New repository secret.
> Name it `LLM_API_KEY`.

Set these inputs in the workflow `with:` block:
- `llm-model: litellm_proxy/claude-sonnet-4-5-20250929`
- `llm-base-url: https://llm-proxy.app.all-hands.dev`

### Own LLM provider

If the user has their own API key (e.g. from Anthropic or OpenAI), tell them
to add it as a repository secret named `LLM_API_KEY` using the same path
above. Leave `llm-base-url` unset and set `llm-model` to the provider-prefixed
model name (e.g. `anthropic/claude-sonnet-4-5-20250929`).

**You cannot create secrets — the user must do it manually.** Do not ask for
the key value. Just tell them where to put it.

## Step 3: Ask the user for preferences

Present these options and apply any requested changes to the workflow file:

**Review style** (default: `roasted`)
- `roasted` — Linus Torvalds-style, blunt, focuses on data structures and
  simplicity.
- `standard` — balanced, covers style/readability/security.

**When to trigger** (default: on-demand only)
- On-demand: add `review-this` label or request `openhands-agent` as reviewer.
- Automatic: review every new PR. Add `opened` and `ready_for_review` to
  `on.pull_request.types` and matching conditions to the `if:` block.

After applying these, ask the user if they want to explore additional options
(model selection, evidence requirements, custom review skills, observability).
If yes, walk them through it — use the docs as a reference:
https://docs.all-hands.dev/sdk/guides/github-workflows/pr-review
If not, you're done.