Docs
Getting started
Install the GitHub App, run your first review on the trial agents, then add your own instructions and API keys.
1. Install the GitHub App
PURA is a GitHub App. Install it on your whole organization or on selected repositories. You can change the selection any time in GitHub.
Install on GitHubYour account is created for you. The first install sets up an account for your organization on a 1-month free trial.
2. Your trial is ready to review
Every new account starts on a 1-month free trial with two active review agents that run on PURA's trial model, so you need no API key on day one:
- Code Review Agent (
code-review-agent) reviews the code in your pull requests. - PR Quality Review Agent (
pr-quality-review-agent) reviews each pull request's title, description, labels and commit messages.
Both come with daily, weekly and monthly budgets already set. You can rename them, give them your own keys and models, or scope them to the teams and repositories you choose. Pick a plan any time before the trial ends to keep reviews running. See pricing.
Sign in with GitHub. Org owners and members of your org's pura-admins team can manage agents, budgets and analytics at app.pura.sh.
3. Run your first review
Open a pull request. PURA reviews it automatically, with no command needed, and posts one consolidated review with findings anchored to the lines they refer to:
🔴 **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>PURA also adds a PR Overview Comment when the pull request opens. It shows the current review state, totals per agent and the available commands. PURA reviews again on every push. To run a review on demand, comment /pura review.
4. Tell each agent how to review (optional)
Each agent follows its own review-agent skill: a SKILL.md file in .agents/skills/<agent-name>/ on your default branch. Write what the agent should look for and what it should ignore. Add a .pura-routing line to say, in plain English, when it should review and which model tier to use, for example “for large changes, use the high model”.
Without a skill, every agent reviews with built-in instructions and its default model. See Skills and routing for the full guide.
5. Bring your own key
When you're ready, add your own Anthropic, OpenAI or Google API key to your agents in the dashboard. Keys are encrypted when you save them. Your provider bills inference directly at its published rates, with no markup from PURA.
See Providers and your keys to connect your first provider.
Next