Skip to main content
Replicas responds to GitLab issue and merge request comments, maintaining context across all interactions. It works on gitlab.com and self-managed GitLab instances.

Setup

  1. Go to Integrations settings
  2. Select GitLab under Source control, then click Connect and authorize your account
  3. Add the GitLab projects you want Replicas to access
Once a project is added to your organization, mention @tryreplicas on any issue or merge request in that project.
Each project can only be connected to one Replicas organization. To move a project, remove it from its current organization first.

How It Works

Workspaces created from GitLab triggers use your organization’s default coding agent and model.

Trigger from GitLab Issues

Add @tryreplicas to any comment on a GitLab issue to start a new task.
  • Replicas creates a new workspace to work on the issue
  • The agent provides an implementation plan before making changes
  • When complete, the agent opens a merge request and comments on the issue with a link and a summary of the changes
Each issue is linked to one workspace; all interactions on the issue route to the same workspace.

Trigger from Merge Requests

Add @tryreplicas to any merge request comment.
  • If the merge request was opened by a Replicas agent, it sees your comment, makes changes, and responds directly.
  • If the merge request was opened by someone else, a new workspace and agent are spun up.
Each merge request is linked to one workspace, so the agent remembers previous work. If the workspace is sleeping, it wakes automatically.

Trigger Automations

Automations can run from GitLab merge request events including opened, updated, merged, and closed. You can filter triggers to specific projects and group follow-up MR events into the workspace created by the first matching event.

Auto Respond To Bots And Users

Configure an allowlist to automatically react to specific GitLab accounts (bots or users) without requiring @tryreplicas. Accounts not on the allowlist cannot trigger Replicas.

CI/CD Failure Auto-Response

When a GitLab pipeline fails on a merge request linked to a Replicas workspace, the agent is automatically notified, reads the failure logs, diagnoses the issue, pushes a fix, and comments on the merge request. Toggle this in Organization Settings → CI Failure Response (enabled by default).

MR Attribution

Merge requests created by Replicas agents use the Replicas bot by default. Connect a personal GitLab account under Integrations settings to attribute merge requests to your own account. Organizations can require user attribution with Organization → Settings → Security → Require PR user attribution, which applies to GitLab as well as GitHub. See PR attribution for how the policy resolves.

MR Merge Blocking

When Organization → Settings → Security → Block agent PR/MR merges is enabled, agents are blocked from merging merge requests, the same as for GitHub PRs. See PR merge blocking.

Draft Merge Requests

With Open new PRs as drafts enabled (Account → Preferences, or the org default), agents open new merge requests as drafts via the merge_request.draft push option. See Draft pull requests.

Context

For issues, the context includes the issue number, title, description, and your comment body. For merge requests, the context includes the MR number and branch, and your comment body.

Intended Usage

Use GitLab Issues to start new features or bug fixes from issue tracking and track work from issue to merge request automatically. Use GitLab Merge Requests to request changes, comment, and ask for fixes or improvements. Start your comment with /plan to request a planning-only response with a plan link. See Plan Mode.