Skip to main content

GitLab Integration

Connect GitLab to enable the AI agent to create branches, push commits, and open merge requests in your projects.

note

Integration settings are only visible to users with the Admin role. Regular users cannot access or modify integration configuration.

Connecting via OAuth​

  1. Navigate to Settings → Integrations → GitLab
  2. Click Connect with OAuth
  3. A popup window opens to GitLab's OAuth authorization screen
  4. Grant Clears AI access to your GitLab.com group
  5. The popup closes and the connection status updates

Once connected, the integration card displays your group name and connection timestamp.

Projects​

After connecting GitLab, a table displays all accessible projects from your group with their name, description, and default branch.

Use the Search bar to filter projects by name. Results are paginated — use the page size selector (25, 50, or 100) and page controls to navigate large project lists.

Click Refresh to reload the project list from GitLab if you've recently added new projects to your group.

Adding Projects for AI Execution​

In the projects table, use the + Add button next to a project to register it for AI execution. This simultaneously:

  • Adds the project to your execution repositories list
  • Registers a Clears webhook on the project for real-time event monitoring

Click Unuse to remove a project from the execution list and unregister its webhook.

Watching Projects​

If the AI-SDLC feature is not enabled, the projects table shows a Watch toggle instead. Toggle Watch on to register a Clears webhook for monitoring merge requests, pushes, and pipeline events on that project.

Excluded Paths​

Filter out projects you don't want to see in the project list by adding path prefixes.

  1. Open the Excluded Paths section
  2. Type a path prefix (e.g., my_group/archived) and press Enter to add it
  3. Projects whose path starts with any excluded prefix are hidden from the list
  4. Click Save to apply changes, or Discard to revert

This is useful for hiding archived projects, forks, or internal tooling that the AI agent should not access.

Execution Repositories​

The Execution Repositories section displays all projects currently configured for AI agent execution as a list of chips. This is a read-only summary — manage the list using the + Add and Unuse buttons in the projects table above.

Only projects listed here appear as options when creating stories on the Board. The AI agent cannot access projects that are not selected as execution repositories.

Webhook Management​

Clears AI automatically manages webhooks on your GitLab projects. When you add a project for execution or toggle Watch on, a webhook is registered to receive events for:

  • Merge request updates
  • Push events
  • Pipeline status changes

The webhook status is displayed per-project in the projects table. Webhooks are automatically removed when you remove a project from the execution list or toggle Watch off.

Disconnecting​

Click Disconnect to revoke the OAuth connection. This removes Clears AI's access to your GitLab group and all registered webhooks.