# Feature OP-15882 - Extend the functionalities of the GitHub/GitLab integrations for two-way communication

Project: OpenProject
Status: new
URL: https://community.openproject.org/work_packages/OP-15882

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | Wish List |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers |  |
| Designer | Parimal Satyal |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** a project member using both OpenProject and GitHub/GitLab  
**I want** changes I make to a linked pull request to automatically reflect in OpenProject  
**so that** my workflow is more efficient and I don't have to spend time doing it manually

#### **Note**

The following is written for GitHub but also applies to GitLab.

OpenProject already has existing integrations with GitHub and GitLab. This makes it possible to link work packages with Pull Requests (PRs) and automatically display updates as status changes (opened, closed, merged) and the result of GitHub actions (in progress, sucess, failed) directly in OpenProject, via the *GitHub* tab of a work package view. Major updates are even visible directly in the Activity tab.

Additionally, there is already in-built support for Git snippets to make it easier to create branches based on an existing work package, or to link with an existing branch or PR.

However, this flow of information is currently one-way. The integration is not able to:

  - automatically create branches through OpenProject (it has to be manually linked)

  - update the status of a work package based on the status of a PR

#### **Acceptance criteria**

Extend the functionality of the GitHub/GitLab integrations so that:

  - New branches linked to work packages can be created directly via OpenProject
    
      - Manually with a button click ("Create branch") or
    
      - Automatically via a custom action (for example, when a new package of type 'Feature' is created in a certain project and the status is set to *In development*)

  - The status of linked PRs can automatically update the status of work packages
    
      - For example, when a PR is merged, the status of the linked work package is set to "Merged"
