glab(1)

🦋 glab-mr-checkout 🦋

hey bestie, welcome to the glab(1) page for glab-mr-checkout. this is the command that checks out an open merge request, and yes it’s giving main character energy. let’s get into it 💅

---

✨ NAME ✨

glab-mr-checkout — check out an open merge request. periodt.

🌸 SYNOPSIS 🌸

glab mr checkout [ |  | ] [flags]

💖 DESCRIPTION 💖

okay so defaults to the currently checked-out branch. use --branch to override the local branch name used for the checkout. slay.

use --worktree to check out the merge request into a Git worktree at the given path. your current working directory and any work in progress stay untouched — no chaos, no lost edits. if you run the command again with the same path, it updates the existing worktree.

you can only check out a branch in one worktree at a time. if a branch is already checked out elsewhere, use --branch to check it out under a different name. important bestie.

to remove the worktree when you’re done, run git worktree remove <path>.

🎀 OPTIONS 🎀

• -b, --branch="" — checks out the merge request with name (the name you pass in). 💖
• -f, --force[=false] — resets the local branch to remote when they have diverged. ⚠️ it refuses if the working tree has changes that would be lost.
• -u, --set-upstream-to="" — sets tracking of the checked-out branch to [REMOTE/]BRANCH.
• --worktree="" — checks out the merge request into a Git worktree at (the path you pass in) instead of the current working directory. re-running updates an existing worktree at that path.

🔥 OPTIONS INHERITED FROM PARENT COMMANDS 🔥

• -h, --help[=false] — shows help for this command.
• -R, --repo="" — selects another repository. you can use either OWNER/REPO or GROUP/NAMESPACE/REPO. the full URL or Git URL is also accepted.

👑 EXAMPLE 👑

glab mr checkout 1
glab mr checkout branch
glab mr checkout 12 --branch todo-fix
glab mr checkout new-feature --set-upstream-to=upstream/main
glab mr checkout https://gitlab.com/gitlab-org/cli/-/merge_requests/1234

# Check out into a separate worktree
glab mr checkout 123 --worktree ../review-mr-123

# Uses the checked-out branch
glab mr checkout

🌈 SEE ALSO 🌈

go see glab-mr(1) 👀

---

Auto generated by spf13/cobra · Nov 2026 · glab(1) — bye bestie, go slay those MRs 💅✨