GitHub Copilot cloud agent
GitHub's background coding agent that plans, edits a branch and opens pull requests.
Group: Coding agents
GitHub's docs say Copilot cloud agent can research a repository, make an implementation plan and change code on a branch, then let you review the diff, iterate and create a pull request. It works in its own ephemeral environment powered by GitHub Actions, where it can run tests and linters.
The decision in plain English
A good fit for bounded tasks in a GitHub repository with clear acceptance tests and a reviewer. Distinguish cloud agent from local IDE agent mode: cloud work runs in an Actions-powered environment and uses both AI credits and Actions minutes. Before enabling it, check repository policy, workflow approval, firewall scope and MCP access. A firewall is not a guarantee that every process is isolated.
Best fit
Teams already on GitHub that can split work into single-repository tasks, review generated changes and run checks before a human merges the pull request.
Poor fit
Cross-repository changes in one task, non-GitHub hosting, or teams expecting the agent to merge changes without a human. Also a poor fit if setup steps or MCP access cannot be reviewed before granting access.
Documented capabilities
Vendor statements, not verified task outcomes.
- Research, plan and change one GitHub repository in an Actions-powered environment Source · checked 2026-10-22
- Human PR review and restricted branch writes Source · checked 2026-10-22
- Default firewall with explicit MCP and setup-step exclusions Source · checked 2026-10-22
- Default code, dependency and secret checks before completing work Source · checked 2026-10-22
Permissions and human control
- Only users with repository write access can trigger the agent. It writes to one branch: the existing PR branch for an @copilot PR task, otherwise a new copilot/ branch. Branch protections and required checks still apply.
- GitHub documents human review and merge: the agent cannot approve or merge a pull request or mark its own draft ready for review. The user who requested the PR cannot supply its required approval.
- By default, PR Actions workflows wait for a person with write access to click Approve and run workflows. Administrators can allow automatic runs, so confirm the actual repository policy before relying on that gate.
- The default firewall covers processes the agent starts through its Bash tool inside the Actions appliance. It does not cover MCP servers or configured setup-step processes, and GitHub warns that sophisticated attacks may bypass it. Inspect allowed domains, setup scripts and MCP access separately.
- Protect Copilot and MCP configuration files with CODEOWNERS and review rules. GitHub distinguishes ordinary Actions secrets from Agents secrets and variables deliberately provided to the cloud agent; grant only the data a task needs.
Documented controls do not prove that an agent always follows them.
Limits and open questions
- Cloud agent requires a paid Copilot plan; the Free plan is not a free cloud-agent tier
- Uses both GitHub AI credits and GitHub Actions minutes; subscription price alone is not a per-task cost
- One repository and one branch per task; one pull request; maximum session duration 59 minutes
- MCP settings can broaden repository context; default firewall does not cover MCP servers or setup steps
- Branch rules can block the agent; do not remove review requirements merely to make a task run
- Plans table total credits and Max FAQ base-credit wording differ; variable Flex allotments can change. Verify the actual account allowance.
- Vendor documentation, not a hands-on test or security audit
Privacy and security
Re-verified 22 October 2026 against GitHub's responsible-use docs for Copilot agents: the cloud agent runs in an ephemeral development environment with a network firewall ENABLED BY DEFAULT that blocks outbound connections to unauthorised hosts against code/data exfiltration; automated security scanning runs on its output; work lands as pull requests for human review and iteration. The doc does not state a prompt/code retention period for the cloud agent. Vendor documentation, not independently audited.
Feature-by-feature: what is documented and what is not
Official sources checked 22 October 2026. A documented feature is a vendor statement, not proof of success.
| Feature | Evidence status | Detail and limit |
|---|---|---|
| Runtime | Cloud, not IDE mode | An ephemeral GitHub Actions environment can research, plan and change code. Local IDE agent mode has a different execution environment. Source |
| Planning entry points | Channel-dependent | Research/plan/iterate before a PR works on GitHub.com; Teams/Slack support is public preview. Other integrations can create a PR directly. Source |
| Branch and merge | Human review | Only repository writers can trigger it. It writes one branch and cannot approve, merge or mark its draft ready. The requesting user cannot supply required approval. Source |
| Workflow approval | Default can change | PR workflows wait for Approve and run workflows by default; administrators can allow automatic runs. Verify the actual policy. Source |
| Firewall coverage | Limited boundary | Firewall covers agent Bash processes in the Actions appliance, not MCP servers or setup-step processes. GitHub warns sophisticated attacks may bypass it. Source |
| Code checks | Defaults, not guarantees | CodeQL, dependency advisory checks and secret scanning are documented defaults that can be disabled. Review output yourself; checks do not prove safe code. Source |
| Task bounds | One repository | One repository, one branch and one PR per task; maximum execution time is 59 minutes. Split larger work without removing review requirements. Source |
| Usage costs | Two budgets | Cloud agent is on paid Copilot plans and consumes AI credits plus Actions minutes. Subscription price is not a per-task total; check both allowances. Source |
How to start with GitHub Copilot cloud agent narrowly
- Use one repository with a reviewer and clear acceptance tests; check paid-plan and repository policy.
- Review setup steps, MCP scope, firewall allowlist and configuration-file ownership.
- Set AI-credit and Actions-minute budgets and start one task under the session limit.
- Check diff/security results and actual workflow approval policy before a human reviews and merges.
Official product/setup source. These are documentation-based steps, not a hands-on setup test.
Common questions about GitHub Copilot cloud agent
What is GitHub Copilot cloud agent for?
Teams already on GitHub that can split work into single-repository tasks, review generated changes and run checks before a human merges the pull request. The vendor describes it as: GitHub's docs say Copilot cloud agent can research a repository, make an implementation plan and change code on a branch, then let you review the diff, iterate and create a pull request. It works in its own ephemeral environment powered by GitHub Actions, where it can run tests and linters.
Who should look elsewhere?
Cross-repository changes in one task, non-GitHub hosting, or teams expecting the agent to merge changes without a human. Also a poor fit if setup steps or MCP access cannot be reviewed before granting access.
How much does GitHub Copilot cloud agent cost?
Individual subscriptions list Pro $10, Pro+ $39 and Max $100 per user/month. The plans table lists $15 / $70 / $200 total monthly credits, including variable Flex allotments, while its FAQ says Max includes $100/month. Verify actual account allowances rather than treating either as guaranteed. Cloud agent requires a paid plan and also uses Actions minutes. Organization/enterprise additional AI-credit usage is enabled by default unless disabled; this is not an individual-plan assumption.
What can it access and what needs my approval?
Only users with repository write access can trigger the agent. It writes to one branch: the existing PR branch for an @copilot PR task, otherwise a new copilot/ branch. Branch protections and required checks still apply. GitHub documents human review and merge: the agent cannot approve or merge a pull request or mark its own draft ready for review. The user who requested the PR cannot supply its required approval. By default, PR Actions workflows wait for a person with write access to click Approve and run workflows. Administrators can allow automatic runs, so confirm the actual repository policy before relying on that gate. The default firewall covers processes the agent starts through its Bash tool inside the Actions appliance. It does not cover MCP servers or configured setup-step processes, and GitHub warns that sophisticated attacks may bypass it. Inspect allowed domains, setup scripts and MCP access separately. Protect Copilot and MCP configuration files with CODEOWNERS and review rules. GitHub distinguishes ordinary Actions secrets from Agents secrets and variables deliberately provided to the cloud agent; grant only the data a task needs.
What happens to my data?
Re-verified 22 October 2026 against GitHub's responsible-use docs for Copilot agents: the cloud agent runs in an ephemeral development environment with a network firewall ENABLED BY DEFAULT that blocks outbound connections to unauthorised hosts against code/data exfiltration; automated security scanning runs on its output; work lands as pull requests for human review and iteration. The doc does not state a prompt/code retention period for the cloud agent. Vendor documentation, not independently audited.
Has AgentComparison tested it?
No. This record is built from the vendor's own documentation, checked 2026-10-22. Vendor claims are attributed, not confirmed.
How to evaluate GitHub Copilot cloud agent yourself
- Pick one low-risk task that matches its documented capabilities: research, plan and change one github repository in an actions-powered environment.
- Write the expected output and what counts as failure before you start.
- Connect the minimum access needed, and check approval settings first.
- Run it twice and compare, then review every action it took.
- Check cost after any free allowance. Unknown price is not free.
Related
- Jules (product): GitHub developers with a working project setup who want bounded bug fixes, dependency maintenance, documentation or tests returned for review while they work on something else.
- Cursor cloud agents (product): Developers who want background work on repository branches and can review diffs, tests and artifacts before a human merges the draft pull request. Configure restricted egress and minimum repository access first.
- AI agent use cases by job
- Privacy and approval checklist
- Compare two agents side by side
- Latest agent updates
Sources and history
- https://docs.github.com/en/copilot/concepts/copilot-surfaces/copilot-on-github · official · read 22 October 2026
- https://github.com/features/copilot/plans · official · read 22 October 2026
- https://docs.github.com/en/copilot/concepts/security-governance-and-network-settings/risks-and-mitigations · official · read 22 October 2026
- https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-the-firewall · official · read 22 October 2026
- https://docs.github.com/en/enterprise-cloud@latest/copilot/tutorials/cloud-agent/build-guardrails · official · read 22 October 2026
- https://docs.github.com/en/copilot/concepts/billing-and-usage/organizations-and-enterprises/billing · official · read 22 October 2026
- https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent · official · read 22 October 2026
- https://docs.github.com/en/copilot/responsible-use/agents · official · read 22 October 2026
Change history
- 2026-11-01: Field-level audit: re-verified github.com/features/copilot/plans. Pro $10, Pro+ $39, Max $100 per month; total GitHub AI Credits $15/$70/$200 per month including Flex allotments ($5/$31/$100); pooled org-wide usage on paid plans; Free plan supports CLI and agent mode; models include Claude Fable 5/5.1 and Haiku 4.5. All match existing profile claims; no content change.
- 2026-10-13: Added eight source-linked feature and limit rows plus a narrow start checklist from current vendor documentation. No hands-on test or ranking.
- 2026-10-08: Checked seven GitHub sources. Added branch/review gates, firewall exclusions, one-repository and 59-minute limits, plus Actions-minute costs. Removed the Free price filter tag because Free does not include this cloud agent.
- 2026-10-04: Added from the user-supplied shortlist (used as a lead only) after checking the vendor's own pages. Documentation research only.
- 2026-10-22: Field-level audit: responsible-use doc re-read - ephemeral firewalled environment (default-on), automated security scanning, PR-based human review all confirmed verbatim; no retention period stated.
Documentation overview expanded with current pricing/access sources. No hands-on results claimed.
Report a correction