# Epic GIT-43 - GitLab bidirectional integration

Project: Stream Repositories
Status: in specification
URL: https://community.openproject.org/work_packages/GIT-43

## Detailed specification

### Motivation and background information

*   The GitLab tab shows commits, branches, merge requests and issues of a work package. Data only flows from GitLab into OpenProject.
    
*   This means starting the development of a work package and keeping linked GitLab items up to date still happens in GitLab.
    
*   Also any GitLab repository can be linked to any project. Admins cannot define which repositories belong to which project.

### Acceptance criteria

*   Users can connect their own GitLab account via OAuth. All write actions from OpenProject run as that user.
    
*   Admins can activate GitLab repositories for selected projects.
    
*   Users can create a branch from the GitLab tab of a work package. The name comes from the default branch pattern and can be edited.
    
*   Users close and reopen linked GitLab issues and merge requests from the GitLab tab. Every change is a manual action.

### Out of scope

*   Comment and issue sync. The data differs between OpenProject and GitLab, and we keep a single source of truth.
    
*   Automatic GitLab status changes triggered by OpenProject status changes, to avoid closing issues or merge requests by accident.
    
*   Merging merge requests or toggling their draft status from OpenProject.

| Attribute | Value |
| --- | --- |
| Mockups | https://www.figma.com/design/MUkwDhlspEfdBBbockeMxt/Repositories-Integration?node-id=2342-20767&t=ZGWUIgohQzTwPfS8-0 |

## Planning

| Attribute | Value |
| --- | --- |
| Roadmap | 2027 Q1 |
| Date |  |
| Votes |  |
| List |  |
| Target versions |  |
| Sprint |  |
| Backlog bucket |  |
| Relevance |  |

## Subitems

| ID | Type | Subject | Status | Assignee | Target versions | Project | Priority | Spent time |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| GIT-44 | Feature | GitLab OAuth connection | in specification |  |  | Stream Repositories | Medium |  |
| GIT-45 | Feature | Enable GitLab repositories per project | in specification |  |  | Stream Repositories | Medium |  |
| GIT-46 | Feature | Create GitLab branches from a work package | in specification |  |  | Stream Repositories | Medium |  |
| GIT-47 | Feature | Close and reopen GitLab issues and merge requests from a work package | in specification |  |  | Stream Repositories | Medium |  |
| GIT-48 | Open Point | Show GitLab data from repositories not activated for the project? | new |  |  | Stream Repositories | Medium |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Module |
| --- | --- | --- | --- | --- | --- | --- |
| GIT-48 | Open Point | Show GitLab data from repositories not activated for the project? | new |  |  |  |

## Details

| Attribute | Value |
| --- | --- |
| Module | Integrations / GitLab |
| Enterprise plan | Community (COM) |
| Labels |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager | Nova Bonic |
| Feature Lead |  |
| Designer | Marc Alcobé |
| Developers | OP Dev Titan Team |
| Requested by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |

## Description

The GitLab integration now works both ways.

Until now, OpenProject showed you what happened in GitLab. Now you can also act on it. Create a branch right from the work package, and it’s linked automatically. Close or reopen linked issues and merge requests without leaving OpenProject. Every action runs with your own GitLab account, so GitLab keeps showing who did what.
