Presentamos el Cursor SDK para que puedas crear agentes con el mismo entorno de ejecución, infraestructura y modelos que hacen funcionar Cursor.

Ahora puedes acceder con unas pocas líneas de TypeScript a los agentes que se ejecutan en la aplicación de escritorio de Cursor, el CLI y la aplicación web. Ejecútalo en tu máquina o en la nube de Cursor, en una VM dedicada y con cualquier modelo de vanguardia.

Los agentes de programación están pasando de ser herramientas interactivas para desarrolladores individuales a convertirse en infraestructura programática para organizaciones. El Cursor SDK te permite desplegar agentes sin tener que crear y mantener todo el stack de agentes. Muchos equipos ya invocan agentes directamente desde pipelines de CI/CD, crean automatizaciones para flujos de trabajo de extremo a extremo e integran agentes en sus productos principales.

El Cursor SDK ya está disponible en beta pública para todos los usuarios. Solo ejecuta npm install @cursor/sdk para comenzar.

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

#Despliega agentes en producción rápidamente

Crear agentes de programación rápidos, fiables y potentes que trabajen de forma segura con tus datos requiere un esfuerzo de ingeniería considerable: aislamiento seguro, gestión persistente del estado y de las sesiones, configuración del entorno y gestión del contexto. Y cuando aparece un nuevo modelo, los equipos a menudo tienen que rehacer los bucles de sus agentes para poder aprovecharlo.

El Cursor SDK elimina esta complejidad para que puedas centrarte en crear agentes útiles.

Usa infraestructura en la nube lista para producción

Las sesiones en la nube iniciadas desde el SDK se ejecutan en el mismo entorno de ejecución optimizado que usamos para Cloud Agents. Cada agente tiene su propia VM dedicada con aislamiento robusto, un clon del repositorio y un entorno de desarrollo totalmente configurado.

Los agentes siguen funcionando cuando tu portátil se suspende o se corta la red. Puedes seguir la conversación en streaming y volver a conectarte más tarde. Cuando el agente termina, puede abrir una PR, hacer push de una rama o adjuntar demos y capturas de pantalla.

// Iniciar agente en la nube para comenzar una tarea...:
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...comprueba el estado más tarde, desde cualquier lugar:
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

El SDK usa nuestra API de Cloud Agents actualizada, lo que permite que las ejecuciones de agentes en la nube aparezcan en la ventana de Agentes y la aplicación web de Cursor. Puedes iniciar una tarea de forma programática y luego abrir Cursor para inspeccionar el progreso o retomar el trabajo.

Cuando necesites un entorno de ejecución distinto, el mismo SDK puede ejecutar agentes en workers autoalojados, manteniendo el código y la ejecución de herramientas dentro de tu red, o localmente en tu máquina para iterar rápidamente.

Aprovecha toda la infraestructura de Cursor

Los agentes iniciados a través del SDK se benefician de la misma infraestructura que impulsa Cursor en nuestra aplicación de escritorio, CLI y aplicación web:

• Gestión inteligente del contexto: La indexación de la base de código, la búsqueda semántica e Instant Grep ayudan a los agentes a llegar al resultado adecuado con más rapidez y eficiencia.
• Servidores MCP: Los agentes pueden conectarse a herramientas externas y fuentes de datos mediante stdio o HTTP, ya sea a través de un archivo de configuración .cursor/mcp.json o pasados directamente en la llamada.
• Skills: Los agentes cargan Skills automáticamente desde el directorio .cursor/skills/ de tu repositorio.
• Hooks: Observa, controla y amplía el ciclo del agente en entornos cloud, autoalojados y locales con un archivo .cursor/hooks.json.
• Subagentes: Delega subtareas a subagentes con nombre, con sus propios prompts y modelos, que el agente principal invoca mediante la herramienta Agent.

Desarrolla con cualquier modelo

El Cursor SDK te da acceso a todos los modelos compatibles con Cursor. Dirige los agentes al mejor modelo para la tarea en cuestión, con el equilibrio entre costo y capacidad que desees, cambiando un solo campo.

Y con Composer 2, un modelo de programación especializado que alcanza un rendimiento de primer nivel a una fracción del costo de los modelos de propósito general, obtienes la mejor combinación de inteligencia y eficiencia para la mayoría de las tareas de los agentes de programación.

#Lo que están creando los desarrolladores

Los equipos están usando el Cursor SDK para desplegar agentes personalizados más rápido. Por ejemplo, agentes programáticos que se activan directamente desde CI/CD para resumir cambios, identificar la causa raíz de fallos en CI y actualizar las PR con correcciones. Otros están creando plataformas de agentes personalizadas, como aplicaciones internas que permiten a los equipos de GTM consultar datos del producto sin escribir código.

Algunos clientes incluso están integrando Cursor directamente en productos de cara al cliente, donde los usuarios finales ahora obtienen una experiencia de agente sin salir de la aplicación principal.

Conoce de primera mano a algunos de nuestros clientes que están creando con el Cursor SDK:

#Empieza con un proyecto de ejemplo

Hemos agregado algunos proyectos de inicio a un repositorio público de GitHub que puedes bifurcar y ampliar para tus propios casos de uso:

• Quickstart: Un ejemplo mínimo de Node.js que crea un agente local, envía un prompt y recibe la respuesta en streaming.
• Herramienta de prototipado: Una aplicación web para lanzar agentes que generen la estructura base de nuevos proyectos y permitan iterar ideas en un entorno de nube aislado.
• Tablero kanban: Una herramienta kanban impulsada por agentes en la que los ingenieros pueden arrastrar una tarjeta y hacer que los agentes se encarguen del trabajo de forma programática, abran una PR y devuelvan el resultado como archivo adjunto.
• CLI de agente de programación: Una interfaz de línea de comandos ligera que te permite lanzar agentes de Cursor desde tu terminal.

#Qué sigue

El Cursor SDK está disponible para todos los usuarios y se factura según la tarifa estándar por consumo de tokens.

Seguimos invirtiendo en el Cursor SDK, con el objetivo de facilitar aún más a los equipos la creación de agentes programáticos en más lenguajes, flujos de trabajo y patrones de despliegue.

Obtén más información en nuestra documentación. También puedes usar Cursor con nuestro plugin de Cursor SDK para ayudarte a empezar a crear.