> 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/cloud-agents.md).

# Cloud agents

Gain visibility into the pull requests created by AI agents running in the cloud. See how they perform across metrics like throughput, merge percentage, and batch size.

## What is a cloud agent?

Cloud agents are AI coding agents responsible for creating pull requests end-to-end — planning work, editing code, running tests, and responding to reviews — not just suggesting code in your editor.

Most often, users assign AI cloud agents individually from issue trackers or prompt them to create a single pull request. AI cloud agents can also be autonomous, in which case they will have a backlog or objective and continuously pick work items on their own.

### Built-in cloud agents

* [**GitHub Copilot cloud agent**](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent) can create pull requests from [various sources](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent), including IDEs, GitHub.com, GitHub issues, GitHub Mobile, CLI, and MCP.
* [**Cursor Cloud Agents**](https://cursor.com/docs/cloud-agent) can create pull requests from [cursor.com/agents](https://cursor.com/agents), or you can trigger them via integrations, such as [Slack](https://cursor.com/docs/integrations/slack) and [Linear](https://cursor.com/docs/integrations/linear).
* [**Claude Code GitHub Actions**](https://code.claude.com/docs/en/github-actions) can create pull requests when you mention `@claude` in PRs or issues.
* [**Claude Code on the web**](https://code.claude.com/docs/en/claude-code-on-the-web) is available in research preview to selected pricing plans and can create pull requests from [claude.ai/code](https://claude.ai/code).
* [**Claude by Anthropic**](https://github.blog/changelog/2026-02-04-claude-and-codex-are-now-available-in-public-preview-on-github/) GitHub partner agent can create PRs from github.com, GitHub Mobile, and VS Code.
* [**Codex cloud**](https://developers.openai.com/codex/cloud) can create pull requests from [chatgpt.com/codex](https://chatgpt.com/codex), the Codex CLI and IDE extension, and integrations such as GitHub, Slack, and Linear.
* [**CodeRabbit**](https://www.coderabbit.ai) is primarily a [review agent](/features/ai-tools/review-agents.md), but it can also open a pull request directly, for example to apply a fix it suggested during review. Swarmia attributes those PRs as CodeRabbit cloud agent PRs.

Don't see your tool? [Add it as a custom AI tool](/settings/integrations/ai-coding-tool-integrations/custom-ai-tool-integrations.md#link-contributors) to get the same detection.

## Cloud agent PRs in Swarmia

In Swarmia, pull requests authored by AI tools are attributed to the people who initiated them. For example, if GitHub Copilot creates a PR on your behalf, Swarmia shows you as its author.

The AI coding agent used to create a pull request is shown on top of the pull request author’s avatar.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FqJo5rKNMUDqSyQ0awW1l%2F004298%402x.png?alt=media&amp;token=c7a36db7-4790-48d5-81d4-e24e0772ef9d" alt=""><figcaption></figcaption></figure>

Swapping the author affects the whole app: the pull request counts toward the person's team, their contribution stats, and their [work log](/features/focus/analyzing-the-activity-patterns-on-work-log.md). The agent stays visible through the badge on the author's avatar and the *cloud agent* AI tool tag. Commits keep their original author, which is what the [agent commit percentage](#agent-commit-percentage) chart measures.

## Understanding your cloud agent performance

To help you understand how your AI cloud agents are performing, Swarmia automatically detects pull requests created by any of the cloud agents above, as well as any [custom AI tool](/settings/integrations/ai-coding-tool-integrations/custom-ai-tool-integrations.md#link-contributors) you've linked a contributor to. Swarmia provides a dedicated [**cloud agents**](https://app.swarmia.com/ai/agents/agents) (previously called "coding agents") view for analyzing them.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2F6fprBIsK6G6V3BejQGsT%2F004310%402x.png?alt=media&amp;token=7efd8b06-a8f6-43f5-a9bf-95cc129ad78f" alt=""><figcaption></figcaption></figure>

### Agent PR throughput

The Agent PR throughput chart shows how much work AI cloud agents help you ship.

**Agent PRs**, **Merged**, and **Closed** show the raw number of AI cloud agent pull requests.

**Merge percentage** tells you about your conding agent performance and how effectively people are able to use agents. Ideally, the number should grow close to 100%, but never quite reach it. Even though every closed pull request is technically waste (i.e., work done that was never shipped), a small percentage of closed pull requests indicates that people are experimenting with AI cloud agents and pushing their limits.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FX5IwU4RvlErz8Ia35zPQ%2F127.0.0.1_9002_ai_agents_agents_teamId%3D4d9361ab-3217-4690-957e-ca69abe9ca07%26tab%3DPull%2Brequests%26featureGates%3DAiAgentsView%20(1).png?alt=media&amp;token=995d2ca8-452d-4e3c-bebd-1db2a6283d7f" alt=""><figcaption></figcaption></figure>

### Agent commit percentage

The **Agent commit percentage** chart breaks down your merged pull requests based on how much human intervention was needed for the work to be shipped.

Ideally, all your agent pull requests would have 100% agent commits, which means that the person was able to complete the whole task through the agent interface (e.g., GitHub Copilot's pull request integration). If a pull request ends up in the other buckets, it means that someone needed to pull up their coding environment and commit code to finish the work.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FvHpcP0gnjtIMhp5tXEJq%2F127.0.0.1_9002_ai_agents_agents_teamId%3D4d9361ab-3217-4690-957e-ca69abe9ca07%26featureGates%3DAiAgentsView.png?alt=media&amp;token=0f841084-737a-48c0-8403-98fe421e7cb4" alt=""><figcaption></figcaption></figure>

### Batch size

The **Batch size** chart helps you compare the distribution of AI cloud agent pull requests with your overall [Batch size](https://app.swarmia.com/metrics/code/batch-size) metrics. It also gives you an indication of the complexity of work AI cloud agents can tackle.

Depending on how you start using AI cloud agents, you might see that most agent pull requests initially fall in the smallest 1–5 or largest 500+ buckets. As your AI cloud agent usage develops, you should see the distribution move toward the buckets in the middle. This means your agents can tackle tasks of all sizes and ship code in manageable increments.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2F6IZGP6KLhJ4L5Y581wLk%2F127.0.0.1_9002_ai_agents_agents_teamId%3D4d9361ab-3217-4690-957e-ca69abe9ca07%26featureGates%3DAiAgentsView%20(1).png?alt=media&amp;token=86a17c69-9ff5-4f0f-8665-1e8b19ad86c6" alt=""><figcaption></figcaption></figure>

### Teams breakdown

The "Teams" tab provides a breakdown of the core metrics shown in the top charts, grouped by team.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FTpSzl2JUUfia7Q1om38U%2F127.0.0.1_9002_ai_agents_agents_teamId%3D4d9361ab-3217-4690-957e-ca69abe9ca07%26featureGates%3DAiAgentsView%20(2).png?alt=media&amp;token=093c59ae-aa59-4da9-b1a5-b403b258e977" alt=""><figcaption></figcaption></figure>

### Pull requests tab

You can use the "Pull requests" tab in combination with the pull request filters at the top to inspect the individual agent pull requests.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FwbtXuDcrSnyuQfOMTxkD%2F127.0.0.1_9002_ai_agents_agents_teamId%3D4d9361ab-3217-4690-957e-ca69abe9ca07%26featureGates%3DAiAgentsView%20(3).png?alt=media&amp;token=9ecce2bd-ca28-4390-8989-dabd949359bb" alt=""><figcaption></figcaption></figure>

## Filtering PRs from cloud agents

You can use *cloud agent* mode in the [AI tool filter](/features/ai-tools/ai-tool-detection-and-filters.md#ai-tool-filter) to view pull requests created by cloud agents across the Swarmia app.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FLRERxanV5YVRjydJvhAW%2F004302%402x.png?alt=media&amp;token=c796ecd6-5b0b-4433-9d22-907cbdf1537d" alt=""><figcaption></figcaption></figure>

## Frequently asked questions

### Which AI cloud agents does Swarmia support?

We have built-in support for the cloud agents listed [above](#built-in-cloud-agents). For any other cloud agent, or one you've built yourself, you can [add it as a custom AI tool and link its contributor](/settings/integrations/ai-coding-tool-integrations/custom-ai-tool-integrations.md#link-contributors). Swarmia then attributes its pull requests to it with high confidence, the same way it recognizes the built-in agents.

### How do you identify PRs created with cloud agents?

Swarmia attributes a PR to a cloud agent if the PR or its first commit has been authored by one of the cloud agents listed [above](#built-in-cloud-agents), or a contributor linked to a [custom AI tool](/settings/integrations/ai-coding-tool-integrations/custom-ai-tool-integrations.md#link-contributors).

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

### Who is the author of a cloud agent PR?

The person who started the agent, not the agent's bot account. Swarmia identifies them from the commit co-authors, or from the person the agent assigned to the pull request. Read more about [how Swarmia finds the person behind an agent PR](#how-swarmia-finds-the-person-behind-an-agent-pr).

### Why does a cloud agent PR show the agent as the author instead of a person?

Swarmia couldn't find the human behind it. That happens when:

* The agent neither credited a co-author on the first two commits nor assigned anyone to the pull request.
* The only human co-author appears on the third commit or later.
* The pull request is a GitLab merge request, where Swarmia relies on commit co-authors alone.

Read more about [how Swarmia finds the person behind an agent PR](#how-swarmia-finds-the-person-behind-an-agent-pr).

### Why is my PR not attributed to a cloud agent?

Swarmia attributes a PR to a cloud agent if the PR or its first commit has been authored by one of the cloud agents listed [above](#built-in-cloud-agents).

Example 1: With [GitHub Copilot coding agent](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent), GitHub shows *Copilot* as the PR author. Swarmia shows this as a GitHub Copilot agent PR:

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FTWx9fyT3ujXAYKK0qXnE%2F003555%402x.png?alt=media&amp;token=15aca564-cdd7-4bff-8329-1391f3b6d2b4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note: Regardless of what GitHub displays, Swarmia always shows the author as the person who initiated the AI coding agent PR.
{% endhint %}

Example 2: When using [Cursor Cloud Agents](https://cursor.com/docs/cloud-agent), GitHub shows *cursoragent* as the author of the first commit, and the user who started the agent as the PR author. Swarmia shows this as a Cursor agent PR:

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2FPaIEEcLnG09Sx0IrUGZa%2F003554%402x.png?alt=media&amp;token=c9eb6b9d-7cb6-47a0-a58a-9215d3bbee70" alt=""><figcaption></figcaption></figure>

Example 3: The first commit in this PR was authored by *Claude* but committed by *cursoragent*. Swarmia shows this as a Claude Code agent PR:

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2Fcw8CMcSjcmJP4maY2PqE%2F003647%402x.png?alt=media&amp;token=619a1644-bd84-4ab3-b2b7-0ebcec590f03" alt=""><figcaption></figcaption></figure>

### If I ask an AI tool to create a PR with my local changes, is it considered a cloud agent PR?

No, we don't regard that as a cloud agent PR since you review and accept the suggestions (and perhaps manually write some of the code) before creating the PR.

The AI tool uses your local Git identity, so you are marked as the PR author and the commit author. (The tool might mark itself as the co-author, however.)

Swarmia shows these PRs as [AI-assisted](/features/ai-tools/ai-tool-detection-and-filters.md#ai-assisted).

### How does Swarmia attribute GitHub partner agents?

The [Claude by Anthropic and Codex by OpenAI](https://github.blog/changelog/2026-02-04-claude-and-codex-are-now-available-in-public-preview-on-github/) GitHub partner agents can create PRs from github.com, GitHub Mobile, and VS Code. Although you pay for them through the GitHub Copilot billing, Swarmia attributes them as the Claude Code and Codex cloud agents, because that's the harness each one runs.

### How does Swarmia find the people behind custom agent PRs?

If a PR is opened by a (bot) contributor linked to a [custom AI tool](/settings/integrations/ai-coding-tool-integrations/custom-ai-tool-integrations.md#link-contributors), Swarmia looks for the person who started the agent in two places:

1. **Commit co-authors.** The first non-bot author credited in a `Co-authored-by` trailer on the pull request's first two commits. Swarmia checks two commits because some agents start with a planning commit that has no co-author.
2. **Assignment by the agent.** If no co-author turns up, Swarmia looks for the first person the agent itself assigned to the pull request. Assignments made by anyone other than the agent that opened the PR are ignored, and this signal is available on GitHub only.

If neither finds a human, the pull request stays attributed to the agent's bot account.

### What if there isn't a single person behind my cloud agent PR?

Autonomous agents might create pull requests without a person to attribute them to. These pull requests stay attributed to the agent's bot account and don't appear in team-scoped views unless the bot belongs to a team.

To analyze this work, you can create an **Agents** team and add the bot contributor to it. The pull requests will then appear in that team's metrics and other team-scoped views. [Bots can be team members](/settings/organization/contributors.md#what-doesnt-change), just like people.

## Further reading

Swarmia blog: [Five levels of AI coding agent autonomy, and why higher isn’t always better](https://www.swarmia.com/blog/five-levels-ai-agent-autonomy/) by Miikka Holkeri, Product Manager · Mar 19, 2026


---

# 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/cloud-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.