News
GitHub Copilot local sandboxing reaches general availability
GitHub made local sandboxing for Copilot generally available, limiting what agent-run commands can touch. Setup, OS needs and gaps for teams.
GitHub announced on October 7, 2026, that local sandboxing for GitHub Copilot is generally available. The feature applies to Copilot CLI, the GitHub Copilot app, and VS Code sessions that use Agent Host. Commands that Copilot runs on a developer's own machine now execute inside an operating-system sandbox with limits on files, network and credentials.
What local sandboxing for GitHub Copilot does
The GitHub changelog entry (opens in a new tab) describes local sandboxing as an execution boundary for agentic workflows. Tools and commands that Copilot starts run with restricted access to the filesystem, network, credentials and other system capabilities. The developer or their organization defines the policy.
GitHub lists five controls in the post. Teams can limit which directories agent-run commands read or modify. Access to the internet, local networks, Git credentials and GitHub CLI credentials can be switched on or off. Local MCP and language servers can run inside the sandbox where supported. Enterprises can require sandboxing and lock policies so developers cannot weaken them.
Sandbox policies cover tool execution only. GitHub states that they apply whichever model Copilot uses, because model execution and tool isolation are separate concerns.
The engine underneath: MXC
Local sandboxing is built on Microsoft eXecution Container (MXC) (opens in a new tab), an MIT-licensed project that turns one sandbox policy into native operating-system controls. The MXC README lists seatbelt as the default backend on macOS, bubblewrap on Linux and processcontainer on Windows 11. MXC ships SDKs for Rust, .NET and Node.
How local and cloud sandboxes differ
GitHub's docs on cloud and local sandboxes (opens in a new tab) separate two options. A local sandbox runs Copilot on your machine and is included in the standard Copilot seat at no extra cost. A cloud sandbox runs the whole session in an isolated, ephemeral Linux environment hosted by GitHub, built on Azure Container Apps Sandboxes.
Cloud sandboxes remain in public preview and are billed by usage. Only the local option reached general availability in this announcement.
Who it is for
Developers who let GitHub Copilot run shell commands with less supervision get a fixed boundary around those commands. A command that tries to read outside allowed paths or reach a blocked host is stopped at the operating-system level, within the limits listed further down.
Credential handling has its own mechanism. The docs say sandboxed tools receive placeholders, and a local proxy supplies real credentials only to approved HTTPS destinations. Extra environment variables can be masked too.
Platform and security owners get enforcement. Managed settings can come from a server, MDM or a file. Once managed settings require sandboxing, ordinary settings and startup options cannot turn it off.
How to turn it on
In Copilot CLI, run /sandbox enable. The setting persists across sessions until you run /sandbox disable, and it is stored as sandbox.enabled. In the GitHub Copilot app, set the default in project settings or change it for an active local session. The two surfaces keep separate settings.
Each operating system has requirements:
- macOS uses Seatbelt, and the docs recommend macOS 15 (Sequoia) or later.
- Linux needs bubblewrap 0.5.0 or later with
bwrapon yourPATH. Outbound traffic also needsslirp4netns, util-linux 2.35 or later, iptables tooling and access to/dev/net/tun. - Windows requires a recent Windows 11 update that supports sandboxing.
On an unsupported host, the CLI turns off the saved preference for that session and shows a notice. An administrator who wants a hard failure instead can set sandbox.failIfUnavailable. With both that setting and sandbox.enabled set to true in managed settings, the CLI blocks model requests and tool execution when it cannot enforce the sandbox.
Limits GitHub documents
Local sandboxing is lighter isolation than a VM or container. It restricts file, network and process access at the OS level.
The docs list several gaps:
- Built-in file tools run in-process in the CLI, so the OS sandbox cannot constrain them. They check the policy on a best-effort basis.
- On Linux, bubblewrap cannot control local network access separately for spawned processes, including shell commands and local MCP and LSP servers.
- On Windows, proxy and host rules depend on programs honoring proxy settings. Direct connections are less constrained than on macOS and Linux.
- Remote MCP servers are never sandboxed.
What is not known yet
The changelog does not explain how sandboxing behaves inside VS Code sessions using Agent Host beyond naming that surface. The docs page reviewed here covers configuration for the CLI and the app, not VS Code.
The sandboxes docs page does not list which Windows 11 builds qualify. It links to a separate Windows update page for that. The docs do not name Copilot plan tiers either; they say the feature is included in the standard seat. No timeline is given for cloud sandboxes leaving public preview.
Frequently asked questions
Does local sandboxing cost extra on GitHub Copilot?
No. GitHub says local sandboxing is included with Copilot at no additional cost. Cloud sandboxes are different: they are usage-billed on compute, memory and snapshot storage meters, and an owner must enable the Cloud Sandbox access policy for organization members.
Can a developer switch the sandbox off if their company requires it?
Not through ordinary settings or startup options. Where the managed policy permits a bypass, the docs say a developer can disable sandboxing for the current session only, and the saved policy stays as it was.
Does choosing a different model change what the sandbox allows?
No. GitHub treats model execution and tool isolation as separate, so the same sandbox policy governs commands whichever model is selected in Copilot. The policy controls what tools can do on the machine, not which model answers.
Sources
- 1.Local sandboxing for GitHub Copilot now generally available - GitHub ChangelogOfficial docsPrimarygithub.blog
- 2.github.com/microsoft/mxcRepositoryPrimary
- 3.docs.github.com/copilot/concepts/security-governance-and-network-settings/about-cloud-and-local-sandboxesOfficial docsPrimary
Spotted an error? See our corrections policy.
Enjoyed this? Get the weekly brief.
New guides, Project & Tool of the Week and the AI developments that matter. One email, no spam.
Read next
- Weekly digest
The week on HuiaHub: sandboxed agents, RAG tooling and local models
41 new HuiaHub pages this week: sandboxing coding agents, RAG retrieval, local models on Macs and phones, Claude Haiku 5.5 and six how-to guides.
4 min read
ExplainerAgents & automationAI agents found in US bank accounts: what banks are blocking and why
See which banks are restricting AI agents in bank accounts, how read-only access differs from credential sharing, and which claims remain unverified.
10 min read
GuideCoding & dev toolsPHP critical security update CVE-2026-109618: Versions and patch steps
Check the PHP critical security update CVE-2026-109618, identify affected servers, install fixed PHP versions, and apply temporary settings if needed.
12 min read