Getting started
From zero to your first reviewed pull request: install the app, start your trial, create a review agent with your own AI key, and ask PURA to review a PR.
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. Start your free trial
Every new account begins on a 1-month free trial on the Starter plan. During the trial — and on any active paid plan — PURA reviews your pull requests normally. If the trial ends without a paid plan, reviews pause until you choose one; nothing else changes.
You bring your own AI provider key, so the model itself is billed by your provider. 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. Create your first review agent
A review agenttells PURA which AI to use and how much you're willing to spend. Open the dashboard and create one — it takes a minute:
- Give the agent a name and leave it Active.
- Set your budgets — daily, weekly, and monthly limits in USD. PURA stops before it crosses them.
- Add a provider: choose Claude, OpenAI, or Gemini, paste your own API key, and pick the model(s) you want to use.
That's the minimum. With one Active agent that has a working key, PURA can review any PR in your installed repos.
Your key stays yours. Provider keys are encrypted when you save them and are never shown again or marked up — inference is billed straight to your provider account.
4. Steer routing (optional)
By default PURA picks a sensible model for every PR. To guide it, add a plain-English .pura/PURA.md file to a repo describing what each kind of change needs. Write intent, not configuration:
# PURA Review Routing
- Payments or billing changes: use a top-tier model.
- Product and backend changes: a balanced model is fine.
- Docs, typos, and dependency bumps: a lean model is enough.PURA reads this to decide how much firepower each PR deserves, then matches it to the best agent you've set up. You can also scope agents to specific teams, repos, authors, or PR labels in the dashboard — see Configuration.
5. Request your first review
Open a pull request, then comment /pura review on it. PURA picks the right model, reviews the change with your key, and posts a single, focused review:
PURA Review • 1 finding
Must fix · Guard against negative quantity
`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);
```Need a fresh pass after new commits? Just comment /pura review again. Head to Usage to learn how to read a review, or Configuration to fine-tune routing and budgets.