setup-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.