TaskGoblin se conecta a dos tipos de herramientas, y la distinción determina cómo te registras:
- Un proveedor git — GitLab o GitHub — aporta tus repositorios y aprovisiona tu organización. Exactamente uno por organización, elegido al iniciar sesión.
- Los proveedores de capacidades — Linear, Jira, Slack y Microsoft Teams — añaden superficies donde los loops pueden dispararse y los goblins pueden reportar. Éstos se conectan a una organización que ya tienes.
Los gestionas todos desde Integraciones en el menú de tu organización (/{organisation}/integrations).
Conectar un proveedor instala sus loops por defecto. Ésa es la consecuencia práctica que conviene retener: una integración no es sólo una credencial, es un conjunto de comportamientos permanentes que llegan con ella. Consulta Loops de evento para ver qué instala cada una.
Proveedores git (GitLab o GitHub)
Iniciar sesión es conectar tu proveedor git: un único consentimiento OAuth te autentica y aprovisiona tu organización y tus repositorios. Por eso no hay un paso aparte de "conecta tu repo".
GitLab
Conectar GitLab enumera los grupos a los que perteneces y aprovisiona una organización de TaskGoblin para cada uno, más una organización personal. El goblin publica como @taskgoblin en merge requests e issues. Si el token necesita refrescarse, la página de Integraciones ofrece Reconectar en un clic.
Instala: Revisar merge requests, Trabajar en issues asignados.
GitHub
GitHub es una GitHub App, no una app OAuth clásica. Instalas la app de TaskGoblin en la organización que quieras, y cada instalación se convierte en una organización de TaskGoblin. La app emite tokens de instalación de corta vida bajo demanda y el goblin publica como taskgoblin[bot]. Como los permisos se refrescan a través de la propia instalación, las organizaciones de GitHub nunca necesitan una reconexión manual.
Instala: Revisar pull requests, Trabajar en issues etiquetados.
Una organización aprovisionada por git queda ligada al proveedor que la creó: la tarjeta de ese proveedor ofrece Reconectar en lugar de Desconectar.
Proveedores de capacidades
Linear
Un consentimiento OAuth de un clic sobre tu organización activa. Una vez conectado, los goblins recogen issues asignados al agente TaskGoblin, leen el issue y sus comentarios como contexto, y publican estado, actividad y el enlace del merge request de vuelta en el issue.
Instala: Trabajar en issues asignados.
Jira
Un consentimiento OAuth de Atlassian que conecta tu sitio de Jira a la organización activa. Los goblins recogen issues asignados a la cuenta de TaskGoblin y responden a menciones en comentarios, contestando como comentario en el issue y moviéndolo por tu flujo cuando se lo pides.
Un issue de Jira rara vez nombra un repositorio, así que el goblin deduce el destino a partir de la petición, de tu memoria de organización y de tus repositorios conectados — y pregunta en vez de adivinar cuando realmente no puede saberlo. Decírselo una vez basta: anota la respuesta.
Instala: Trabajar en issues asignados.
Slack
Conectar Slack permite que cualquiera mencione al goblin en un hilo y reciba respuesta donde está ocurriendo la conversación. El token del bot no caduca, así que no hay nada que refrescar. Slack es además donde los loops programados entregan resúmenes y recordatorios cuando la instrucción nombra un canal.
No instala loops propios: es una superficie, no un disparador.
Microsoft Teams
Menciona al goblin en un canal de Teams, un chat de grupo o un mensaje directo y responde ahí mismo, editando su propio mensaje según avanza el trabajo. Conectar verifica tu tenant de Microsoft; no hay ningún token de bot que tengas que gestionar.
No instala loops propios.
Cómo se autentica el goblin como sí mismo
Nunca pegas un token de acceso personal en TaskGoblin, y el goblin nunca ve tus credenciales.
Cada proveedor tiene su propia identidad de bot — @taskgoblin en GitLab, Slack y Teams, taskgoblin[bot] en GitHub. Dentro del sandbox, las credenciales git se aprovisionan por organización en tiempo de ejecución (un token OAuth de GitLab, o un token de instalación de GitHub recién emitido) y se inyectan en el entorno alrededor del agente, en lugar de entregársele como algo que leer.
Esa frontera es deliberada, y también explica por qué el goblin comenta a través de sus propias integraciones en vez del token git que se le dio: los comentarios publicados con tu token aparecerían con tu nombre. Todo lo que dice un goblin, lo dice como él mismo.
Desconectar
Desconecta un proveedor desde la página de Integraciones y los goblins pierden ese acceso de inmediato: los loops que dependían de él dejan de dispararse, y no se lee ni se publica nada más allí. Reconectar restaura la misma conexión.
Adónde ir después
- Loops de evento — qué hacen los loops por defecto de cada proveedor y cómo cambiarlos.
- Ejecuciones puntuales — mencionar al goblin directamente en cualquier superficie conectada.
- Guía rápida — todo el camino desde el registro hasta tu primer loop.