## git-bug ls
List bugs.
### Synopsis
Display a summary of each bugs.
You 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.
```
git-bug ls [QUERY] [flags]
```
### Examples
```
List open bugs sorted by last edition with a query:
git bug ls status:open sort:edit-desc
List closed bugs sorted by creation with flags:
git bug ls --status closed --by creation
Do a full text search of all bugs:
git bug ls "foo bar" baz
Use queries, flags, and full text search:
git bug ls status:open --by creation "foo bar" baz
```
### Options
```
-s, --status strings Filter by status. Valid values are [open,closed]
-a, --author strings Filter by author
-m, --metadata strings Filter by metadata. Example: github-url=URL
-p, --participant strings Filter by participant
-A, --actor strings Filter by actor
-l, --label strings Filter by label
-t, --title strings Filter by title
-n, --no strings Filter by absence of something. Valid values are [label]
-b, --by string Sort the results by a characteristic. Valid values are [id,creation,edit] (default "creation")
-d, --direction string Select the sorting direction. Valid values are [asc,desc] (default "asc")
-f, --format string Select the output formatting style. Valid values are [default,plain,compact,id,json,org-mode] (default "default")
-h, --help help for ls
```
### SEE ALSO
* [git-bug](git-bug.md) - A bug tracker embedded in Git.
