Linear e tarefas

A tela Tasks reúne as tarefas dos provedores conectados: Linear, GitHub, GitLab, Jira e It’s a Plan. Esta página cobre o Linear.

ConectarCopiar link da seção

Há três caminhos para conectar:

• Settings → Integrations → Linear → Add Linear access;
• Settings → Task Sources;
• o passo Integrations da configuração inicial.

O Dusky pede uma Personal API key (começa com lin_api_), criada no Linear em Account > Security & Access. Se a organização bloqueia chaves de membros, alguém com acesso de administração precisa liberar.

• O alcance da chave define o que aparece. Uma chave com acesso total mostra todos os times que a pessoa alcança. Uma chave restrita mostra só os times permitidos.
• O Dusky confere a chave no Linear antes de salvar.
• Dá para conectar mais de uma organização do Linear, uma chave por organização.
• A chave é guardada criptografada com o cofre de senhas do sistema operacional.

Skill do agenteCopiar link da seção

Em Settings → Linear, o passo Install the agent skill instala uma skill que permite ao agente ler o ticket, postar atualizações, fazer triagem e anexar PRs. A instalação roda num terminal embutido, ou você copia o comando com Copy command. O status mostra Installed ou Not installed, com Re-check.

Esconder o Linear da tela Tasks não desconecta: a chave e a skill continuam no lugar.

Navegar nas issuesCopiar link da seção

Abra a tela Tasks pela barra lateral. O comando Open Tasks não tem atalho padrão, mas dá para definir um em Settings → Shortcuts.

Os modos são Issues, Projects, Views (as visões salvas no Linear) e Has Workspace (issues ligadas a um workspace do Dusky).

• Busca e Refresh Linear.
• Seletor de time e de organização.
• Filters: status, prioridade, responsável e etiquetas. Os filtros de status, responsável e etiqueta pedem um único time ou organização selecionado.
• Lista ou quadro. No quadro, arrastar um cartão muda o status.
• Agrupamento por status, responsável, prioridade ou time, e ordem por prioridade, atualização ou identificador.
• New Linear issue e New Linear project criam itens no time selecionado.

Painel da issueCopiar link da seção

O painel permite editar título e descrição em Markdown, status, prioridade, responsável, estimativa, etiquetas e projeto, além de sub-issues. Para comentar, escreva e envie com ⌘Enter no macOS ou Ctrl+Enter no Linux e no Windows.

As ações copiam o URL, o identificador, o nome de branch sugerido e um prompt com todo o contexto da issue, comentários incluídos. Open on Linear abre a issue no navegador.

Começar um workspace pela issueCopiar link da seção

Start workspace, no painel da issue:

1. cria a worktree com um nome como eng-123-titulo-da-issue;
2. liga a issue ao workspace;
3. abre o agente padrão;
4. deixa no prompt do agente um rascunho, sem enviar, com só o identificador e o link da issue.

O texto da issue fica de fora de propósito: o agente lê o resto pela skill. Se o repositório pede confirmação de setup, se o repositório não é encontrado ou se nenhum agente está instalado, o Dusky abre o diálogo de criação de workspace no lugar.

No diálogo Create workspace (⌘N no macOS, Ctrl+N no Linux e no Windows), o campo de nome tem uma aba Linear para buscar issues, e aceita colar o URL de uma issue. O nome de branch sugerido pelo Linear vira o nome da branch.

Na paleta de workspaces (⌘J no macOS, Ctrl+Shift+J no Linux e no Windows), colar o URL de uma issue oferece criar a worktree a partir dela, ou abre o workspace que já está ligado à issue.

Ligar um workspace que já existeCopiar link da seção

Clique com o botão direito no workspace, escolha Update e use o campo Linked work. Cada item ligado pode ser removido com Unlink from workspace. O cartão do workspace mostra a issue ligada e um atalho para abri-la no Linear.

Quadro sincronizadoCopiar link da seção

No quadro de workspaces, ligue Sync board and issue status. Mover um workspace ligado para uma coluna muda o estado da issue no Linear para o estado de mesmo nome. Se nenhum estado tiver o nome da coluna, ou se vários tiverem, o Dusky avisa e não muda nada.

LimitaçõesCopiar link da seção

• Só chave de API pessoal; não há login por OAuth.
• Agentes em hosts remotos precisam da skill instalada no próprio host.