CursorCloud Agents can offload their execution to Vercel Sandbox, and the architecture shift is actually significant for anyone trying to build a production-grade AI workflow.
Instead of relying on Cursor's internal hosting, the agent harness and inference loop now leverage Vercel's Firecracker microVMs. This effectively separates the "brain" (the LLM inference) from the "hands" (the environment where the code is actually executed). For those not on an Enterprise plan, this might feel like a niche update, but the technical implementation of the control plane is where the real value lies.
How the deployment architecture works #
The setup doesn't just spin up a server; it uses Vercel Functions and Vercel Workflow as a durable control plane. This is critical because agentic loops are notoriously flaky. If a worker crashes or a session hangs while the agent is trying to run a test suite, the workflow layer handles the retries automatically.
If you are trying to set this up from scratch, you need to ensure you have the Cursor Enterprise plan since the Self-Hosted Machines APIs are gated. The flow looks like this:
-
Cursor triggers an agent request.
-
Vercel Workflow claims the queued request and provisions a dedicated Firecracker microVM.
-
The agent clones the repository into this isolated Sandbox.
-
The agent executes commands—like
npm testorgit commit—within that specific user-scoped environment. -
Once the task is complete or the session expires, the Sandbox is destroyed.
The breakdown of performance gains #
I've noticed a few specific areas where this outperforms the standard hosted approach:
- Resource Scaling: It's a true scale-to-zero model. You aren't paying for a VM to sit there while the LLM is thinking; the environment only exists during the execution phase.
- Security Isolation: Since every single request gets its own isolated microVM, there's no risk of cross-contamination between different agent sessions or users.
- Credential Management: The sandbox uses short-lived, user-scoped credentials. This solves the common problem of leaving long-term API keys sitting in a persistent VM environment.
For anyone attempting a manual deployment of the reference implementation, make sure your environment variables for the Cursor API are correctly mapped in the Vercel dashboard, or the workflow will throw a 401 unauthorized error during the worker provisioning phase. The shift to Firecracker microVMs means the boot time is negligible, which is the only way to make a "cloud agent" feel like a local tool. If you're building a complex LLM agent that needs to interact with a real filesystem and run shell commands, this is the blueprint for doing it without managing a fleet of EC2 instances.
Next Why is a seven-minute chat with Gemini more effective than a →