Este início rápido leva você de uma conta nova ao seu primeiro merge request escrito pelo agente. Deve levar alguns minutos — a maior parte é esperar o agente, não clicar pela configuração.
Antes de começar
Você precisa de acesso de administrador a um grupo do GitLab ou a uma organização do GitHub cujos repositórios você quer que o agente trabalhe e — para a primeira execução mais tranquila — um workspace do Linear. É só isso: não há nada para instalar localmente nem chaves para copiar de um lado para o outro.
Passo 1 — Entre
Vá para a página de login e entre com GitLab ou GitHub. Esse único consentimento autentica você e ao mesmo tempo provisiona sua organização: o TaskGoblin cria uma organização para cada um dos seus grupos remotos (GitLab) ou para a instalação do app (GitHub), então seus repositórios ficam conectados assim que você entra.
No GitHub, você instala o GitHub App do TaskGoblin na organização que quiser; o token de instalação do app é a identidade do bot que publica como taskgoblin[bot]. No GitLab, o consentimento OAuth enumera seus grupos e os conecta.
Passo 2 — Conecte seu gerenciador de issues
Abra Integrações no menu da sua organização e conecte o Linear. É um consentimento OAuth de um clique que permite ao TaskGoblin ver as issues atribuídas a ele e publicar atualizações de volta. Se o seu time vive no Slack, conecte o Slack aqui também — assim você poderá mencionar o goblin em qualquer thread.
Veja Conecte suas integrações para a lista completa e o que cada uma libera.
Passo 3 — Atribua uma tarefa ao agente
Agora delegue algum trabalho. A primeira tarefa mais simples é uma mudança pequena e bem descrita — um ajuste de texto, um refactor pequeno, um teste faltando.
- No Linear: abra uma issue, descreva a mudança com clareza e defina o TaskGoblin como responsável.
- No GitHub: adicione a etiqueta
taskgoblina uma issue. - No GitLab: atribua uma issue ao bot
@taskgoblin.
O TaskGoblin pega a tarefa automaticamente — a atribuição ou a etiqueta é o gatilho. Não há fila para vigiar nem botão para apertar.
Passo 4 — Veja o agente trabalhar
O agente sobe um sandbox, clona o repositório e começa a trabalhar em uma branch chamada ai-{identificador-da-issue}. Ele publica o progresso de volta na issue conforme avança, então você acompanha sem abrir nada novo. Quando termina, faz commit, envia e abre um merge request (ou pull request) vinculado de volta à issue.
Passo 5 — Revise e itere
Revise o merge request exatamente como faria com o de um colega. Se algo precisa mudar, não reabra uma janela de chat — apenas deixe um comentário de revisão e mencione @taskgoblin, ou responda na issue. O agente retoma na mesma branch, com todo o contexto da execução até então, e envia um commit de acompanhamento. Veja Atribua trabalho ao agente para cada forma de mandá-lo de volta.
O que você acabou de fazer
Você conectou suas ferramentas, delegou uma tarefa pela superfície que o seu time já usa e recebeu de volta um merge request revisável — sem o agente nunca tocar no seu notebook. Esse é o ciclo inteiro. Todo o resto nesta documentação são detalhes em cima dele.