Presentamos el SDK de Cursor para que puedas crear agentes con el mismo runtime, harness y modelos que impulsan Cursor.
Puedes acceder a los agentes que se ejecutan en la aplicación de escritorio de Cursor, la CLI y la aplicación web con solo unas líneas de TypeScript. Puedes ejecutarlos en tu máquina o en la nube de Cursor, sobre una VM dedicada, con cualquier modelo de vanguardia.
Ejecuta npm install @cursor/sdk para empezar. También puedes usar la skill nativa /sdk de Cursor para ayudarte a empezar a crear.
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);}
Creamos algunos proyectos de ejemplo a los que puedes acceder desde un repo público. Haz un fork de ellos y amplíalos para tu propio caso de uso.
El SDK de Cursor ya está disponible para todos los usuarios en beta pública y se factura según el precio estándar basado en el consumo de tokens. Obtén más información en nuestro anuncio y la documentación.
Se rediseñó la API en torno a agentes duraderos y ejecuciones por prompt, por lo que el seguimiento, el estado, el streaming y la cancelación ahora se aplican a cada ejecución.
Se agregó streaming de ejecuciones de primer nivel con eventos SSE, soporte para reconexión mediante Last-Event-ID y estados finales más claros.
Se agregaron controles explícitos del ciclo de vida del agente para archivar, desarchivar y eliminar de forma permanente.
Se estandarizaron los formatos de respuesta y error de v1, incluidos códigos de error estructurados, respuestas de lista en items y objetos agent / run separados.
Esta versión introduce una nueva forma de realizar varias tareas con subagentes asíncronos, una experiencia mejorada con worktrees y espacios de trabajo multirraíz para hacer cambios entre repositorios.
Con /multitask, Cursor ejecutará subagentes asíncronos para procesar tus solicitudes en paralelo en lugar de agregarlas a la cola. También dividirá las tareas más grandes en partes más pequeñas para que varios subagentes asíncronos las aborden al mismo tiempo.
Si ya tienes mensajes en cola, también puedes pedirle a Cursor que procese en paralelo esos mensajes, en lugar de esperar a que termine la ejecución actual.
Ejecuta tareas aisladas en segundo plano en distintas ramas. Cuando estés listo para probar los cambios, mueve cualquier rama a tu entorno local en primer plano con un clic.
#espacios de trabajo multirraíz en la Ventana de agentes
Una sola sesión de agente ahora puede usar un espacio de trabajo reutilizable compuesto por varias carpetas.
Esto permite que Cursor realice cambios entre repositorios que abarcan el frontend, el backend y bibliotecas compartidas, sin tener que reconfigurar el agente cada vez que pasa de un repositorio a otro.
Estas visualizaciones pueden incluir paneles e interfaces personalizadas creadas con componentes propios, como tablas, cuadros, diagramas y gráficos, así como componentes existentes de Cursor, como diferencias y listas de tareas.
En la Ventana de Agentes, los canvas son artefactos persistentes que se mantienen en el panel lateral, junto al terminal, el navegador y el control de versiones.
Pruébalo en Cursor 3.1 en la Ventana de Agentes o en el editor. Lee más en nuestro anuncio.
Usa /debug para encontrar las causas de raíz y solucionar errores complejos que son difíciles de reproducir o entender. En Debug Mode, Cursor genera hipótesis, agrega mensajes de registro y usa información de ejecución para identificar con precisión la incidencia antes de aplicar una solución dirigida.
Haz una pregunta rápida al margen sin desviar al agente de su tarea principal. /btw te permite aclarar el cambio que Cursor está realizando sin detener la ejecución en curso.
/config abre un panel interactivo de configuración dentro de la CLI donde puedes ver y cambiar opciones de comportamiento, como la elección de modelos, los valores predeterminados, las preferencias de ejecución y mucho más.
También puedes pedirle a Cursor que aplique cambios en la configuración por ti usando la skill /update-cli-config.
Personaliza la barra de estado usando /statusline para mostrar las señales de la sesión y de la ejecución que te importan, incluidos el modo actual, la rama, el entorno, los indicadores de la tarea activa u otros metadatos de la sesión.
Abre el selector de modelos desde cualquier lugar para cambiar de modelo sin tener que borrar antes el prompt.
Si Cursor detecta que has habilitado auto-run tres veces seguidas, ahora te sugerirá activarlo de forma proactiva para evitar bucles interminables de aprobación.
La herramienta AskQuestion y Debug Mode ahora gestionan mejor las respuestas en texto plano.
Ahora se admite pegar imágenes desde el portapapeles, incluido Ctrl+V en algunos terminales sin compatibilidad nativa para pegar.
El pie de página ahora muestra tu directorio de trabajo, worktree y la rama actual.
Ahora puedes enviar el CLI al segundo plano de forma fiable con Ctrl+Z.
Auto-run ahora funciona en otros modos como Debug Mode y Plan Mode.
Se solucionó una incidencia por la que los procesos de shell en segundo plano podían seguir ejecutándose después de salir del CLI.
Se corrigieron el manejo y la coincidencia de los comandos slash.
Se corrigió el manejo del teclado para Cmd+Delete, los atajos de teclado de Vim y las combinaciones con el modificador Ctrl.
Divide la vista actual en paneles para ejecutar y gestionar varios agentes en paralelo. El diseño en mosaico facilita trabajar en varias tareas a la vez y comparar resultados entre agentes sin tener que cambiar de pestaña.
Amplía los paneles para centrarte en una conversación, arrastra agentes a los mosaicos y usa atajos de teclado para navegar y organizarte rápidamente. Tu configuración también se conserva entre sesiones.
El dictado mediante entrada por voz es más fiable y preciso. Graba todo el audio y lo transcribe con STT por lotes para ofrecer una conversión de voz a texto de mayor calidad.
Puedes mantener presionado Ctrl+M para hablar, y hemos agregado controles a la UI durante la grabación, como una forma de onda, un temporizador y botones para cancelar y confirmar.
Antes, al iniciar un agente desde el estado vacío, normalmente se seleccionaba por defecto la rama actual. Ahora puedes buscar y seleccionar primero una rama, y luego iniciar un agente en la nube directamente en esa rama.
Esto reduce los pasos necesarios para cambiar de rama y evita ejecuciones accidentales en la rama equivocada.
Salta de la diferencia directamente a la línea exacta del archivo. Una vez allí, tienes toda la potencia del editor: puedes hacer cambios manualmente, usar Tab, ir a la definición y mucho más.
Usa filtros de inclusión/exclusión en "Buscar en archivos" para limitar la búsqueda de código a conjuntos de archivos concretos.
Los botones de prompt ahora permanecen en su sitio mientras se procesa la entrada por voz.
Las pestañas del plan ahora tienen el mismo comportamiento de documento que los archivos: compatibilidad con carga fiable, seguimiento de cambios sin guardar, recarga cuando cambia el plan y capacidad para guardar, copiar y exportar markdown.
Las nuevas sesiones de agente ahora se inician por defecto en el destino de proyecto que prefieras.
Los nombres de las pestañas de archivos ahora se resuelven dentro de las pestañas visibles del agente actual, en lugar de intentar que sean únicos a nivel global entre las pestañas de los demás agentes.
Cmd-K ahora muestra menos resultados de agente y más relevantes, limitados al conjunto reciente que coincide (es decir, elementos que coinciden con tu consulta y pertenecen a un subconjunto reciente).
En macOS, el texto ahora se renderiza con suavizado de bordes, lo que produce contornos de caracteres más nítidos.
El Modo Diseño ahora te permite recorrer el árbol de elementos (arriba, abajo y lateralmente) con el teclado para elegir el elemento de la UI antes de comentar.
La ventana de agentes ahora evita actualizaciones y recuperaciones costosas salvo cuando son realmente necesarias.
Al cerrar pestañas, ahora es menos probable que el árbol de archivos falle, y la recuperación es más rápida.
Se limitaron las recuperaciones de diferencias locales para reducir los picos de CPU/red y la latencia en las vistas de SCM.
El árbol de archivos ahora responde a los cambios de forma más fiable y es menos probable que parpadee, quede desactualizado o se pierda actualizaciones.
Los eventos de la extensión (p. ej., cambio de archivo, actualización de diagnósticos) ahora se limitan a cada espacio de trabajo, lo que reduce la interferencia entre proyectos.
Antes, pulsar Intro para enviar un seguimiento en un chat largo podía tardar más de un segundo; ahora se siente instantáneo.
Las ediciones grandes ahora se transmiten con más fluidez tras reducir los fotogramas perdidos en ~87 %.
Se solucionó un error por el que desplazarse por conversaciones largas antes se entrecortaba. Ahora va fluido, incluso en hilos grandes.
Se solucionó un error por el que una conversación de agente llena de diferencias o bloques de código parpadeaba y se congelaba.
Presentamos el SDK de Cursor para que puedas crear agentes con el mismo runtime, harness y modelos que impulsan Cursor.
Puedes acceder a los agentes que se ejecutan en la aplicación de escritorio de Cursor, la CLI y la aplicación web con solo unas líneas de TypeScript. Puedes ejecutarlos en tu máquina o en la nube de Cursor, sobre una VM dedicada, con cualquier modelo de vanguardia.
Ejecuta npm install @cursor/sdk para empezar. También puedes usar la skill nativa /sdk de Cursor para ayudarte a empezar a crear.
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);}
Creamos algunos proyectos de ejemplo a los que puedes acceder desde un repo público. Haz un fork de ellos y amplíalos para tu propio caso de uso.
El SDK de Cursor ya está disponible para todos los usuarios en beta pública y se factura según el precio estándar basado en el consumo de tokens. Obtén más información en nuestro anuncio y la documentación.
Se rediseñó la API en torno a agentes duraderos y ejecuciones por prompt, por lo que el seguimiento, el estado, el streaming y la cancelación ahora se aplican a cada ejecución.
Se agregó streaming de ejecuciones de primer nivel con eventos SSE, soporte para reconexión mediante Last-Event-ID y estados finales más claros.
Se agregaron controles explícitos del ciclo de vida del agente para archivar, desarchivar y eliminar de forma permanente.
Se estandarizaron los formatos de respuesta y error de v1, incluidos códigos de error estructurados, respuestas de lista en items y objetos agent / run separados.
Esta versión introduce una nueva forma de realizar varias tareas con subagentes asíncronos, una experiencia mejorada con worktrees y espacios de trabajo multirraíz para hacer cambios entre repositorios.
Con /multitask, Cursor ejecutará subagentes asíncronos para procesar tus solicitudes en paralelo en lugar de agregarlas a la cola. También dividirá las tareas más grandes en partes más pequeñas para que varios subagentes asíncronos las aborden al mismo tiempo.
Si ya tienes mensajes en cola, también puedes pedirle a Cursor que procese en paralelo esos mensajes, en lugar de esperar a que termine la ejecución actual.
Ejecuta tareas aisladas en segundo plano en distintas ramas. Cuando estés listo para probar los cambios, mueve cualquier rama a tu entorno local en primer plano con un clic.
#espacios de trabajo multirraíz en la Ventana de agentes
Una sola sesión de agente ahora puede usar un espacio de trabajo reutilizable compuesto por varias carpetas.
Esto permite que Cursor realice cambios entre repositorios que abarcan el frontend, el backend y bibliotecas compartidas, sin tener que reconfigurar el agente cada vez que pasa de un repositorio a otro.
Estas visualizaciones pueden incluir paneles e interfaces personalizadas creadas con componentes propios, como tablas, cuadros, diagramas y gráficos, así como componentes existentes de Cursor, como diferencias y listas de tareas.
En la Ventana de Agentes, los canvas son artefactos persistentes que se mantienen en el panel lateral, junto al terminal, el navegador y el control de versiones.
Pruébalo en Cursor 3.1 en la Ventana de Agentes o en el editor. Lee más en nuestro anuncio.
Usa /debug para encontrar las causas de raíz y solucionar errores complejos que son difíciles de reproducir o entender. En Debug Mode, Cursor genera hipótesis, agrega mensajes de registro y usa información de ejecución para identificar con precisión la incidencia antes de aplicar una solución dirigida.
Haz una pregunta rápida al margen sin desviar al agente de su tarea principal. /btw te permite aclarar el cambio que Cursor está realizando sin detener la ejecución en curso.
/config abre un panel interactivo de configuración dentro de la CLI donde puedes ver y cambiar opciones de comportamiento, como la elección de modelos, los valores predeterminados, las preferencias de ejecución y mucho más.
También puedes pedirle a Cursor que aplique cambios en la configuración por ti usando la skill /update-cli-config.
Personaliza la barra de estado usando /statusline para mostrar las señales de la sesión y de la ejecución que te importan, incluidos el modo actual, la rama, el entorno, los indicadores de la tarea activa u otros metadatos de la sesión.
Abre el selector de modelos desde cualquier lugar para cambiar de modelo sin tener que borrar antes el prompt.
Si Cursor detecta que has habilitado auto-run tres veces seguidas, ahora te sugerirá activarlo de forma proactiva para evitar bucles interminables de aprobación.
La herramienta AskQuestion y Debug Mode ahora gestionan mejor las respuestas en texto plano.
Ahora se admite pegar imágenes desde el portapapeles, incluido Ctrl+V en algunos terminales sin compatibilidad nativa para pegar.
El pie de página ahora muestra tu directorio de trabajo, worktree y la rama actual.
Ahora puedes enviar el CLI al segundo plano de forma fiable con Ctrl+Z.
Auto-run ahora funciona en otros modos como Debug Mode y Plan Mode.
Se solucionó una incidencia por la que los procesos de shell en segundo plano podían seguir ejecutándose después de salir del CLI.
Se corrigieron el manejo y la coincidencia de los comandos slash.
Se corrigió el manejo del teclado para Cmd+Delete, los atajos de teclado de Vim y las combinaciones con el modificador Ctrl.
Divide la vista actual en paneles para ejecutar y gestionar varios agentes en paralelo. El diseño en mosaico facilita trabajar en varias tareas a la vez y comparar resultados entre agentes sin tener que cambiar de pestaña.
Amplía los paneles para centrarte en una conversación, arrastra agentes a los mosaicos y usa atajos de teclado para navegar y organizarte rápidamente. Tu configuración también se conserva entre sesiones.
El dictado mediante entrada por voz es más fiable y preciso. Graba todo el audio y lo transcribe con STT por lotes para ofrecer una conversión de voz a texto de mayor calidad.
Puedes mantener presionado Ctrl+M para hablar, y hemos agregado controles a la UI durante la grabación, como una forma de onda, un temporizador y botones para cancelar y confirmar.
Antes, al iniciar un agente desde el estado vacío, normalmente se seleccionaba por defecto la rama actual. Ahora puedes buscar y seleccionar primero una rama, y luego iniciar un agente en la nube directamente en esa rama.
Esto reduce los pasos necesarios para cambiar de rama y evita ejecuciones accidentales en la rama equivocada.
Salta de la diferencia directamente a la línea exacta del archivo. Una vez allí, tienes toda la potencia del editor: puedes hacer cambios manualmente, usar Tab, ir a la definición y mucho más.
Usa filtros de inclusión/exclusión en "Buscar en archivos" para limitar la búsqueda de código a conjuntos de archivos concretos.
Los botones de prompt ahora permanecen en su sitio mientras se procesa la entrada por voz.
Las pestañas del plan ahora tienen el mismo comportamiento de documento que los archivos: compatibilidad con carga fiable, seguimiento de cambios sin guardar, recarga cuando cambia el plan y capacidad para guardar, copiar y exportar markdown.
Las nuevas sesiones de agente ahora se inician por defecto en el destino de proyecto que prefieras.
Los nombres de las pestañas de archivos ahora se resuelven dentro de las pestañas visibles del agente actual, en lugar de intentar que sean únicos a nivel global entre las pestañas de los demás agentes.
Cmd-K ahora muestra menos resultados de agente y más relevantes, limitados al conjunto reciente que coincide (es decir, elementos que coinciden con tu consulta y pertenecen a un subconjunto reciente).
En macOS, el texto ahora se renderiza con suavizado de bordes, lo que produce contornos de caracteres más nítidos.
El Modo Diseño ahora te permite recorrer el árbol de elementos (arriba, abajo y lateralmente) con el teclado para elegir el elemento de la UI antes de comentar.
La ventana de agentes ahora evita actualizaciones y recuperaciones costosas salvo cuando son realmente necesarias.
Al cerrar pestañas, ahora es menos probable que el árbol de archivos falle, y la recuperación es más rápida.
Se limitaron las recuperaciones de diferencias locales para reducir los picos de CPU/red y la latencia en las vistas de SCM.
El árbol de archivos ahora responde a los cambios de forma más fiable y es menos probable que parpadee, quede desactualizado o se pierda actualizaciones.
Los eventos de la extensión (p. ej., cambio de archivo, actualización de diagnósticos) ahora se limitan a cada espacio de trabajo, lo que reduce la interferencia entre proyectos.
Antes, pulsar Intro para enviar un seguimiento en un chat largo podía tardar más de un segundo; ahora se siente instantáneo.
Las ediciones grandes ahora se transmiten con más fluidez tras reducir los fotogramas perdidos en ~87 %.
Se solucionó un error por el que desplazarse por conversaciones largas antes se entrecortaba. Ahora va fluido, incluso en hilos grandes.
Se solucionó un error por el que una conversación de agente llena de diferencias o bloques de código parpadeaba y se congelaba.
