Usa Background Agents diretamente no Linear delegando issues pro Cursor ou mencionando @Cursor nos comentários.

​
Comece agora

​
Instalação

Você precisa ser admin do Cursor para conectar a integração com o Linear. Outras configurações de equipe estão disponíveis para membros que não são admin.
  1. Vai para 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. Conclui qualquer configuração restante do Background Agent no Cursor:
    • Conecta o GitHub e seleciona o repositório padrão
    • Ativa a precificação baseada em uso
    • Confirma as configurações de privacidade

​
Vinculação de conta

No primeiro uso, rola a vinculação de contas entre o Cursor e o Linear. A conexão com o GitHub é necessária para criação de PR.

​
Como usar

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

​
Delegando issues

  1. Abre a issue no Linear
  2. Clica no campo de responsável
  3. Seleciona “Cursor”
Delegando uma issue para o Cursor no Linear

​
Mencionando o Cursor

Menciona @Cursor em um comentário para atribuir um novo agente ou fornecer 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 concluídos. Acompanha o progresso no dashboard do Cursor.
Atualizações de status do Background Agent no Linear

​
Instruções de acompanhamento

Você pode responder na sessão do agente e isso será enviado como um follow-up para o agente. Basta mencionar @Cursor em um comentário no Linear para fornecer orientação adicional a 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 usada como base para criar PRs (geralmente main ou develop)

​
Opções de configuração

Você pode ajustar 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 estrutura de labels pai–filho em que o label pai é a chave de configuração e o label filho é o valor. Labels do projeto: Mesma estrutura pai–filho dos labels do issue, aplicada no nível do projeto. Chaves de configuração suportadas:
  • repo: Especifica o repositório de destino (por exemplo, owner/repository)
  • branch: Especifica a branch base para criação de 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 definido 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” nem 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