1## git-bug bug
2
3List bugs
4
5### Synopsis
6
7Display a summary of each bugs.
8
9You can pass an additional query to filter and order the list. This query can be expressed either with a simple query language, flags, a natural language full text search, or a combination of the aforementioned.
10
11```
12git-bug bug [QUERY] [flags]
13```
14
15### Examples
16
17```
18List open bugs sorted by last edition with a query:
19git bug status:open sort:edit-desc
20
21List closed bugs sorted by creation with flags:
22git bug --status closed --by creation
23
24Do a full text search of all bugs:
25git bug "foo bar" baz
26
27Use queries, flags, and full text search:
28git bug status:open --by creation "foo bar" baz
29
30```
31
32### Options
33
34```
35 -s, --status strings Filter by status. Valid values are [open,closed]
36 -a, --author strings Filter by author
37 -m, --metadata strings Filter by metadata. Example: github-url=URL
38 -p, --participant strings Filter by participant
39 -A, --actor strings Filter by actor
40 -l, --label strings Filter by label
41 -t, --title strings Filter by title
42 -n, --no strings Filter by absence of something. Valid values are [label]
43 -b, --by string Sort the results by a characteristic. Valid values are [id,creation,edit] (default "creation")
44 -d, --direction string Select the sorting direction. Valid values are [asc,desc] (default "asc")
45 -f, --format string Select the output formatting style. Valid values are [default,plain,id,json,org-mode]
46 -h, --help help for bug
47```
48
49### SEE ALSO
50
51* [git-bug](git-bug.md) - A bug tracker embedded in Git
52* [git-bug bug comment](git-bug_bug_comment.md) - List a bug's comments
53* [git-bug bug deselect](git-bug_bug_deselect.md) - Clear the implicitly selected bug
54* [git-bug bug label](git-bug_bug_label.md) - Display labels of a bug
55* [git-bug bug new](git-bug_bug_new.md) - Create a new bug
56* [git-bug bug rm](git-bug_bug_rm.md) - Remove an existing bug
57* [git-bug bug select](git-bug_bug_select.md) - Select a bug for implicit use in future commands
58* [git-bug bug show](git-bug_bug_show.md) - Display the details of a bug
59* [git-bug bug status](git-bug_bug_status.md) - Display the status of a bug
60* [git-bug bug title](git-bug_bug_title.md) - Display the title of a bug
61