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

​
Comece

​
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 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. 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 conta entre o Cursor e o Linear. A conexão com o GitHub é necessária para criar PR.

​
Como usar

Delega issues para o Cursor ou menciona @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 passar instruções adicionais, por exemplo: @Cursor corrige o bug de autenticação descrito acima.

​
Fluxo de trabalho

Os Background Agents exibem 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 para ele. Basta mencionar @Cursor em um comentário no Linear para dar 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 primário 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

Tu podes configurar o comportamento do Background Agent usando vários métodos: 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 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 de 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 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 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 — deve 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 especificar em qual repositório o Background Agent deve trabalhar.
Configurando labels de repositório no Linear