Linear

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.

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.