# Linear

Como a exportação do Linear funciona, da conexão à solução de problemas.

## Conectar

Clique em “Conectar” ao lado do Linear, em “Nuvem”, na tela Início do Exporter. Entre com a Apple; o navegador abre a página do Linear, onde você clica em “Authorize”. O Exporter pede ao Linear só para ler. De volta ao Exporter, escolha para onde vão os arquivos e clique em “Usar esta pasta”.

O token do Linear fica lacrado no servidor do Exporter. Seu Mac entra nesse servidor e nunca guarda o token.

## Escolher itens

A página de escolha lista cada issue, projeto e documento, todos marcados, com três abas: Issues, Projetos e Documentos. Desmarque o que não quiser; o arquivo fica de fora.

## Onde ficam os arquivos

Uma pasta direto na sua pasta pessoal, como `~/Documents`, ganha uma pasta `linear-export` dentro; uma mais funda é usada como está.

- Issues: uma pasta por equipe, um arquivo por issue, com o nome do id e do título: `Northwind/NW-142 Invite flow.md`
- Projetos: `Projects/Q4 launch.md`
- Documentos: `Documents/<project or team>/<title>.md`

## O arquivo

O front matter de um issue traz `id`, `team`, `state`, `priority`, `assignee`, `creator`, `labels`, `project`, `cycle`, `parent`, `estimate`, `due` e as datas, com `source_url` que o abre no Linear. Depois o título, a descrição e cada comentário, do mais antigo ao mais novo. Um projeto traz o estado, o líder, as equipes e as datas; um documento, o projeto, a equipe e quem o criou. Os horários estão em UTC.

## Sincronização

O Linear avisa o servidor do Exporter de cada mudança. O servidor regrava o arquivo na hora e avisa o seu Mac, que o baixa: uma mudança chega em segundos, no máximo um minuto. Um issue renomeado move o arquivo; um que você arquiva, descarta ou apaga o perde. “Sincronizar agora” consulta o servidor primeiro; “Ressincronização Completa” regrava todos os arquivos.

## Exporter Cloud

Os primeiros 7 dias desde a sua primeira conexão são grátis. Depois, o Exporter Cloud é uma assinatura na App Store: só o Linear, ou o All Cloud para cada fonte na nuvem que adicionarmos, mensal ou anual. Quando um plano termina, a sincronização para e seus arquivos ficam. Trinta dias depois, o servidor apaga suas cópias e o token.

## Conta

Ajustes › Conta mostra o e-mail com que você entrou. “Sair” mantém a conexão para quando você entrar de novo. “Apagar conta…” desconecta todos os espaços de trabalho e apaga tudo o que o servidor guarda sobre você. Os arquivos no seu Mac ficam.

## Linha de comando

`exporter export --source linear --dest <folder>` grava os arquivos do espaço de trabalho numa pasta autorizada no cartão Linha de Comando. Veja [a linha de comando](https://exporter.dev/docs/cli).

## Problemas e soluções

- O cartão diz “Conectar de novo…”: o Linear não aceita mais a conexão, muitas vezes porque o app foi removido nos ajustes do Linear. Clique nele e autorize de novo.
- O cartão diz “Entrar…”: a sessão terminou. Entre com a mesma conta Apple e a sincronização continua.
- Falta um issue: confira se ele está marcado e clique em “Sincronizar agora”. Issues arquivados não são exportados.

## Related

- [Linear](https://exporter.dev/pt-br/linear): Issues, projetos e documentos em arquivos
- [Guias do Linear](https://exporter.dev/pt-br/guides/linear): Obsidian e Claude Code
- [Preços](https://exporter.dev/pt-br/pricing): Cotas grátis, desbloqueios e Exporter Cloud

---

human version: https://exporter.dev/pt-br/docs/linear
every page: https://exporter.dev/llms.txt