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