GitLab Repository Setup Guide

Last updated: February 19, 2026

Connect GitLab repositories (cloud or self-hosted) to Exceeds AI for tracking AI coding tool effectiveness, developer productivity, and code quality metrics. This guide covers OAuth setup, self-hosted GitLab configuration, permissions, sync processes, and troubleshooting.

Overview

Exceeds integrates with GitLab.com and self-hosted GitLab instances to analyze commit metadata, merge request data, and development patterns. The platform detects AI tool usage and correlates it with productivity and quality outcomes.

What You'll Track:

  • AI-assisted code contribution rates

  • Developer productivity improvements

  • Code quality and bug rate trends

  • Merge request cycle times and review metrics

  • Team and individual AI tool adoption

Data Privacy: Exceeds reads only metadata (commit messages, timestamps, file paths, MR data). Source code content is never accessed or stored.

GitLab Cloud (gitlab.com)

For repositories hosted on gitlab.com, use OAuth connection for easiest setup.

Prerequisites

  • GitLab.com account with access to projects you want to track

  • Minimum role: Reporter for read-only access, Developer or higher for full metrics

  • Admin approval may be required for group-level OAuth apps (depending on group settings)

OAuth Connection Steps

Step 1: Initiate Connection (if you are connecting after initial onboarding)

  1. Log into Exceeds Dashboard

  2. Navigate to Settings (gear icon in sidebar)

  3. Click Integrations tab

  4. Find GitLab section

  5. Click Connect GitLab button

Step 2: Authorize on GitLab

You'll be redirected to gitlab.com:

  1. Review Requested Permissions:

    Exceeds requests these OAuth scopes:

    • read_api: Read-only access to API endpoints

    • read_repository: Access to repository metadata and commit history

    What Exceeds CAN access:

    • Project metadata (name, description, language)

    • Commit history and statistics

    • Merge request data

    • Pipeline results (pass/fail status)

    What Exceeds CANNOT access:

    • Source code file contents

    • MR/issue comment text

    • CI/CD variable values

    • Project settings or configurations

  2. Select Projects (if prompted):

    • Some GitLab configurations allow per-project authorization

    • Check projects you want to track

    • Can add more projects later

  3. Click "Authorize"

Step 3: Project Selection in Exceeds

After redirect back to Exceeds:

  1. View Available Projects:

    • Lists all projects you have access to

    • Shows project path, visibility (public/private), and last activity

  1. Select Projects to Track:

    • Check boxes for desired projects

    • Multi-select supported

    • Recommendation: Start with 3-5 active projects