This repository demonstrates how to run Cursor Cloud Agents on customer-managed infrastructure with self-hosted worker pools. Cursor still handles orchestration, model inference, and the Cloud Agents experience, while workers run inside your environment to clone repos, run commands, edit files, execute builds/tests, and reach internal services.

Workers connect outbound to Cursor over HTTPS. No inbound access to the worker is required.

Use the general READMEs for architecture, trade-offs, validation expectations, and troubleshooting. Use the implementation READMEs when you need copy-paste setup commands.

• EC2 + Docker is the smallest footprint and runs one worker container on one host.
• ECS/Fargate is the AWS-native service path with CloudWatch metrics and ECS Service Auto Scaling.
• EKS + Helm is the Kubernetes path, documented in the official Kubernetes deployment guide, which covers the Cursor worker-set controller, WorkerDeployment resources, scaling, and rolling updates.