glab-mr-create

Interactively create a merge request

$ glab mr create

$ glab mr create [[-f|--fill]]

$ glab mr create --draft

$ glab mr create [[-b|--target-branch]] [target_branch] [[-t|--title]] "[title]" [[-d|--description]] "[description]"

$ glab mr create [[-w|--web]]

glab mr create [<source-branch>] [options...]

-a, --assignee <usernames>
    Comma-separated list of usernames to assign the MR to

-l, --label <labels>
    Comma-separated list of labels to apply to the MR

-t, --title <string>
    Title of the merge request

-d, --description <string>
    Description message for the MR (use - for stdin)

-m, --message <file>
    File containing the MR message

--draft
    Mark the MR as a draft

--milestone <id|#title>
    Milestone ID or title to associate

--remove-source-branch
    Remove source branch after successful merge (default true)

--target <branch>
    Target branch for the MR

--reviewer <usernames>
    Comma-separated list of reviewers

-R, --repo <owner/repo>
    Repository to target (defaults to current)

-s, --source-branch <branch>
    Source branch (defaults to current branch)

The glab mr create command is part of the glab tool, an open-source GitLab CLI client designed to bring GitLab functionality to the terminal. It enables users to create new merge requests (MRs) directly from the command line without needing a web browser.

By default, it uses the current Git branch as the source branch and the repository's default base branch (often main or master) as the target. Users can specify custom source/target branches, titles, descriptions, labels, assignees, reviewers, and more via flags. After creation, it supports options like auto-approving, marking as draft, or removing the source branch post-merge.

This streamlines workflows for developers, especially in CI/CD pipelines or when working in environments without GUI access. It requires prior authentication via glab auth login and a Git repository configured with a GitLab remote. The command pushes the source branch if needed (configurable) and opens the MR in the browser by default.

Requires glab auth login and GitLab remote; source branch must be pushed if not remote; maintainer perms needed for --approve.

glab mr create --title "Fix bug" --label bugfix
glab mr create feature-branch --target develop --description "@file.md"