> For the complete documentation index, see [llms.txt](https://help.swarmia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.swarmia.com/features/ai-tools/review-agents.md).

# Review agents

## What is a review agent?

A review agent is an AI tool that automatically reviews pull requests — leaving comments, flagging potential issues, and suggesting improvements — without creating any code itself. Unlike [cloud agents](/features/ai-tools/cloud-agents.md), which author PRs from start to finish, review agents act as an additional reviewer on top of your existing pull request process.

### Examples of review agents

* [**GitHub Copilot code review**](https://docs.github.com/en/copilot/using-github-copilot/code-review/using-copilot-code-review) can review pull requests directly on GitHub and leave inline suggestions.
* [**Cursor Bugbot**](https://cursor.com/bugbot) scans pull requests for bugs and posts a summary to the PR description.
* [**Claude Code**](https://code.claude.com/docs/en/code-review) can review pull requests when triggered via GitHub Actions or mentioned in a PR.

## Understanding your review agent coverage

Swarmia automatically detects pull requests reviewed by GitHub Copilot, Cursor, or Claude Code and shows them in the [**AI tools → Review agents**](https://app.swarmia.com/ai/reviews).

<figure><img src="/files/RBUwqS1nbvMDiZvn5qBr" alt=""><figcaption></figcaption></figure>

### Agent-reviewed PRs

The **Agent-reviewed PRs** chart shows the share of your pull requests that received at least one review agent comment over time. The stacked bars distinguish PRs reviewed by an agent from those that weren't, and the review ratio makes it easy to track adoption across your organization.

Use this chart to understand whether review agent usage is growing and to spot teams that haven't adopted them yet.

### Findings per PR

The **Findings per PR** chart shows the distribution of pull requests by the number of comments review agents left on them. "Findings" are individual review comments or suggestions from the agent — not just a summary at the top level.

A healthy distribution means agents are leaving substantive feedback rather than just passing PRs silently. If you see a spike at zero findings, it may mean agents are being triggered but not surfacing meaningful feedback.

### Tabs: Teams, pull requests, and review agents

The table below the charts has three tabs:

* **Teams**: Breaks down agent-reviewed PRs, coverage percentage, total findings, and findings per PR by team. Useful for comparing adoption across your organization.
* **Pull requests**: Lists individual PRs with the agents that reviewed them and how many findings each agent left. Use this together with the PR filters to inspect specific repositories or time ranges.
* **Review agents**: Shows per-agent stats — how many PRs each agent reviewed, their share of total PRs, and their average findings per PR.

## Frequently asked questions

### Which review agents does Swarmia support?

Swarmia currently detects reviews from GitHub Copilot, Cursor, and Claude Code. If you're using a review agent that isn't showing up, reach out to us at <hello@swarmia.com> with the agent's GitHub account or email and an example pull request.

### How does Swarmia detect review agents?

Swarmia identifies a review agent by matching the author of review comments against known email addresses and GitHub login patterns for GitHub Copilot, Cursor, and Claude Code.

Read more about [automatic AI tool detection](/features/ai-tools/ai-tool-detection-and-filters.md#review-agent).

### How is this different from cloud agents?

[Cloud agents](/features/ai-tools/cloud-agents.md) create pull requests end-to-end. Review agents only leave feedback on pull requests created by humans (or cloud agents). The two can overlap: a cloud agent PR can also be reviewed by a review agent.

Swarmia tracks them separately so you can understand each type of AI involvement in your workflow.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.swarmia.com/features/ai-tools/review-agents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.