Did I miss something on the SDK for cloud agents? I am able to programmatically setup my cloud agent environment but there is no way to kick-off the agent via the API? Right now we setup our repo’s and than create all of our default skills and rules for cursor but than we have to login to the agents dashboard to start the intial build of the environment? Am I missing something?
Hi Chad!
You’re not missing anything. The SDK can launch cloud agents programmatically via Agent.create() or Agent.prompt(), and environment resolution happens automatically when an agent starts. If you’ve already configured an environment through the dashboard, SDK-launched agents reuse that cached environment.
The gap you’re hitting is the initial environment setup (configuring install commands, caching project dependencies). That step currently requires the dashboard — there’s no API endpoint to trigger it yet.
Agents will still run without a configured environment using a basic fallback: they can read files, write code, commit, and push, but won’t be able to run tests, linting, or anything requiring project-specific dependencies.
As a workaround, you can direct users to set up their environment via a URL like:
https://cursor.com/onboard?repository=https%3A%2F%2Fgithub.com%2Forg%2Frepo
This takes them straight to environment setup for that specific repo.
Same question was discussed in Cursor SDK feedback and ideas — the team is aware of the need for a programmatic environment setup API.
SDK docs: TypeScript SDK | Cloud Agent API
Thank you @mohitjain, following that thread.