How m13tlabs/ai-agent-for-gitlab works
The product receives GitLab comment and merge-request events, decides whether to start an agent job, and launches a CI pipeline. The runner prepares the repository and context, invokes OpenCode (with an optional MCP server), then reports results back to GitLab. Separate capabilities include rate limiting, merge-request review suggestions, automated GitLab setup, and Kubernetes deployment. Edges reflect excerpted calls or README-documented behavior; unsampled setup and chart internals are represented only at their supported directory paths.
Main entry points: runner.ts Job orchestration · index.ts Event handling · mcp.ts MCP server · ai-agent-for-gitlab Kubernetes chart
Components 21
Webhook app
- Webhook endpoint
gitlab-app/src/index.ts - Event handling
gitlab-app/src/index.ts - Rate limiting
gitlab-app/src/limiter.ts - GitLab API client
gitlab-app/src/gitlab.ts - Review prompting
gitlab-app/src/index.ts
CI agent runner
- Runner entry
agent-image/scripts/ai-runner.ts - Job orchestration
agent-image/scripts/src/runner.ts - Job context
agent-image/scripts/src/context.ts - Repository operations
agent-image/scripts/src/git.ts - Configuration checks
agent-image/scripts/src/config.ts - Job output
agent-image/scripts/src/output.ts
GitLab and AI integrations
- OpenCode execution
agent-image/scripts/src/opencode.ts - MCP server
agent-image/scripts/mcp/mcp.ts - Runner GitLab API
agent-image/scripts/src/gitlab.ts - Code suggestions
agent-image/scripts/src/suggestion.ts
Deployment and setup
- GitLab setup automation
gitlab-app/src/setup.ts - Kubernetes chart
charts/ai-agent-for-gitlab
Other components
- GitLab user
- GitLab
- Redis rate store
- CI pipeline
Connections 27
- GitLab user → GitLab: mentions @ai / assigns reviewer
README.md - GitLab → Webhook endpoint: sends event
README.md - Webhook endpoint → Event handling: routes event
gitlab-app/src/index.ts - Event handling → Rate limiting: checks limit
gitlab-app/src/index.ts - Rate limiting → Redis rate store: tracks requests
gitlab-app/src/limiter.ts - Event handling → Review prompting: builds review prompt
gitlab-app/src/index.ts - Event handling → GitLab API client: requests pipeline and GitLab actions
gitlab-app/src/index.ts - GitLab API client → GitLab: calls API
gitlab-app/src/gitlab.ts - Event handling → CI pipeline: triggers job
gitlab-app/src/index.ts - CI pipeline → Runner entry: runs agent
README.md - Runner entry → Job orchestration: starts
agent-image/scripts/ai-runner.ts - Job orchestration → Job context: builds context
agent-image/scripts/src/runner.ts - Job orchestration → Configuration checks: validates
agent-image/scripts/src/runner.ts - Job orchestration → Repository operations: prepares checkout
agent-image/scripts/src/runner.ts - Repository operations → GitLab: clones, pulls, and pushes repository
agent-image/scripts/src/git.ts - Job orchestration → OpenCode execution: runs agent
agent-image/scripts/src/runner.ts - OpenCode execution → MCP server: configures MCP command
agent-image/scripts/src/opencode.ts - MCP server → GitLab: accesses GitLab
- Job orchestration → Runner GitLab API: posts comments
agent-image/scripts/src/runner.ts - Runner GitLab API → GitLab: posts result
agent-image/scripts/src/gitlab.ts - Job orchestration → Job output: writes status
agent-image/scripts/src/runner.ts - Review prompting → CI pipeline: sets review job variables
README.md - MCP server → Code suggestions: uses suggestion helpers
agent-image/scripts/mcp/mcp.ts - Code suggestions → GitLab: posts native suggestions
- GitLab setup automation → GitLab: configures bot account
README.md - Kubernetes chart → Webhook endpoint: deploys app
README.md - Kubernetes chart → CI pipeline: supports Kubernetes deployment
README.md