Skip to content

feat(tools/gitlab): add tracker + forge bridge for GitLab-hosted projects #305

Closed

Description

@potiuk

Add tools/gitlab/ as a forge + tracker bridge analogous to tools/github/. GitLab is the dominant non-GitHub forge in our adopter universe.

Capabilities to provide (mirror the GitHub bridge):

  • Issue read/write: issue view/list, issue create/edit/close, issue comment
  • MR read/write: mr view/list, mr create/edit/merge, mr comment, mr review
  • Project metadata: labels, milestones, members
  • Project boards (boards / iterations) read/write
  • CI: pipelines read for status checks
  • Security advisories: GitLab has its own advisory database — useful for the security-* skill family

Why: GitLab hosts Python core infra and several PEP-related repos (gitlab.com/python-org), GNOME (gitlab.gnome.org — all of GNOME), Debian Salsa (salsa.debian.org — all of Debian packaging), KDE (invent.kde.org), Freedesktop (gitlab.freedesktop.org — Mesa, X.org, Wayland, NetworkManager, PipeWire), Inkscape, GIMP, Xfce, Buildroot, the Linux Foundation Energy projects, and the entire self-hosted-enterprise forge market. A project-agnostic framework that can't speak GitLab forecloses a substantial slice of OSS.

Reference:

  • GitLab REST API: https://docs.gitlab.com/api/api_resources/
  • Existing GitHub bridge to mirror: tools/github/ — the issue-body field-schema pattern in issue-template.md is the convention to follow for GitLab issue templates
  • The python-gitlab library is a clean reference impl
  • For project-board parity, GitLab's "Boards" + "Iterations" are the analogue of GitHub Projects

Activity

  1. added
    enhancementNew feature or request
    capability:platformFramework / agent substrate skills (install, verify, doctor, override, status, setup bootstrap)
    on May 26, 2026
  2. Kaap10 commented on Sep 24, 2026

    @Kaap10
    Contributor

    I was going through the multi-forge extension points cited in #614 (docs/vendor-neutrality.md) and saw that GitLab parity is a key unlock for communities across GNOME, Debian Salsa, and KDE.

    I'm picking this up to implement the tools/gitlab/ forge and tracker bridge, starting with the initial skeleton and read-only foundation!

  3. added 8 commits that reference this issue on Sep 24, 2026
    925f87b
    96813dd
    64a9a27
    e01eadd
    3c2c612
    b35c5f4
    73e88db
    962934d
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    capability:platformFramework / agent substrate skills (install, verify, doctor, override, status, setup bootstrap)enhancementNew feature or requestfamily:toolstools/*good first issueGood for newcomerssource control systemVersion control systems and the forges/services that host them

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions