GitLab Integration

Set up GitLab webhooks for automated task creation from merge requests, issues, and comments

Agent Swarm supports GitLab alongside GitHub through a provider adapter pattern. GitLab webhooks create tasks from MR reviews, issue assignments, and @mentions — just like the GitHub integration.

Setup

Go to your GitLab project or group Settings > Webhooks
Set the webhook URL: https://your-server.com/api/gitlab/webhook
Set a secret token for verification
Select the events you want to receive

Events to Enable

Merge request events
Issue events
Note (comment) events
Pipeline events

Configuration

# Required for GitLab webhooks
GITLAB_WEBHOOK_SECRET=your-webhook-secret

# GitLab API access (PAT or Group Access Token)
GITLAB_TOKEN=your-gitlab-token

# Optional: GitLab instance URL (default: https://gitlab.com)
GITLAB_URL=https://gitlab.com

# Optional: Bot name for @mentions (default: agent-swarm-bot)
GITLAB_BOT_NAME=your-bot-name

# Optional: Disable GitLab integration
GITLAB_DISABLE=true

Supported Events

Event	What happens
Bot assigned to MR/issue	Creates a task for the lead agent
`@bot-name` in comment/issue/MR	Creates a task with the mention context
Pipeline failure (on MRs with existing tasks)	Creates a CI notification task

Worker Git Configuration

Workers have glab CLI pre-installed for GitLab operations. Configure git credentials for GitLab repos:

GITLAB_TOKEN=your-gitlab-token    # For git operations and glab CLI
GITLAB_EMAIL=worker@example.com   # Git commit email for GitLab repos
GITLAB_NAME=Worker Agent          # Git commit name for GitLab repos

The runner automatically detects whether a task targets a GitHub or GitLab repository and uses the appropriate CLI tool (gh or glab).

Agent Swarm uses a provider adapter pattern to support both GitHub and GitLab. When a task is created from a webhook event, the vcsProvider field is set automatically. Workers use this to select the right CLI:

Operation	GitHub (`gh`)	GitLab (`glab`)
Create PR/MR	`gh pr create`	`glab mr create`
View PR/MR	`gh pr view`	`glab mr view`
Review	`gh pr review`	`glab mr approve` / `glab mr note`
Comment on issue	`gh issue comment`	`glab issue note`
Clone	`gh repo clone`	`glab repo clone`

Workflow Triggers

GitLab events can trigger workflows:

gitlab.merge_request.opened
gitlab.merge_request.merged
gitlab.merge_request.closed
gitlab.issue.opened
gitlab.issue.closed
gitlab.note.created
gitlab.pipeline.failed
gitlab.pipeline.success

GitHub Integration — GitHub webhook setup
Environment Variables — GitLab configuration variables
Workflows — Automate actions on GitLab events
Task Lifecycle — How webhook events become tasks