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

Empezá

Instalación

Tenés que ser admin de Cursor para conectar la integración con Linear. Otras configuraciones del equipo están disponibles para miembros que no son admins.
  1. Andá a Integraciones de Cursor
  2. Hacé clic en Connect junto a Linear
  3. Conectá tu workspace de Linear y seleccioná el team
  4. Hacé clic en Authorize
  5. Completá cualquier configuración pendiente del Background Agent en Cursor:
    • Conectá GitHub y seleccioná el repositorio predeterminado
    • Activá el pricing basado en uso
    • Confirmá la configuración de privacidad

Vinculación de cuenta

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

Cómo usar

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

Delegar issues

  1. Abrí el issue en Linear
  2. Hacé clic en el campo de asignación
  3. Seleccioná “Cursor”
Delegar un issue a Cursor en Linear

Mencionar a Cursor

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

Flujo de trabajo

Los Background Agents muestran el estado en tiempo real en Linear y crean PR automáticamente cuando finalizan. 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 un seguimiento al propio agente. Simplemente mencioná @Cursor en un comentario de Linear para darle indicaciones adicionales a un Background Agent en ejecución.

Configuración

Configurá los ajustes 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

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

Selección de repositorio

Cursor determina en qué repositorio trabajar usando este orden de prioridad:
  1. Descripción/comentarios del issue: Sintaxis [repo=owner/repository] en el texto del issue o comentarios
  2. Etiquetas del issue: Etiquetas de repositorio asociadas al issue específico de Linear
  3. Etiquetas del proyecto: Etiquetas de repositorio asociadas 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. Andá a Settings en tu espacio de trabajo de Linear
  2. Hacé clic en Labels
  3. Hacé clic en New group
  4. Nombrá el grupo “repo” (no distingue mayúsculas/minúsculas; debe ser exactamente “repo”, no “Repository” ni otras variaciones)
  5. Dentro de ese grupo, creá etiquetas para cada repositorio usando el formato owner/repo
Después podés asignar estas etiquetas a issues o proyectos para especificar en qué repositorio debería trabajar el Background Agent.
Configuring repository labels in Linear
I