Close menu
Explore Plans
Mobile menu Close menu
Cursor

Launch an agent

This action will launch a new Cursor cloud agent to work on a GitHub repository using the instructions you provide.

Developer info

API endpoint slug
cursor.launch_agent
Filter code method
Cursor.launchAgent.skip(string?: reason)
Runtime method
runAction("cursor.launch_agent", {})

Action fields

Repository Text input > Other

Label
GitHub repository
Helper text
The repository the agent should work on, as owner/repo (e.g. ifttt/shimmy). A full GitHub URL also works. The repository must be accessible to your Cursor account.
Slug
repository
Required
true
Can have default value
true
Filter code method
Cursor.launchAgent.setRepository(string: repository)

Instructions Text input > Long text

Label
What should the agent do?
Helper text
Detailed instructions for the agent. Example: Add a README with setup instructions and open a pull request.
Slug
instructions
Required
true
Can have default value
true
Filter code method
Cursor.launchAgent.setInstructions(string: instructions)

Agent name Text input > Title

Label
Agent name (optional)
Helper text
An optional human-readable name to identify this agent. If left blank, Cursor auto-generates one.
Slug
agent_name
Required
false
Can have default value
true
Filter code method
Cursor.launchAgent.setAgentName(string: agent_name)