Usa Background Agents directamente desde Linear delegando tareas a Cursor o mencionando @Cursor en los comentarios.

​
Comienza

​
Instalación

Debes ser admin de Cursor para conectar la integración con Linear. Otros ajustes del equipo están disponibles para miembros que no son admins.
  1. Ve a Integraciones de Cursor
  2. Haz clic en Connect junto a Linear
  3. Conecta tu workspace de Linear y selecciona el equipo
  4. Haz clic en Authorize
  5. Completa cualquier configuración pendiente del Background Agent en Cursor:
    • Conecta GitHub y selecciona el repositorio predeterminado
    • Habilita la facturación basada en uso
    • Confirma la configuración de privacidad

​
Vinculación de cuentas

En el primer uso se solicitará vincular las cuentas entre Cursor y Linear. Se requiere conexión a GitHub para crear PR.

​
Cómo usar

Asigna issues a Cursor o menciona @Cursor en los comentarios. Cursor analiza los issues y filtra automáticamente el trabajo que no es de desarrollo.

​
Asignar issues

  1. Abre el issue en Linear
  2. Haz clic en el campo de asignación
  3. Selecciona “Cursor”
Asignar un issue a Cursor en Linear

​
Mencionar a Cursor

Menciona @Cursor en un comentario para asignar un nuevo agente o dar instrucciones adicionales, por ejemplo: @Cursor corrige el bug de autenticación descrito arriba.

​
Flujo de trabajo

Los Background Agents muestran su estado en tiempo real en Linear y crean PRs automáticamente cuando terminan. Seguí el progreso en el dashboard de Cursor.
Actualizaciones de estado de Background Agent en Linear

​
Instrucciones de seguimiento

Podés responder en la sesión del agente y se enviará como seguimiento al agente. Simplemente mencioná @Cursor en un comentario de Linear para darle indicaciones adicionales a un Background Agent en ejecución.

​
Configuración

Configura las opciones de Background Agents desde Dashboard → Background Agents.
SettingLocationDescription
Default RepositoryCursor DashboardRepositorio principal cuando no hay un repositorio de proyecto configurado
Default ModelCursor DashboardModelo de IA para Background Agents
Base BranchCursor DashboardRama desde la que crear PR (normalmente main o develop)

​
Opciones de configuración

Puedes ajustar el comportamiento de Background Agents usando varios métodos: Descripción del issue o comentarios: Usa la sintaxis [key=value], por ejemplo:
  • @cursor please fix [repo=anysphere/everysphere]
  • @cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Etiquetas de issue: Usa una estructura de etiquetas padre-hijo donde la etiqueta padre es la clave de configuración y la etiqueta hija es el valor. Etiquetas de proyecto: La misma estructura padre-hijo que las etiquetas de issue, aplicada a nivel de proyecto. Claves de configuración compatibles:
  • repo: Especifica el repositorio de destino (p. ej., owner/repository)
  • branch: Especifica la rama base para la creación de PR
  • model: Especifica el modelo de IA a usar

​
Selección de repositorio

Cursor decide en qué repositorio trabajar siguiendo este orden de prioridad:
  1. Descripción/comentarios del issue: sintaxis [repo=owner/repository] en el texto del issue o en comentarios
  2. Etiquetas de issue: Etiquetas de repositorio añadidas al issue específico de Linear
  3. Etiquetas de proyecto: Etiquetas de repositorio añadidas al proyecto de Linear
  4. Repositorio predeterminado: Repositorio especificado en la configuración del dashboard de Cursor

​
Configuración de etiquetas de repositorio

Para crear etiquetas de repositorio en Linear:
  1. Ve a Settings en tu workspace de Linear
  2. Haz clic en Labels
  3. Haz clic en New group
  4. Nombra el grupo “repo” (no distingue mayúsculas/minúsculas; debe ser exactamente “repo”, no “Repository” ni otras variaciones)
  5. Dentro de ese grupo, crea etiquetas para cada repositorio usando el formato owner/repo
Luego puedes asignar estas etiquetas a issues o proyectos para indicar en qué repositorio debe trabajar el Background Agent.
Configurar etiquetas de repositorio en Linear