GitLab

Read and write files, branches, issues and merge requests in a single GitLab project. It’s listed under the code repositories category in the toolkit type picker.

Prerequisites

• An account at GitLab with permission to issue an API token or credential, saved in Elitea as a gitlab credential (/credentials/create-credential/<type>).
• If you plan to index content for retrieval: an embedding model, configured under AI providers.

Connect the toolkit

1. Open the toolkit type picker

   In the left navigation, open Toolkits, then select New. Filter the type picker by the code repositories category, or search for “GitLab”.

2. Pick or create a credential

   Under the credential field, choose an existing gitlab credential, or select Create credential to add one without leaving the form.

3. Add indexing settings (optional)

   If you plan to index this source, set an embedding model. Indexes are kept in the platform’s vector store, so there is no vector-storage setting to pick. Leave it empty to use the toolkit without indexing.

4. Save

   Name the toolkit and select Create. It’s now available to attach to agents, pipelines and conversations in this project.

Available tools

Available tools (27)

The category of a tool decides when a run needs human approval to call it. See Runtime safety.

Tool	Category
Append file	write
Comment on issue	external_send
Comment on pr	external_send
Create branch	write
Create file	write
Create pr change comment	external_send
Create pull request	write
Delete branch	delete
Delete file	delete
Get commits	read
Get issue	read
Get issues	read
Get pr changes	read
Grep file	read
Index data	write
List branches in repo	read
List files	read
List folders	read
List indexes	read
Read file	read
Read multiple files	read
Remove index	delete
Search index	read
Set active branch	write
Stepback search index	read
Stepback summary index	read
Update file	write

Common issues

Note

The Indexes tab only appears when the configured worker can run this type’s index_data tool; if the worker can’t, the tab is hidden and shows the worker’s refusal message. index_data itself can’t be run from the Test tools pane — use the Indexes tab.

Note

There’s no connection check on this form. Save the toolkit, then run one read-only tool from the editor’s Test tools pane to confirm the credential works before attaching GitLab to an agent.