Connecting GitLab to dx0

Connect your GitLab account, choose the projects that matter, and ask dx0 plain-language questions about how they work. You get answers grounded in the source code, commit history and merge requests.

Use this when you need to understand a codebase that sits next to your Salesforce org: a middleware service, a customer-facing app, an SFDX project, or configuration for another system. You don't need to clone it or read it yourself.

How it works

There are three steps:

1. Connect a GitLab account. This gives dx0 read-only access to the projects that account can see.
2. Choose specific repositories. Out of everything the account can reach, you pick the projects your team cares about and tell dx0 what each one is.
3. Ask questions. Choose a repository in Quick Chat and start a conversation.

Only workspace admins can connect GitLab and add repositories. Once a repository is connected, every member of the workspace can ask questions about it.

Before you start

• Use the right GitLab account. GitLab has no per-project picker, so dx0 can read every project the authorizing account can access, across all its groups and subgroups. To limit that reach, connect a dedicated account that only belongs to the groups you want dx0 to see.
• The account needs Reporter access or higher. Projects where the account is only a Guest won't appear.
• The connection belongs to a person. If that person revokes access in GitLab, or leaves the company and their account is deactivated, the connection stops working and someone needs to reconnect.
• gitlab.com only. Self-managed GitLab instances aren't supported yet.

Step 1: Connect your GitLab account

1. In dx0, go to Settings → GitLab.
2. Click Connect GitLab. GitLab opens in a new tab.
3. Sign in if you need to, review the permissions, and click Authorize.
4. Go back to the dx0 tab. The connection appears with a connected status.

dx0 only requests read-only scopes: read_user, read_api, read_repository and email. It can't push code, open merge requests or change project settings.

To confirm access, click Load projects, choose a project, and click Check Connection.

You can connect more than one GitLab account per workspace. Use Connect another account if different groups sit under different users.

Step 2: Choose which repositories to connect

1. Go to Connections → Git Repositories.
2. Click Add repository.
3. Under Connection, choose your GitLab account (shown as GitLab · <account>).
4. Under Repository, search for and choose the project. Projects that are already connected are greyed out.
5. Fill in the repository details (see below) and click Connect.

Before saving, dx0 checks that it can actually read the repository. If it can't, you see the reason and the dialog stays open.

The repository details matter

dx0 reads these details before it reads any code. Take a minute to fill them in properly. They change how good the answers are.

• What does this repo represent? (required): a Salesforce DX repository, a customer-facing product, an internal service or application, or configuration for another application. dx0 approaches each one differently.
• What is this called? The name your team uses, such as "Billing Service" rather than acme/svc-bl-2. dx0 uses this name in its answers.
• What does it do? A short paragraph covering who uses it, what it integrates with, which parts are legacy or being retired, and where the tricky areas are. This is the context the code can't give on its own.

You can edit the details later on the repository's page.

Managing a connected repository

Click a repository in the list to open its page. From there you can:

• Get latest: pull the newest commits on the default branch into dx0 right away. dx0 also refreshes on its own every few hours.
• Check connection: confirm that dx0 can still read the project.
• Edit: update the name, type and description.
• Remove: disconnect the repository from dx0. Nothing changes on GitLab.

Step 3: Ask questions in Quick Chat

1. Open Quick Chat from the sidebar.
2. In the connection picker, choose your repository under Repositories.
3. Type a question, or start from one of the prompt templates under the composer.

Troubleshooting

The connection is healthy but lists no projects. The most common cause is a GitLab group that enforces SAML SSO. dx0 can't see projects in those groups yet. Otherwise, check that the account has at least Reporter access.

A repository shows as Orphaned. dx0 lost access, usually because the GitLab account was disconnected or its authorization was revoked. Reconnect GitLab in Settings, then click Check connection on the repository. Your repository details are kept.

Quick Chat says to set the repository type. Open the repository from Connections → Git Repositories, click Edit, and choose what it represents.

Disconnecting GitLab. On Settings → GitLab, use the trash icon on the account. dx0 revokes the authorization on GitLab and deletes its stored tokens, so access ends immediately. Repositories that used that account are marked Orphaned rather than deleted.