> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blitzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab Cloud

> Connect GitLab Cloud repositories to Blitzy for AI-Native code generation

GitLab Cloud integration lets Blitzy access your repositories to analyze code, create branches, and push commits.

## Setup

<Steps>
  <Step title="Open Integrations">
    Navigate to **Settings > Integrations** in your Blitzy dashboard.
  </Step>

  <Step title="Connect GitLab">
    Click **Connect** on **GitLab**. A **Connecting to GitLab** modal will appear and complete automatically in a few seconds.
  </Step>
</Steps>

## Permissions

The Blitzy GitLab Cloud App requires the following permissions, scoped to the minimum level needed.

| Permission         | Access Level | Purpose                                                                                                                   |
| ------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------- |
| `api`              | Read & Write | Access all groups, projects, container registry, dependency proxy, and package registry                                   |
| `read_user`        | Read         | Read your profile via the `/user` endpoint (username, public email, full name) and read-only access to `/users` endpoints |
| `write_repository` | Read & Write | Read and write to repositories on private projects using Git-over-HTTP                                                    |

### Permission Mapping Reference

| Operation            | Required Scope     | GitLab API         |
| -------------------- | ------------------ | ------------------ |
| Clone repository     | `write_repository` | Git-over-HTTP      |
| Create branch        | `write_repository` | Git-over-HTTP      |
| Push commits         | `write_repository` | Git-over-HTTP      |
| Create merge request | `api`              | Merge Requests API |
| List projects        | `api`              | Projects API       |
| Read user identity   | `read_user`        | Users API          |

For GitLab-specific troubleshooting (OAuth errors, permission issues, rate limits), see [Troubleshooting](/integrations/troubleshooting#gitlab-troubleshooting).