glab-mr

Create a merge request

$ glab mr create

$ glab mr checkout [mr_number]

$ glab mr diff

$ glab mr approve

$ glab mr merge

$ glab mr update

$ glab mr update --target-branch [branch_name]

glab mr [<command>] [<flags>]

--help
    Show help for command

--verbose
    Enable verbose logging output

-R, --repo OWNER/REPO
    Select repository (default current if in git repo)

--paginate
    Enable pagination (auto-disabled if output to pipe/redirect)

--limit FROM..TO
    Limit results returned (default 100)

glab mr is the merge request subcommand of the official GitLab CLI tool glab, enabling seamless management of merge requests (MRs) directly from the terminal. It mirrors familiar git workflows, allowing users to create, list, approve, merge, comment, rebase, and perform other actions on MRs without switching to the web UI.

Key capabilities include filtering MRs by state (opened, closed, merged), assignee, author, or labels; creating MRs from branches with custom titles and descriptions; approving or unapproving in bulk; adding notes; viewing diffs; and integrating with pipelines. Supports interactive mode for prompts and works across projects via repository flags.

Designed for developers and CI/CD automation, it leverages GitLab API for real-time operations. Authentication via personal access token is required, set with glab auth login. Enhances productivity in terminal-centric environments, especially monorepos or remote teams.

Requires GitLab authentication (glab auth login). Subcommand-specific flags apply (e.g., --title for create). Not all features available on all GitLab versions; check compatibility.

create: Create new MR
list: List MRs (e.g., glab mr list --state opened)
approve: Approve MR(s)
merge: Merge MR(s)
view: View MR details
Full list: glab mr --help

glab mr create --title 'Fix bug' --description 'Details'
glab mr list --author=@me --state=opened
glab mr approve <MR-ID>

Part of glab, first released by GitLab in November 2021 (v1.0.0). MR subcommands evolved from community feedback, with major enhancements in v1.14+ for squash/merge and reviewers. Actively maintained as open-source (Apache-2.0).

glab(1), git(1), gh pr(1)