Esta guía rápida te lleva de una cuenta nueva a tu primer merge request escrito por el agente. Debería tomar unos minutos — la mayor parte es esperar al agente, no hacer clics de configuración.
Antes de empezar
Necesitas acceso de administrador a un grupo de GitLab o a una organización de GitHub cuyos repositorios quieras que el agente trabaje y — para el primer arranque más suave — un espacio de Linear. Eso es todo: no hay nada que instalar localmente ni claves que copiar de un lado a otro.
Paso 1 — Inicia sesión
Ve a la página de inicio de sesión y entra con GitLab o GitHub. Este único consentimiento te autentica y a la vez aprovisiona tu organización: TaskGoblin crea una organización por cada uno de tus grupos remotos (GitLab) o por la instalación de la app (GitHub), así que tus repositorios quedan conectados en cuanto entras.
Para GitHub, instalas la GitHub App de TaskGoblin en la organización que quieras; el token de instalación de la app es la identidad del bot que publica como taskgoblin[bot]. Para GitLab, el consentimiento OAuth enumera tus grupos y los conecta.
Paso 2 — Conecta tu gestor de issues
Abre Integraciones desde el menú de tu organización y conecta Linear. Es un consentimiento OAuth de un clic que permite a TaskGoblin ver los issues que se le asignan y publicar actualizaciones de vuelta. Si tu equipo vive en Slack, conecta Slack también aquí — así podrás mencionar al goblin en cualquier hilo.
Consulta Conecta tus integraciones para la lista completa y lo que desbloquea cada una.
Paso 3 — Asígnale una tarea al agente
Ahora delega algo de trabajo. La primera tarea más sencilla es un cambio pequeño y bien descrito — un ajuste de texto, un refactor pequeño, un test que falta.
- En Linear: abre un issue, describe el cambio con claridad y pon a TaskGoblin como responsable.
- En GitHub: añade la etiqueta
taskgoblina un issue. - En GitLab: asigna un issue al bot
@taskgoblin.
TaskGoblin recoge la tarea automáticamente — la asignación o la etiqueta es el disparador. No hay cola que vigilar ni botón que pulsar.
Paso 4 — Míralo trabajar
El agente levanta un sandbox, clona el repositorio y empieza a trabajar en una rama llamada ai-{identificador-del-issue}. Publica el progreso de vuelta en el issue a medida que avanza, así que puedes seguirlo sin abrir nada nuevo. Cuando termina, hace commit, empuja y abre un merge request (o pull request) enlazado de vuelta al issue.
Paso 5 — Revisa e itera
Revisa el merge request exactamente como lo harías con el de un compañero. Si algo hay que cambiar, no reabras una ventana de chat — solo deja un comentario de revisión y menciona @taskgoblin, o responde en el issue. El agente retoma en la misma rama, con todo el contexto de la ejecución hasta ese momento, y empuja un commit de seguimiento. Consulta Asigna trabajo al agente para cada forma de volver a lanzarlo.
Lo que acabas de hacer
Conectaste tus herramientas, delegaste una tarea por la superficie que tu equipo ya usa y recibiste de vuelta un merge request revisable — sin que el agente tocara nunca tu portátil. Ese es todo el ciclo. Todo lo demás en esta documentación son detalles encima de él.