Pular para o conteúdo principal
Usa Background Agents direto no Linear delegando issues pro Cursor ou mencionando @Cursor nos comentários.

Comece

Instalação

Tu precisa ser admin do Cursor pra conectar a integração com o Linear. Outras configurações de equipe ficam disponíveis pra membros que não são admin.
  1. Vai em Cursor integrations
  2. Clica em Connect ao lado de Linear
  3. Conecta teu workspace do Linear e seleciona a equipe
  4. Clica em Authorize
  5. Finaliza qualquer configuração restante do Background Agent no Cursor:
    • Conecta o GitHub e seleciona o repositório padrão
    • Habilita a precificação por uso
    • Confirma as configurações de privacidade

Vinculação de conta

No primeiro uso, rola a vinculação de conta entre o Cursor e o Linear. Conexão com o GitHub é obrigatória pra criação de PR.

Como usar

Delegar issues ao Cursor ou mencionar @Cursor nos comentários. O Cursor analisa as issues e filtra automaticamente o que não for trabalho de desenvolvimento.

Delegando issues

  1. Abrir a issue no Linear
  2. Clicar no campo de responsável
  3. Selecionar “Cursor”
Delegando uma issue ao Cursor no Linear

Mencionando o Cursor

Menciona @Cursor em um comentário para atribuir um novo agente ou passar instruções adicionais, por exemplo: @Cursor corrige o bug de autenticação descrito acima.

Fluxo de trabalho

Background Agents mostram o status em tempo real no Linear e criam PRs automaticamente quando finalizados. Acompanha o progresso no dashboard do Cursor.
Atualizações de status do Background Agent no Linear

Instruções de acompanhamento

tu pode responder na sessão do agente e isso vai ser enviado como um follow‑up pro agente. É só mencionar @Cursor em um comentário no Linear pra dar orientações adicionais pra um Background Agent em execução.

Configuração

Configura as preferências do Background Agent em Dashboard → Background Agents.
SettingLocationDescription
Default RepositoryCursor DashboardRepositório padrão quando nenhum repositório do projeto estiver configurado
Default ModelCursor DashboardModelo de IA para Background Agents
Base BranchCursor DashboardBranch a partir da qual os PRs serão criados (geralmente main ou develop)

Opções de configuração

Dá para configurar o comportamento do Background Agent de várias formas: Descrição do issue ou comentários: Usa a sintaxe [key=value], por exemplo:
  • @cursor please fix [repo=anysphere/everysphere]
  • @cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Labels do issue: Usa uma estrutura de rótulo pai‑filho em que o rótulo pai é a chave de configuração e o rótulo filho é o valor. Labels do projeto: Mesma estrutura pai‑filho dos labels do issue, aplicada no nível do projeto. Chaves de configuração compatíveis:
  • repo: Especifica o repositório de destino (por exemplo, owner/repository)
  • branch: Especifica a branch base para criação do PR
  • model: Especifica o modelo de IA a ser usado

Seleção de repositório

O Cursor decide em qual repositório trabalhar seguindo esta ordem de prioridade:
  1. Descrição/comentários do issue: Sintaxe [repo=owner/repository] no texto do issue ou nos comentários
  2. Labels do issue: Labels de repositório anexados ao issue específico no Linear
  3. Labels do projeto: Labels de repositório anexados ao projeto no Linear
  4. Repositório padrão: Repositório especificado nas configurações do dashboard do Cursor

Configurando labels de repositório

Para criar labels de repositório no Linear:
  1. Vai em Settings no teu workspace do Linear
  2. Clica em Labels
  3. Clica em New group
  4. Nomeia o grupo “repo” (case-insensitive — tem que ser exatamente “repo”, não “Repository” ou outras variações)
  5. Dentro desse grupo, cria labels para cada repositório usando o formato owner/repo
Esses labels podem ser atribuídos a issues ou projetos para indicar em qual repositório o Background Agent deve trabalhar.
Configurando labels de repositório no Linear
I