Cursor Actions
Execute Cursor Cloud Agent tasks from your SmartFlow workflows. Launch AI coding agents, monitor their progress, add follow-up instructions, and manage agent lifecycle — all from automated workflows.
Prerequisites
- Cursor Cloud Agents integration must be connected
- At least one GitHub repository synced
Available Actions
Launch Coding Agent
Start a new Cursor Cloud Agent to perform a coding task on a GitHub repository.
| Parameter | Required | Type | Description |
|---|---|---|---|
| Repository | Yes | Text | GitHub repository URL or name (e.g., owner/repo) |
| Task Description | Yes | Textarea | Describe what the agent should do |
| Branch | No | Text | Git branch or ref to work on (default: main) |
| Model | No | Text | AI model to use for the agent |
| Auto-create PR | No | Boolean | Automatically create a pull request when done (default: true) |
| Branch Name | No | Text | Custom branch name for the pull request |
Output Variables:
| Variable | Description |
|---|---|
agentId | ID of the launched agent |
status | Current status of the agent |
repository | Repository the agent is working on |
Add Followup
Send additional instructions to a running coding agent.
| Parameter | Required | Type | Description |
|---|---|---|---|
| Agent ID | Yes | Text | ID of the agent to add followup to |
| Followup Prompt | Yes | Textarea | Additional instruction for the agent |
Output Variables:
| Variable | Description |
|---|---|
agentId | ID of the agent |
Get Agent Status
Check the detailed status and progress of a coding agent.
| Parameter | Required | Type | Description |
|---|---|---|---|
| Agent ID | Yes | Text | ID of the agent to check |
Output Variables:
| Variable | Description |
|---|---|
agentId | ID of the agent |
status | Current status: RUNNING, COMPLETED, FAILED, CREATING, or CANCELLED |
summary | Summary of the agent's work |
prUrl | URL to the pull request (if created) |
createdAt | When the agent was created |
Delete Agent
Delete a coding agent and clean up its resources.
| Parameter | Required | Type | Description |
|---|---|---|---|
| Agent ID | Yes | Text | ID of the agent to delete |
Output Variables:
| Variable | Description |
|---|---|
agentId | ID of the deleted agent |
Agent Status Values
| Status | Description |
|---|---|
CREATING | Agent is being initialized |
RUNNING | Agent is actively working on the task |
COMPLETED | Agent has finished its work |
FAILED | Agent encountered an error |
CANCELLED | Agent was cancelled |
Workflow Examples
Auto-Fix Bug Reports
Trigger: Chat Service (when user reports a bug)
Actions:
1. AI Request:
Prompt: "Extract the repository name and bug description"
Input: {{message}}
2. Cursor Launch Agent:
Repository: {{repository}}
Task: "Fix this bug: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "I've launched a coding agent. I'll notify you when the PR is ready."
Launch and Monitor
Trigger: Conversation Tool
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: {{user_instruction}}
Auto-create PR: true
2. Cursor Get Agent Status:
Agent ID: {{agentId}}
3. Send Message:
Text: "Agent status: {{status}}. PR: {{prUrl}}"
Iterative Agent with Followup
Trigger: Conversation Tool
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Implement the initial feature"
2. Cursor Add Followup:
Agent ID: {{agentId}}
Followup: "Also add unit tests for the new feature"
Setup
- Go to Integrations → Cursor Cloud Agents
- Configure your API key (setup guide)
- Sync your repositories
- Cursor actions appear in the SmartFlow Node Library under Connectors