mirror of
https://github.com/All-Hands-AI/OpenHands.git
synced 2026-04-29 03:00:45 -04:00
32 lines
1.4 KiB
Plaintext
32 lines
1.4 KiB
Plaintext
---
|
|
title: GitLab Integration
|
|
description: This guide walks you through the process of installing OpenHands Cloud for your GitLab repositories. Once
|
|
set up, it will allow OpenHands to work with your GitLab repository.
|
|
---
|
|
|
|
## Prerequisites
|
|
|
|
- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a GitLab account](/usage/cloud/openhands-cloud).
|
|
|
|
## Adding GitLab Repository Access
|
|
|
|
Upon signing into OpenHands Cloud with a GitLab account, OpenHands will have access to your repositories.
|
|
|
|
## Working With GitLab Repos in Openhands Cloud
|
|
|
|
After signing in with a Gitlab account, use the `select a repo` and `select a branch` dropdowns to select the
|
|
appropriate repository and branch you'd like OpenHands to work on. Then click on `Launch` to start the conversation!
|
|
|
|
|
|
|
|
## Using Tokens with Reduced Scopes
|
|
|
|
OpenHands requests an API-scoped token during OAuth authentication. By default, this token is provided to the agent.
|
|
To restrict the agent's permissions, you can define a custom secret `GITLAB_TOKEN`, which will override the default token assigned to the agent.
|
|
While the high-permission API token is still requested and used for other components of the application (e.g. opening merge requests), the agent will not have access to it.
|
|
|
|
## Next Steps
|
|
|
|
- [Learn about the Cloud UI](/usage/cloud/cloud-ui).
|
|
- [Use the Cloud API](/usage/cloud/cloud-api) to programmatically interact with OpenHands.
|