GitLabgitlab-org

cli

main
ply7 git calls210 ms99 KiB5 cachedprotocol v2
84 lines3.7 KiBRaw

List merge requests.

Synopsis

Defaults to open merge requests. Use --all to include closed and merged requests. Use --group to list for a group instead of the current project.

plaintext
glab mr list [flags]

Aliases

plaintext
ls

Examples

console
glab mr list --all
glab mr ls -a
glab mr list --assignee=@me
glab mr list --reviewer=@me
glab mr list --source-branch=new-feature
glab mr list --target-branch=main
glab mr list --search "this adds feature X"
glab mr list --label needs-review
glab mr list --not-label waiting-maintainer-feedback,subsystem-x
glab mr list -M --per-page 10
glab mr list --draft
glab mr list --not-draft

Options

plaintext
  -A, --all                    Get all merge requests.
  -a, --assignee strings       Get only merge requests assigned to users. Multiple users can be comma-separated or specified by repeating the flag.
      --author string          Filter merge request by author <username>.
  -c, --closed                 Get only closed merge requests.
      --created-after time     Filter merge requests created after a certain date (ISO 8601 format).
      --created-before time    Filter merge requests created before a certain date (ISO 8601 format).
      --deployed-after time    Filter merge requests deployed after a certain date (ISO 8601 format).
      --deployed-before time   Filter merge requests deployed before a certain date (ISO 8601 format).
  -d, --draft                  Filter by draft merge requests.
      --environment string     Filter merge requests deployed to the given environment <name>.
  -g, --group string           Select a group/subgroup. This option is ignored if a repo argument is set.
      --jq string              Filter JSON output with a jq expression.
  -l, --label strings          Filter merge request by label <name>. Multiple labels can be comma-separated or specified by repeating the flag.
  -M, --merged                 Get only merged merge requests.
  -m, --milestone string       Filter merge request by milestone <title>.
      --not-draft              Filter by non-draft merge requests.
      --not-label strings      Filter merge requests by not having label <name>. Multiple labels can be comma-separated or specified by repeating the flag.
  -o, --order string           Order merge requests by <field>. Order options: created_at, updated_at, merged_at, title, priority, label_priority, milestone_due, and popularity.
  -F, --output string          Format output as: text, json. (default "text")
  -p, --page int               Page number. (default 1)
  -P, --per-page int           Number of items to list per page. (default 30)
  -R, --repo string            Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
  -r, --reviewer strings       Get only merge requests with users as reviewer. Multiple users can be comma-separated or specified by repeating the flag.
      --search string          Filter by <string> in title and description.
  -S, --sort string            Sort direction for --order field: asc or desc.
  -s, --source-branch string   Filter by source branch <name>.
  -t, --target-branch string   Filter by target branch <name>.

Options inherited from parent commands

plaintext
  -h, --help   Show help for this command.
1---
2title: '`glab mr list`'
3stage: AI Clients
4group: Developer Clients
5info: To determine the technical writer assigned to the Stage/Group associated with this page, see <https://handbook.gitlab.com/handbook/marketing/product-and-technical-marketing/technical-writing/#assignments>
6---
8<!--
9This documentation is auto generated by a script.
10Please do not edit this file directly. Run `make gen-docs` instead.
11-->
13List merge requests.
15## Synopsis
17Defaults to open merge requests. Use `--all` to include closed
18and merged requests. Use `--group` to list for a group instead
19of the current project.
21```plaintext
22glab mr list [flags]
23```
25## Aliases
27```plaintext
28ls
29```
31## Examples
33```console
34glab mr list --all
35glab mr ls -a
36glab mr list --assignee=@me
37glab mr list --reviewer=@me
38glab mr list --source-branch=new-feature
39glab mr list --target-branch=main
40glab mr list --search "this adds feature X"
41glab mr list --label needs-review
42glab mr list --not-label waiting-maintainer-feedback,subsystem-x
43glab mr list -M --per-page 10
44glab mr list --draft
45glab mr list --not-draft
46```
48## Options
50```plaintext
51 -A, --all Get all merge requests.
52 -a, --assignee strings Get only merge requests assigned to users. Multiple users can be comma-separated or specified by repeating the flag.
53 --author string Filter merge request by author <username>.
54 -c, --closed Get only closed merge requests.
55 --created-after time Filter merge requests created after a certain date (ISO 8601 format).
56 --created-before time Filter merge requests created before a certain date (ISO 8601 format).
57 --deployed-after time Filter merge requests deployed after a certain date (ISO 8601 format).
58 --deployed-before time Filter merge requests deployed before a certain date (ISO 8601 format).
59 -d, --draft Filter by draft merge requests.
60 --environment string Filter merge requests deployed to the given environment <name>.
61 -g, --group string Select a group/subgroup. This option is ignored if a repo argument is set.
62 --jq string Filter JSON output with a jq expression.
63 -l, --label strings Filter merge request by label <name>. Multiple labels can be comma-separated or specified by repeating the flag.
64 -M, --merged Get only merged merge requests.
65 -m, --milestone string Filter merge request by milestone <title>.
66 --not-draft Filter by non-draft merge requests.
67 --not-label strings Filter merge requests by not having label <name>. Multiple labels can be comma-separated or specified by repeating the flag.
68 -o, --order string Order merge requests by <field>. Order options: created_at, updated_at, merged_at, title, priority, label_priority, milestone_due, and popularity.
69 -F, --output string Format output as: text, json. (default "text")
70 -p, --page int Page number. (default 1)
71 -P, --per-page int Number of items to list per page. (default 30)
72 -R, --repo string Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
73 -r, --reviewer strings Get only merge requests with users as reviewer. Multiple users can be comma-separated or specified by repeating the flag.
74 --search string Filter by <string> in title and description.
75 -S, --sort string Sort direction for --order field: asc or desc.
76 -s, --source-branch string Filter by source branch <name>.
77 -t, --target-branch string Filter by target branch <name>.
78```
80## Options inherited from parent commands
82```plaintext
83 -h, --help Show help for this command.
84```
Diagnostics7 git calls · 210 ms
CallStatusSizeTime0210 ms
discover200185 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=185
git.server.agent=git/2.56.g1891de4-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=185
git.pkt.payload.max=35
ls-refs20058 KiB · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=59849
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=731
git.pkt.data=730
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=59849
git.pkt.payload.max=143
git.ls_refs.count=730
git.ls_refs.head=refs/heads/main
fetchtree:0 · deepen 1020032 KiB · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=4
git.response.bytes=32926
git.response.cache=HIT
git.response.duration_ms=4
git.fetch.filter=tree:0
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=22
git.pkt.data=20
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=32926
git.pkt.payload.max=32046
git.sideband.band1.bytes=32046
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=80
git.pack.bytes=32046
git.pack.ofs_delta=36
git.pack.ref_delta=0
git.pack.chain.max=2
git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91
git.pack.full=44
Open pack map
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=4
git.response.bytes=4273
git.response.cache=HIT
git.response.duration_ms=4
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4273
git.pkt.payload.max=4173
git.sideband.band1.bytes=4173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=11
git.pack.bytes=4173
git.fetch.wide.objects=11
git.fetch.wide.extra_bytes=3930
git.fetch.wide.blobs=0
fetchtree:02001.7 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=1744
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=5e4007a5673eb3bf5d0d7f1a1463c3b2ca3fb3bd
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1744
git.pkt.payload.max=1717
git.sideband.band1.bytes=1717
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1717
git.pack.trailer=3f1b9ccc7756e8941d6705e8187c87fd922113e6
Open pack map
fetchtree:0200669 B · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=669
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=e7f366ff56d25d838386e3ceead4278af75f7180
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=669
git.pkt.payload.max=642
git.sideband.band1.bytes=642
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=642
git.pack.trailer=8973f4a733afcd554e109d2cd1877fb7b7210224
Open pack map
fetch2001.4 KiB199 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=199
git.response.bytes=1405
git.response.cache=MISS
git.response.duration_ms=199
git.fetch.wants=83f1fc88114538ced529c619d9a81052fc5ef2ce
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1405
git.pkt.payload.max=1378
git.sideband.band1.bytes=1378
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://gitlab.com/gitlab-org/cli
Ref
refs/heads/main
Commit
0dd7574dce9e385c5c30540e6c15657adc6bdce9
cf-ray
a5e199dd5dcdb86e
Request
3f035d90…
Protocol
v2 · sha1
Agent
git/2.56.g1891de4-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format