Sim

Cursor

Launch and manage Cursor cloud agents to work on GitHub repositories

Cursor is an AI IDE and cloud-based platform that lets you launch and manage powerful AI agents able to work directly on your GitHub repositories. Cursor agents can automate development tasks, enhance your team's productivity, and collaborate with you by making code changes, responding to natural language instructions, and maintaining conversation history about their activities.

With Cursor, you can:

  • Launch cloud agents for codebases: Instantly create new AI agents that work on your repositories in the cloud
  • Delegate coding tasks using natural language: Guide agents with written instructions, amendments, and clarifications
  • Monitor progress and outputs: Retrieve agent status, view detailed results, and inspect current or completed tasks
  • Access full conversation history: Review all prompts and AI responses for transparency and auditability
  • Control and manage agent lifecycle: List active agents, terminate agents, and manage API-based agent launches and follow-ups

In Sim, the Cursor integration enables your agents and workflows to interact programmatically with Cursor cloud agents. This means you can use Sim to:

  • List all cloud agents and browse their current state (cursor_list_agents)
  • Retrieve up-to-date status and outputs for any agent (cursor_get_agent)
  • View the full conversation history for any coding agent (cursor_get_conversation)
  • Add follow-up instructions or new prompts to a running agent
  • Manage and terminate agents as needed

This integration helps you combine the flexible intelligence of Sim agents with the powerful development automation capabilities of Cursor, making it possible to scale AI-driven development across your projects.

Usage Instructions

Interact with Cursor Cloud Agents API to launch AI agents that can work on your GitHub repositories. Supports launching agents, adding follow-up instructions, checking status, viewing conversations, and managing agent lifecycle.

Tools

cursor_list_agents

List all cloud agents for the authenticated user with optional pagination.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
limitnumberNoNumber of agents to return (default: 20, max: 100)
cursorstringNoPagination cursor from previous response

Output

ParameterTypeDescription
contentstringHuman-readable list of agents
metadataobjectAgent list metadata

cursor_get_agent

Retrieve the current status and results of a cloud agent.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
contentstringHuman-readable agent details
metadataobjectAgent metadata

cursor_get_conversation

Retrieve the conversation history of a cloud agent, including all user prompts and assistant responses.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
contentstringHuman-readable conversation history
metadataobjectConversation metadata

cursor_launch_agent

Start a new cloud agent to work on a GitHub repository with the given instructions.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
repositorystringYesGitHub repository URL (e.g., https://github.com/your-org/your-repo\)
refstringNoBranch, tag, or commit to work from (defaults to default branch)
promptTextstringYesThe instruction text for the agent
promptImagesstringNoJSON array of image objects with base64 data and dimensions
modelstringNoModel to use (leave empty for auto-selection)
branchNamestringNoCustom branch name for the agent to use
autoCreatePrbooleanNoAutomatically create a PR when the agent finishes
openAsCursorGithubAppbooleanNoOpen the PR as the Cursor GitHub App
skipReviewerRequestbooleanNoSkip requesting reviewers on the PR

Output

ParameterTypeDescription
contentstringSuccess message with agent details
metadataobjectLaunch result metadata

cursor_add_followup

Add a follow-up instruction to an existing cloud agent.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)
followupPromptTextstringYesThe follow-up instruction text for the agent
promptImagesstringNoJSON array of image objects with base64 data and dimensions (max 5)

Output

ParameterTypeDescription
contentstringSuccess message
metadataobjectResult metadata

cursor_stop_agent

Stop a running cloud agent. This pauses the agent without deleting it.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
contentstringSuccess message
metadataobjectResult metadata

cursor_delete_agent

Permanently delete a cloud agent. This action cannot be undone.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
contentstringSuccess message
metadataobjectResult metadata

Notes

  • Category: tools
  • Type: cursor
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started