Cursor

El proveedor Cursor ejecuta el agente de Cursor en la máquina del relay, a través del Cursor Agent SDK. OAR inicia un proceso worker por conversación. El agente trabaja en la carpeta de trabajo de la conversación, con los modelos de tu cuenta de Cursor. A diferencia de Claude, no usa un inicio de sesión en la máquina: le das a OAR una clave de API de Cursor.

Esta página trata lo que es propio de Cursor. El chat, la queue y el explorador de archivos funcionan como en todos los proveedores; consulta Los proveedores de un vistazo para ver cómo se compara Cursor.

Lo que necesitas #

• Una clave de API de Cursor. La pegas en OAR una vez; consulta Activarlo.
• Nada que instalar. Cursor no necesita ninguna CLI ni la app de Cursor en la máquina, así que la subpestaña Cursor no tiene fila de CLI.

Dónde está cada cosa:

Por defecto, las carpetas de estado están bajo cursor-agents en la carpeta de datos del relay: ~/.oar/data/cursor-agents (%APPDATA%\oar\data\cursor-agents en Windows) en una instalación global, server/data/cursor-agents en un checkout de git. Nuevo en 0.9.14 Antes de 0.9.14, una instalación global las guardaba dentro de la carpeta del paquete, que una actualización reemplaza, así que una conversación podía perder su agente; una conversación cuya carpeta sigue ahí la sigue usando. CURSOR_AGENT_STORE_DIR las traslada; consulta Variables de entorno.

Activarlo #

Abre Settings → Providers → Cursor (Ajustes → Proveedores → Cursor). El panel tiene el título Cursor SDK.

La línea de estado bajo los campos dice en qué punto estás:

Lo que hace el guardado:

• Detección de modelos. Cuando Cursor está activado y guardas una clave nueva, o cambias el modelo, o lo vuelves a activar, OAR pregunta a Cursor qué modelos puede usar tu clave y las opciones de razonamiento de cada modelo. La solicitud se abandona a los 20 segundos. Un fallo se muestra como aviso en la notificación, por ejemplo Cursor model discovery failed: …. Hasta que una detección sale bien, la lista solo contiene el modelo predeterminado.
• Cambiar la clave. Guardar una clave nueva borra los modelos detectados y, si Cursor está activado, vuelve a ejecutar la detección. Cuando ya había una clave guardada, el relay también detiene todos los workers de Cursor, incluido uno que esté a mitad de un turn, así que guarda una clave nueva entre turns. Los workers vuelven a arrancar con la clave nueva en el siguiente mensaje.
• Quitar la clave se rechaza mientras alguna conversación de Cursor haya enviado un mensaje o tenga mensajes en cola: Cannot remove Cursor API key while N active Cursor conversation(s) still exist. Disable Cursor for new conversations instead. Así ningún turn en curso se ve afectado por una eliminación. En su lugar, desactiva Cursor. Cuando la eliminación se lleva a cabo, las conversaciones que aún no han enviado ningún mensaje vuelven a Copilot. Desactivar Cursor no las mueve.

Después inicia una conversación como siempre: en New Chat, elige el proveedor Cursor SDK. Consulta Iniciar una conversación.

Modelos y effort #

De dónde viene la lista. Del propio Cursor, a través de tu clave, en los momentos indicados arriba. 🤗 Select Models → Cursor SDK (Seleccionar modelos → Cursor SDK) elige cuáles de ellos ofrece el área de redacción; 💾 Save enabled models (Guardar los modelos activados) guarda la elección, y Refresh (Actualizar) vuelve a ejecutar la detección. Si no se ha elegido nada, se ofrecen todos los modelos detectados. El modelo de Cursor model ID siempre se ofrece.

Por mensaje. Una conversación puede cambiar de modelo y de effort de un mensaje al siguiente; los IDs de modelo de Cursor se usan tal como los escribe Cursor. Un ID que no está entre los modelos que se te ofrecen (los activados, más Cursor model ID y el modelo propio de la conversación) se rechaza con Cursor model "…" is not available.

Effort. Las opciones de effort vienen del modelo, tal como las lista. OAR conoce estos niveles: none, low, medium, high, xhigh y max. El extra-high de Cursor aparece como xhigh. Un nivel que OAR no conoce no se ofrece.

• none siempre está en la lista. Si el modelo puede desactivar el razonamiento, none lo hace. Si no puede, el área de redacción muestra la entrada como default (predeterminado), y el modelo funciona como lo hace normalmente.
• Un modelo que no lista ningún effort solo tiene none, mostrado como default.
• En un modelo que tiene un interruptor de razonamiento, elegir un nivel activa el razonamiento y none lo desactiva.

Subagents con otros modelos. El menú de subagents integrado de Cursor solo ofrece un par de modelos. Por eso OAR declara un subagent por cada modelo que hayas activado en Select Models, para que el agente pueda pasar una tarea, por ejemplo, a un modelo Grok o GPT. Los nombres usan guiones (grok-4.5 pasa a ser grok-4-5). Un subagent ejecuta la variante predeterminada de su modelo: no se le puede dar un effort. Cambiar la selección surte efecto en el siguiente mensaje.

Cómo funcionan las funciones de OAR en Cursor #

Las reglas de proyecto propias de Cursor, los archivos de subagents y los servidores MCP de la carpeta .cursor de la carpeta de trabajo no se cargan. OAR define él mismo las herramientas y los subagents del agente.

Un agente inactivo durante mucho tiempo #

Un agente de Cursor que no se ha usado durante 30 minutos se cierra y se vuelve a abrir con el siguiente mensaje, porque su inicio de sesión caduca tras unas horas de inactividad. No lo ves. Si el inicio de sesión ha caducado de todos modos, OAR reconstruye el agente y vuelve a enviar el mensaje, hasta dos veces, y añade la línea de actividad Cursor session re-authenticated; retrying this message on a fresh agent handle. Un tercer fallo termina el turn con el mensaje de inicio de sesión de Si no funciona.

Consumo #

Los turns de Cursor no tienen línea de consumo bajo la respuesta. 📊 Check Usage (Ver consumo) tiene una tarjeta Cursor. Mientras Cursor está desactivado dice Cursor is not enabled in provider settings. Sus cifras vienen de dos fuentes, y la tarjeta dice cuál ha usado.

Gasto según OAR, una estimación. Después de cada turn, OAR lee de Cursor el gasto facturado del agente y contabiliza el aumento en el ciclo de facturación actual. Asigna cada turn a la bolsa del modelo que lo ejecutó:

La comparación no distingue mayúsculas de minúsculas, y los nombres de router se comprueban primero.

Cursor no le dice al SDK qué incluye tu plan. Eso lo introduces tú:

Los medidores comparan el coste bruto del modelo con tu asignación. La tarjeta también lista lo que Cursor cobró realmente, que a menudo es cero para el uso incluido en el plan. Todas estas cifras son estimaciones. Un coste que Cursor informa tarde se contabiliza con el turn que lo ve. El panel Spending de Cursor es la fuente de referencia, y la tarjeta enlaza a él.

Barras del plan en vivo, desde el panel de Cursor. Con un token de sesión del panel, la tarjeta añade las barras Plan usage (total) (Consumo del plan, total), Auto + Composer y API leídas en vivo del panel de Cursor, el nombre del plan, el gasto incluido y bajo demanda, y las fechas reales del ciclo. Los medidores locales de las bolsas pasan entonces a segundo plano. El token es una cookie de sesión, no la clave de API, y la clave de API no puede leer estas cifras.

OAR busca un token en este orden:

1. El que guardaste.
2. CURSOR_SESSION_TOKEN en el entorno del relay, para hosts sin la app de Cursor.
3. El inicio de sesión de la app de Cursor en la máquina del relay, leído de su estado local sin configuración.

La línea de estado bajo el campo indica la fuente en uso. El token se queda en el relay y nunca se envía a un navegador. Si Cursor no acepta el token, la tarjeta vuelve a las estimaciones y dice qué fuente se rechazó, o que no se encontró ningún token.

Un agente puede leer las mismas cifras con la acción usage de relay_tool.

Variables de entorno #

Fíjalas en el entorno en el que arranca el relay.

La clave de API no se puede fijar de esta forma: el relay pasa a sus workers la clave del panel de ajustes e ignora un CURSOR_API_KEY en su propio entorno.

Límites #

Además de las carencias de la tabla anterior (sin corrección del rumbo, sin panel de tareas, sin ajuste de compactación, un solo nivel de subagents):

• Las tarjetas de pregunta dependen de que el agente llame a ask_user.
• El gasto y las asignaciones son estimaciones. Solo las barras del panel de Cursor vienen de Cursor.
• Un límite de uso de tu plan de Cursor no pone la conversación en pausa. El turn falla como cualquier turn fallido, y vuelves a enviar el mensaje.

Si no funciona #