Usa Background Agents directamente en 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 admin.
  1. Andá a Cursor integrations
  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 cuentas

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

​
Cómo usar

Delegá issues a Cursor o mencioná @Cursor en 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”
Delegando 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 arreglá 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 terminan. Sigue el progreso en el tablero de Cursor.
Actualizaciones de estado del Background Agent en Linear

​
Instrucciones de seguimiento

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

​
Configuración

Configura los ajustes del Background Agent desde Dashboard → Background Agents.
SettingLocationDescription
Default RepositoryCursor DashboardRepositorio predeterminado cuando no hay un repositorio de proyecto configurado
Default ModelCursor DashboardModelo de IA para Background Agents
Base BranchCursor DashboardRama base para crear PR (normalmente main o develop)

​
Opciones de configuración

Puedes configurar el comportamiento del Background Agent 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 issues: 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 issues, 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 del 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 issues: Etiquetas de repositorio asignadas al issue específico de Linear
  3. Etiquetas de proyecto: Etiquetas de repositorio asignadas 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 espacio de trabajo de Linear
  2. Haz clic en Labels
  3. Haz clic en New group
  4. Nombra el grupo “repo” (no distingue mayúsculas; debe ser exactamente “repo”, no “Repository” ni otras variantes)
  5. Dentro de ese grupo, crea etiquetas para cada repositorio usando el formato owner/repo
Luego podrás asignar estas etiquetas a issues o proyectos para indicar en qué repositorio debe trabajar el Background Agent.
Configuring repository labels in Linear