1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
---
stage: Create
group: Code Review
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
---
<!--
This documentation is auto generated by a script.
Please do not edit this file directly. Run `make gen-docs` instead.
-->
# `glab mr list`
List merge requests.
```plaintext
glab mr list [flags]
```
## Aliases
```plaintext
ls
```
## Examples
```plaintext
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.
--author string Filter merge request by author <username>.
-c, --closed Get only closed merge requests.
-d, --draft Filter by draft merge requests.
-g, --group string Select a group/subgroup. This option is ignored if a repo argument is set.
-l, --label strings Filter merge request by label <name>.
-M, --merged Get only merged merge requests.
-m, --milestone string Filter merge request by milestone <id>.
--not-draft Filter by non-draft merge requests.
--not-label strings Filter merge requests by not having label <name>.
-o, --order string Order merge requests by <field>. Order options: created_at, title, merged_at or updated_at.
-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 OWNER/REPO Select another repository. Can use either OWNER/REPO or `GROUP/NAMESPACE/REPO` format. Also accepts full URL or Git URL.
-r, --reviewer strings Get only merge requests with users as reviewer.
--search string Filter by <string> in title and description.
-S, --sort string Sort merge requests by <field>. Sort options: asc, 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
--help Show help for this command.
```
|
