๐ŸฆŠ ๐Ÿค–

GitLab AI Agent

Autonomous Coding Engine & Control Center

๐Ÿ”’ Administrator authentication required to access this service
๐Ÿ›ก๏ธ AES-256 Symmetrically Encrypted at Rest โ€ข JWT Authenticated
๐ŸฆŠ
GitLab AI Agent
Autonomous Coding Engine
A
admin Admin
Total Task Executions
0
Issues & MR Notes processed
Successful Tasks
0
Code committed & merged
Active Coding Agents
0
Ready for webhook triggers
Currently Running
0
In queue or active workspace
๐Ÿš€ Service Health & Status
Overview of active integration pipelines
๐ŸฆŠ GitLab Connection: Not Configured
๐Ÿค– Agents: Initializing
โšก Webhook Endpoint: Ready (/api/webhooks/gitlab)

Recent Webhook Activity

Status Event Project Issue / MR Agent User Time Action
Loading recent jobs...
๐Ÿค– AI Coding Agents
Configure your AI coding agents, models, trigger labels, and system instructions.
๐Ÿ“– Agent Setup & API Key Guide
How to obtain API keys and configure each supported AI coding provider.
โœจ Google Antigravity (Gemini) Free Tier Available
Connects directly to Google's Gemini models via the official Google GenAI SDK.
  • Get API Key: Google AI Studio โ†—
  • Recommended Models: gemini-2.0-flash, gemini-1.5-pro
  • Default Trigger Labels: ai-agent, antigravity, gemini
  • Base URL: Leave empty (uses official endpoint)
๐Ÿง  Claude Code (Anthropic) State-of-the-Art
Uses Anthropic's Claude 3.7 Sonnet for precise code refactoring and multi-file edits.
  • Get API Key: Anthropic Console โ†—
  • Recommended Models: claude-3-7-sonnet-20250219, claude-3-5-sonnet-20241022
  • Default Trigger Labels: claude, claude-code, anthropic
  • Base URL: Leave empty (uses official endpoint)
โšก OpenCode (Docker / Server) Local & Cloud
OpenCode runs as an autonomous coding container service in your Docker network.
  • Docker Image: ghcr.io/anomalyco/opencode:latest
  • Base URL: http://opencode:4096 (Docker) or http://localhost:4096
  • Recommended Models: zen, qwen2.5-coder-32b, deepseek-coder
  • Default Trigger Labels: opencode, qwen
  • API Key: Optional (only needed if auth is enabled)
๐Ÿฆ™ Custom / Ollama / vLLM Self-Hosted
Compatible with local OpenAI-compatible endpoints (Ollama, vLLM, LiteLLM).
  • Ollama Base URL: http://host.docker.internal:11434/v1
  • vLLM Base URL: http://vllm-host:8000/v1
  • Models: qwen2.5-coder:32b, deepseek-coder-v2
  • Default Trigger Labels: custom (e.g. local-llm, ollama)
๐ŸฆŠ GitLab Instance Configuration
Connect your self-hosted or cloud GitLab instance without requiring GitLab Ultimate.
URL of your GitLab instance (without trailing slash).
๐Ÿ”‘ Required Access Token Scopes (3 Checkboxes in GitLab):
api read_repository write_repository
โ€ข api: Grants REST API access to manage Issues, Merge Requests, comments, user resolution & reactions.
โ€ข read_repository: Grants Git access to clone and inspect repository files in the agent workspace.
โ€ข write_repository: Grants Git access to push commits and create feature branches.
โ€ข Minimum Role Required: The token owner must have at least Developer permissions on the target repositories/groups.
Used for automatic 1-click webhook registration across all your repositories and System Hooks.
Must match the Secret Token configured in your GitLab Webhook settings.
Used to prevent recursive feedback loops when bot comments on MRs.
Set to auto to automatically detect each repository's default branch (main, master, etc.) via GitLab API.
๐Ÿ“œ Execution Job Explorer
Audit history, live execution logs, and code modifications.
Job ID Status Event Project Issue / MR Agent User Started Action
Loading jobs...
๐Ÿ”— Complete GitLab Webhook Configuration Guide
Step-by-step instructions, token scopes, and required trigger events to enable autonomous AI agents.
โšก Automated 1-Click Webhook Sync (No Manual Setup Required)
You don't need to manually configure webhooks in dozens of repositories! Click the button to automatically attach the required webhooks to all GitLab projects accessible to your bot account.
๐Ÿ”‘
Prerequisite: Create GitLab Access Token with Required Scopes

Before configuring webhooks, generate a Personal Access Token (PAT) or Project/Group Access Token in GitLab:

Where to create: In GitLab, go to User Settings โž” Access Tokens (or Project/Group Settings โž” Access Tokens).
Required Scope Why this scope is mandatory
api Grants full read/write REST API access for creating Merge Requests, updating issue notes, adding award reaction emojis (๐Ÿ‘, ๐Ÿ‘Ž), and resolving assignees.
read_repository Allows the AI Agent worker to clone your repository files into an isolated workspace for analysis.
write_repository Allows the AI Agent worker to push commits and feature branches directly to the remote repository.
โš ๏ธ Important: Ensure the token owner has at least Developer permissions on the target repositories so GitLab allows pushing commits and creating branches.
1
Navigate to Webhook Settings in GitLab

You can configure the webhook at the Project level (for a specific repository) or at the Group level (to automatically enable AI agents across all repositories in a team or organization):

Project Level: Go to your Repository โž” Settings (left sidebar) โž” Webhooks โž” Click Add new webhook
Group Level: Go to your Group โž” Settings (left sidebar) โž” Webhooks โž” Click Add new webhook
2
Enter Webhook URL & Secret Token
๐Ÿ’ก Tip: Clicking "Generate Random Token" creates a cryptographically secure 32-character token and automatically links it to your GitLab Settings.
3
Select Required Trigger Checkboxes

In the Trigger section of GitLab Webhook settings, configure the following checkboxes:

GitLab Trigger Status Why this trigger is required
Issues events โœ… Mandatory Essential for task pickup: Triggers when an issue is created or assigned an agent trigger label (e.g. ai-agent, antigravity, or claude-code). The service immediately acknowledges with ๐Ÿ‘, creates the feature branch, opens the Merge Request, and assigns the user.
Comments โœ… Mandatory Essential for MR feedback loop: Triggers when a developer leaves review feedback comments on the agent's Merge Request. The agent locks the comment with ๐Ÿ‘, updates the codebase, commits, pushes, and summarizes the adjustments.
Pipeline events โœจ Recommended (Auto-Repair) Autonomous CI Self-Healing: Triggers when a CI Pipeline on an agent branch or Merge Request fails. The agent downloads failed job console logs/traces, diagnoses the error (e.g. failing unit tests, linter errors, missing imports), modifies the code in the workspace, commits a fix, and reports back on the MR (protected with a max-3-attempts loop guard).
Confidential comments โ„น๏ธ Optional Check this only if your repository processes private security notes or confidential MR feedback discussions.
Confidential issues events โ„น๏ธ Optional Check this only if your team assigns AI agent labels to confidential/vulnerability issues.
Push events, Wiki, Releases, etc. โŒ Uncheck Leave other checkboxes unchecked to prevent unnecessary webhook traffic and avoid overloading your server.
4
SSL Verification & Save
  • ๐Ÿ”’ Enable SSL verification: Check this box if your service is behind HTTPS (reverse proxy with SSL / Cloudflare Tunnel / Traefik).
  • ๐Ÿš€ Click Add webhook at the bottom of the page in GitLab.
  • ๐Ÿงช In GitLab under your newly created webhook, click Test โž” Issues events. It should return HTTP 200 OK.
5
Instance-Wide System Hook (Auto-Register on Project Creation)

If you run a self-hosted GitLab instance (CE/EE), you can configure a System Hook so newly created repositories are automatically connected without any manual work:

Where to configure: In GitLab Admin Area โž” Overview (or Settings) โž” System Hooks (/admin/hooks)
URL: Paste your Webhook URL (.../api/webhooks/gitlab)
Secret Token: Paste your configured Webhook Secret Token
Trigger: Check โœ… Repository update events / Push events
โœจ How it works: Whenever a new project is created on your GitLab server, GitLab sends a project_create system hook event. The AI Agent Service intercepts this event and automatically registers the project webhook with all required issue, note, and CI triggers on that new project!

๐Ÿงช Interactive Webhook Simulator
Test how the service processes Issue webhook payloads directly in your browser.
๐Ÿ‘ฅ User Management
Manage colleague access, accounts, and administrator permissions.
User ID Username Role Created At Actions
Loading users...
๐Ÿค– Configure AI Coding Agent
Issues with these labels will trigger this agent.
Stored with AES symmetric encryption at rest.
Leave empty for provider default endpoint.
Enable Agent for Webhooks
๐Ÿ” Review-Only Mode
Agent only reviews Merge Requests and never modifies code.
Job Execution Details
UUID: ...

๐Ÿ“‹ Summary of Changes

Agent Execution Terminal
LIVE
Connecting to log stream...
๐Ÿ‘ฅ Add New User
Create a colleague account with custom permissions.
At least 4 characters long. (Leave blank on edit to keep existing password).
Administrator Privileges
Can manage GitLab settings, AI agents, and users. Without this, the user has read-only access to Dashboard, Job Explorer, and Webhook Guide.
๐Ÿ”‘ Change Password