> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leme.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Deixe agents consultarem, criarem e atualizarem issues no Linear em nome do seu time

Conecte o Linear e seus agents ficam fluentes no trabalho do seu time: o que está em andamento, o que está bloqueado, quem é dono do quê. Eles também fazem a parte tediosa — abrir issues bem escritas, atualizar status, deixar comentários — com um humano aprovando as mudanças por padrão.

## O que os agents podem fazer

| Capacidade                       | Detalhes                                                              |
| -------------------------------- | --------------------------------------------------------------------- |
| Listar times, membros e projetos | Os blocos básicos para qualquer pergunta sobre o trabalho.            |
| Listar estados de workflow       | Seus status reais — Backlog, In Progress, Done e os personalizados.   |
| Listar e ler issues              | Com filtro por time; detalhe completo por ID ou chave como `ENG-123`. |
| Criar issues                     | Título, descrição em Markdown, responsável, status, projeto.          |
| Atualizar issues                 | Mudar título, descrição, status, responsável, prioridade ou projeto.  |
| Comentar em issues               | Publicado como o app da Leme, visível para o time inteiro.            |

A leitura roda livremente por padrão; criar, atualizar e comentar pedem aprovação. Veja [Permissões](#permissões).

## Experimente perguntar

* *"No que o time de mobile está trabalhando agora?"*
* *"Liste tudo o que está atribuído à Ana e ainda está aberto."*
* *"Resuma a ENG-123 e o status atual dela."*
* *"Crie uma issue para o bug de timeout no login que acabamos de discutir e atribua ao time de plataforma."* — criada após aprovação.
* *"Mova a ENG-88 para In Review e adicione um comentário com o link do resumo desta conversa."* — aplicado após aprovação.

## Conectar o Linear

<Steps>
  <Step title="Abra Integrações">
    No dashboard da Leme, acesse **Integrações** e selecione **Linear**.
  </Step>

  <Step title="Autorize no Linear">
    Selecione **Conectar** e aprove na tela de consentimento do Linear. Você precisa de permissão para instalar aplicações no workspace do Linear.
  </Step>

  <Step title="Habilite nos seus agents">
    Vincule a conexão aos agents que devem usá-la e revise as **Permissões de agent**.
  </Step>
</Steps>

O Linear é uma conexão **compartilhada**: uma única autorização serve o workspace, e os agents agem como o app da Leme — issues e comentários criados por eles são atribuídos ao app, então fica sempre claro o que foi um agent que fez.

## Permissões

| Ação                                 | Categoria           | Padrão          |
| ------------------------------------ | ------------------- | --------------- |
| Listar e ler times, projetos, issues | Leitura             | Permitir        |
| Criar e atualizar issues             | Escrita             | Pedir aprovação |
| Comentar em issues                   | Comunicação externa | Pedir aprovação |

Ajuste em **Integrações → Linear → Permissões de agent** — veja [Permissões e aprovações](/pt-BR/permissions). Times que deixam agents fazerem triagem costumam permitir a criação de issues e manter atualizações e comentários atrás de aprovação.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O agent não encontra uma issue pela chave">
    Chaves de issue têm escopo por time (`ENG-123`). Se a chave está certa, o app da Leme pode não ter acesso às issues daquele time — verifique o acesso do app nas configurações do workspace do Linear.
  </Accordion>

  <Accordion title="Criar uma issue falha com um campo inválido">
    Responsáveis, status e projetos são definidos por ID, e o agent resolve nomes em IDs primeiro. Se um nome for ambíguo ("duas Anas"), diga ao agent qual delas você quer.
  </Accordion>

  <Accordion title="A conexão aparece como precisando de atenção">
    A autorização expirou ou o app foi revogado no Linear. Reconecte em **Integrações → Linear**; permissões e atribuições de agents são preservadas.
  </Accordion>
</AccordionGroup>