GitLab

GitLab Integration

Connect your GitLab account to CtxSync so you can add repositories as project sources. Once connected, your AI assistant can read and understand your entire codebase.

Connecting your account

1. Go to Integrations in the sidebar.
2. Click Connect next to GitLab.
3. You’ll be redirected to GitLab to authorize CtxSync.
4. Review the permissions and click Authorize.

Once authorized, you can add GitLab repositories as sources in any of your projects.

Permissions

CtxSync requests the read_repository scope — read-only access to your repositories. It never pushes changes or modifies your code.

Your authorization token is automatically refreshed in the background, so you won’t need to reconnect periodically.

Using repositories as sources

After connecting GitLab:

1. Open a project and click Add Source.
2. Select GitLab as the source type.
3. Pick a repository from the list.

The full repository (default branch) is cloned into your project’s isolated container. To pull the latest changes, sync the source again.

Troubleshooting

Repository not showing up?

• Make sure you have at least read access (Reporter role or above) to the repository.
• The repository must not be empty.
• If the repository belongs to a group, ensure the group allows third-party app access.