Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jitera.ai/llms.txt

Use this file to discover all available pages before exploring further.

Connecting a self-managed GitLab repository to your project allows AI agents to read your source code and provide code-based answers and documentation.
GitLab 16.8 or later is required. If you are using an older version, use the Jitera CLI instead.

​
Prerequisites

Before connecting GitLab, prepare the following in your GitLab instance.

​
1. Find your GitLab host name

  1. Sign in to your GitLab instance
  2. Click your avatar in the top-right corner and go to Settings
  3. Click Account — the URL path shown there is your GitLab host name

​
2. Generate a personal access token

An API access token is required the first time you connect GitLab. The token must belong to an account with Admin privileges and must have the api scope.
If you cannot use a token with Admin privileges, the connection cannot be completed.
  1. In GitLab, go to your avatar → Settings → Access Tokens
  2. Click Add new token
  3. Enter a token name and select the api scope
  4. Click Create personal access token and copy the generated token

​
Connection Steps

  1. Open Code sources in project settings
  2. Click Connect next to Self-managed GitLab
    Only one provider can be connected per project. To switch providers, disconnect all connected repositories first.
  3. Enter your GitLab host name and API access token, then click Connect
  4. In the authorization dialog, click Authorize
  5. In the repository selection dialog, choose the repositories to connect (up to 2)
  6. Set the Type and Branch for each repository, then click Connect

​
Repository Types

TypeDescription
FrontendClient-side application code
BackendServer-side application code
MonorepoFull-stack application in a single repository
When Monorepo is selected, only one repository can be connected to the project. For Frontend + Backend, you can connect one of each, up to two total.
After connecting a GitLab repository, do not manually change the default branch. Doing so will prevent syncing from working correctly.

​
Resync

To update connected repository code to the latest state, run a resync from the code sources page. Resync consumes credits.

​
Disconnect

Disconnecting a repository removes the agent’s access to that repository’s code. You can reconnect after disconnecting.