Getting started
From zero to your first reviewed pull request: install the app, start your trial with review agents ready to go, get your first review — then fine-tune routing and connect your own keys.
1. Install the GitHub App
PURA is a GitHub App. Install it and choose the repositories you want it to review — you can pick specific repos or your whole organization, and change the selection any time from GitHub.
Your account is created automatically. The first time you install PURA, it sets up an account for your organization on a 1-month free trial — so you can start reviewing before you think about billing.
2. Your trial is active
Every new account begins on a 1-month free trial — and your trial comes ready to review, with two Active review agents already set up, running on PURA's trial model:
- Code Review Agent — reviews the code in your pull requests.
- PR Quality Review Agent — checks each pull request's title, description, and commit messages, reporting into the PR Overview Comment.
No API key is needed to get started — the trial agents run on PURA's trial model, so you can review from day one. If the trial ends without a paid plan, reviews pause until you choose one; nothing else changes. PURA's plans are billed separately — see pricing.
Sign in to the dashboard with GitHub. Manage everything — review agents, budgets, and analytics — at app.pura.sh.
3. Perform your first review
Open a pull request, then comment /pura review on it. PURA picks the right models, reviews the change, and posts a single, consolidated review:
🔴 **P1 · Guard against negative quantity**
_Detail:_ `computeTotal` multiplies price by qty without checking `qty >= 0`, so a crafted payload can produce a negative total.
```suggestion
const qty = Math.max(0, item.qty);
```
<details>
<summary>Notes</summary>
- `/pura ignore` — ignore this comment for this PR
- `/pura ignore always` — ignore this comment for all PRs
- id: `9f2c4b7e-1a8d-4e02-b6c3-f5a7d9e10b24`
</details>When the PR opens, PURA also pins a PR Overview Comment to it — the single place on the PR that tracks the current review state, cumulative totals per agent, and the available commands. Need a fresh pass after new commits? Just comment /pura review again — or push, and PURA re-reviews automatically.
4. Steer routing (optional)
By default, every eligible agent reviews every PR with its default model. To steer which PRs each agent covers and which model tier it uses, commit a Review Skill for the agent — a SKILL.md file in your repo — with plain-English .pura-routing instructions. Write intent, not configuration: for example, “use this only for nodejs files” or “for large changes, use the high model”. Routing is optional — without it, every eligible agent reviews with its default model.
See Configuration — Review Skills & routing for the full guide, including where to save the skill file and how routing decisions are made.
5. Bring your own key
Your trial agents run on PURA's trial model, so you can review from day one without any keys. When you're ready, add your own Claude, OpenAI, or Gemini API keys to your agents in the dashboard. Keys are encrypted when you save them and are never shown again — inference is billed straight to your provider account at their published rates, and PURA never marks it up.
See Configuration — Providers & your keys to connect your first provider.