Configure with GitLab

Integrate Baz with GitLab repos to mirror your team's codebase and review changes.

Baz for GitLab is currently in Beta. For access click here.

Configure with GitLab

Integrate Baz with GitLab repositories to mirror your codebase and enable Baz’s review capabilities. After signing in to Baz (via GitHub or GitLab), navigate to your workspace and select Connect to GitLab. This will prompt you to provide GitLab access credentials and choose which projects to integrate with Baz.

Note: If an administrator has already configured a GitLab integration for your organization, you can simply select that organization from Baz’s menu without re-entering credentials.

Provide a GitLab Personal Access Token

When connecting Baz to GitLab, you’ll be asked to enter a GitLab Personal Access Token (PAT). This token allows Baz to call the GitLab API on your behalf.

To generate a PAT, go to your GitLab account’s Settings > Access Tokens. Create a new token with an appropriate name and include the api scope so Baz can read repository data and perform repository operations.

Once you have the PAT, enter it in Baz’s Connect to GitLab dialog. Baz will securely store the token and verify it. By default, Baz connects to gitlab.com. After submitting the token, you’ll see a confirmation message indicating that Baz is connected.

Select GitLab Projects to Integrate

After connecting with your PAT, Baz will retrieve the list of GitLab projects that your token’s user has access to. You’ll see this list in Baz’s interface, where you can choose which repositories to integrate.

Each project is listed by its namespace/name. Select the ones you want Baz to manage. Once confirmed, Baz will sync the chosen repositories into your Baz workspace. This includes cloning the repositories, indexing their code, and synchronizing GitLab groups and members associated with those projects.

From here, your Baz workspace mirrors your GitLab projects. In the Code section, you’ll see repositories and their content. In the Changes section, Baz displays open merge requests from those projects, ready for review.

Performing Reviews (Comments & Merges)

Once integrated, Baz can help review code changes from your GitLab projects. Comments or merge actions performed in Baz will appear directly on GitLab merge requests, authored by the account tied to the PAT.

This means any review action taken in Baz—such as adding a comment or merging a change—will use the permissions and identity of the PAT’s owner. Make sure the token belongs to a user with the right level of access (such as Maintainer or Developer) for the repositories you integrate.

Update the GitLab Integration

You can reconfigure the GitLab integration at any time from Settings > Integrations.

• Add/Remove Projects: Open the project list again and adjust which repositories are synced. Baz will add any newly selected repositories or stop syncing deselected ones.

• Update Credentials: If your PAT expires or you need to switch accounts, input a new token. Baz will securely update the stored credentials.

Once saved, Baz will immediately apply changes, syncing new repositories or updating access as needed.