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

# Linear

> Conecte o Linear à Tess para gerenciar issues, projetos e fluxos do time no chat e nos agentes.

O conector do **Linear** integra a Tess ao rastreamento de issues e ao planejamento de projetos do Linear. Depois de conectado, a IA pode criar e atualizar issues, acompanhar status de projetos e apoiar rotinas de engenharia dentro de chats e agentes.

O conector **Linear** faz parte do ecossistema de [Connectors](/pt/connectors) da Tess e usa autenticação **OAuth** para conectores de Apps.

## Pré-requisitos

<Info>
  * Conta no Linear com acesso ao workspace que você quer usar.
  * Permissão para autorizar apps de terceiros nesse workspace do Linear.
</Info>

## Como conectar

<Tip>
  Em alguns conectores de Apps, a tela de consentimento OAuth pode exibir o nome de uma ponte de conexão de terceiros em vez da Tess. Isso é normal—revise as permissões solicitadas e continue se fizerem sentido para o uso.
</Tip>

<Steps>
  <Step title="Abra o painel de Conectores">
    No chat, clique no **+** ao lado da caixa de mensagem e selecione **Connectors**.
    Você também pode gerenciar conectores na edição do agente no Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/linear/01-connect-panel.png" alt="PRINT: (Painel de Conectores com Linear em destaque e o botão Connect visível)" />
    </Frame>
  </Step>

  <Step title="Localize Linear e clique em Connect">
    Em **Apps**, encontre **Linear** e clique em **Connect** para iniciar a autenticação.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/linear/02-oauth-consent.png" alt="PRINT: (Tela de autorização / consentimento do provedor para Linear)" />
    </Frame>
  </Step>

  <Step title="Autorize o acesso">
    Faça login na conta desejada e revise as permissões solicitadas antes de confirmar.
  </Step>

  <Step title="Confirme que está ativo">
    Ao voltar para a Tess, **Linear** deve aparecer em **Connected**, pronto para chats e agentes.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/linear/03-connected.png" alt="PRINT: (Callback da Tess ou lista de Conectores mostrando Linear como Connected com estado de sucesso)" />
    </Frame>
  </Step>
</Steps>

## O que você pode fazer

* **Criar e atualizar issues** com título, descrição, prioridade e assignees
* **Buscar e listar issues** por time, projeto, status ou labels
* **Acompanhar projects e cycles** para resumir progresso e bloqueios
* **Comentar em issues** sem sair da Tess
* **Organizar o trabalho** de engenharia, produto e suporte

## Exemplos de prompt

> 1. Liste as issues abertas atribuídas a mim no time ENG e agrupe por prioridade.
> 2. Crie um bug no Linear com o título 'Timeout no login no Safari' e me atribua.
> 3. Resuma o que mudou esta semana no projeto Connectors e destaque bloqueios.
> 4. Encontre issues com label 'customer' ainda In Progress e sugira próximos passos.

## Boas práticas

* Informe o time/projeto quando houver mais de um contexto.
* Peça um rascunho da issue quando o pedido estiver ambíguo.
* Em agentes, deixe claro se o Linear é para intake, triagem ou status.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="A autorização falha ou é negada">
    Confirme que você está no workspace correto do Linear e que apps de terceiros estão liberados.
  </Accordion>

  <Accordion icon="circle-question" title="401 / conexão caiu">
    Reconecte o Linear em Conectores. Tokens podem expirar após mudança de senha ou permissão.
  </Accordion>

  <Accordion icon="circle-question" title="Não vejo um time ou projeto">
    A conta conectada pode não ter acesso. Conecte com uma conta que visualize esse time.
  </Accordion>
</AccordionGroup>

<Note>
  A Tess age com as permissões da conta conectada. Ela não amplia acessos além do que essa conta já pode fazer.

  Conectores envolvem acesso a sistemas externos. Conecte apenas contas adequadas ao uso e revise as permissões com cuidado.
</Note>