O TaskGoblin conecta a dois tipos de ferramenta, e a distinção define como você se cadastra:
- Um provedor git — GitLab ou GitHub — fornece seus repositórios e provisiona sua organização. Exatamente um por organização, escolhido quando você entra.
- Provedores de capacidade — Linear, Jira, Slack e Microsoft Teams — adicionam superfícies onde loops podem disparar e goblins podem reportar. Esses você conecta numa organização que já tem.
Gerencie todos em Integrações no menu da sua organização (/{organisation}/integrations).
Conectar um provedor instala os loops padrão dele. Essa é a consequência prática que vale guardar: uma integração não é só uma credencial, é um conjunto de comportamentos permanentes chegando junto. Veja Loops de evento para o que cada uma instala.
Provedores git (GitLab ou GitHub)
Entrar é conectar seu provedor git — um único consentimento OAuth autentica você e provisiona sua organização e seus repositórios. É por isso que não existe um passo separado de "conecte seu repo".
GitLab
Conectar o GitLab enumera os grupos a que você pertence e provisiona uma organização do TaskGoblin para cada um, mais uma organização pessoal. O goblin publica como @taskgoblin em merge requests e issues. Se o token precisar ser renovado, a página de Integrações oferece Reconectar em um clique.
Instala: Revisar merge requests, Trabalhar em issues atribuídas.
GitHub
O GitHub é um GitHub App, não um app OAuth clássico. Você instala o app do TaskGoblin na organização que quiser, e cada instalação vira uma organização do TaskGoblin. O app emite tokens de instalação de vida curta sob demanda e o goblin publica como taskgoblin[bot]. Como as permissões se renovam pela própria instalação, organizações do GitHub nunca precisam de reconexão manual.
Instala: Revisar pull requests, Trabalhar em issues com label.
Uma organização provisionada por git fica presa ao provedor que a criou — o card daquele provedor oferece Reconectar em vez de Desconectar.
Provedores de capacidade
Linear
Um consentimento OAuth de um clique na sua organização ativa. Uma vez conectado, os goblins pegam issues atribuídas ao agente TaskGoblin, leem a issue e seus comentários como contexto, e publicam status, atividade e o link do merge request de volta na issue.
Instala: Trabalhar em issues atribuídas.
Jira
Um consentimento OAuth da Atlassian que conecta seu site Jira à organização ativa. Os goblins pegam issues atribuídas à conta do TaskGoblin e respondem a menções em comentários, respondendo como comentário na issue e movendo-a pelo seu fluxo quando você pede.
Uma issue do Jira raramente nomeia um repositório, então o goblin descobre o destino a partir do pedido, da sua memória de organização e dos seus repositórios conectados — e pergunta em vez de adivinhar quando realmente não dá para saber. Dizer uma vez basta; ele anota a resposta.
Instala: Trabalhar em issues atribuídas.
Slack
Conectar o Slack permite que qualquer pessoa mencione o goblin numa thread e receba resposta onde a conversa está acontecendo. O token do bot não expira, então não há nada para renovar. O Slack também é onde loops agendados entregam digests e lembretes quando a instrução nomeia um canal.
Não instala loops próprios — é uma superfície, não um gatilho.
Microsoft Teams
Mencione o goblin num canal do Teams, num chat em grupo ou numa mensagem direta e ele responde ali mesmo, editando a própria mensagem conforme o trabalho avança. Conectar verifica seu tenant da Microsoft; não há token de bot para você gerenciar.
Não instala loops próprios.
Como o goblin se autentica como ele mesmo
Você nunca cola um token de acesso pessoal no TaskGoblin, e o goblin nunca vê suas credenciais.
Cada provedor tem sua própria identidade de bot — @taskgoblin no GitLab, Slack e Teams, taskgoblin[bot] no GitHub. Dentro do sandbox, as credenciais git são provisionadas por organização em tempo de execução (um token OAuth do GitLab, ou um token de instalação do GitHub recém-emitido) e injetadas no ambiente em volta do agente, em vez de entregues a ele para ler.
Essa fronteira é deliberada e também explica por que o goblin comenta pelas próprias integrações e não pelo token git que recebeu: comentários publicados com o seu token apareceriam com o seu nome. Tudo o que um goblin diz, ele diz como ele mesmo.
Desconectando
Desconecte um provedor na página de Integrações e os goblins perdem aquele acesso imediatamente — os loops que dependiam dele param de disparar, e nada mais é lido ou publicado ali. Reconectar restaura a mesma conexão.
Para onde ir agora
- Loops de evento — o que os loops padrão de cada provedor fazem e como mudá-los.
- Execuções pontuais — mencionar o goblin direto em qualquer superfície conectada.
- Início rápido — o caminho inteiro do cadastro ao seu primeiro loop.