---
name: "git-bug-bug"
section: "1"
platform: "linux"
package: "git-bug"
version: "0.11.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-bug-bug"
---

# git-bug-bug(1)

List bugs

## NAME

git-bug-bug - List bugs

## SYNOPSIS

**git-bug bug \[QUERY\] \[flags\]**

## DESCRIPTION

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.

## OPTIONS

**-s**, **--status**=\[\]\
 	Filter by status. Valid values are \[open,closed\]

**-a**, **--author**=\[\]\
 	Filter by author

**-m**, **--metadata**=\[\]\
 	Filter by metadata. Example: github-url=URL

**-p**, **--participant**=\[\]\
 	Filter by participant

**-A**, **--actor**=\[\]\
 	Filter by actor

**-l**, **--label**=\[\]\
 	Filter by label

**-t**, **--title**=\[\]\
 	Filter by title

**-n**, **--no**=\[\]\
 	Filter by absence of something. Valid values are \[label\]

**-b**, **--by**="creation"\
 	Sort the results by a characteristic. Valid values are \[id,creation,edit\]

**-d**, **--direction**="asc"\
 	Select the sorting direction. Valid values are \[asc,desc\]

**-f**, **--format**="default"\
 	Select the output formatting style. Valid values are \[default,plain,id,json,org-mode\]

**-h**, **--help**\[=false\]\
 	help for bug

## EXAMPLE

```
List open bugs sorted by last edition with a query:
git bug status:open sort:edit-desc
List closed bugs sorted by creation with flags:
git bug --status closed --by creation
Do a full text search of all bugs:
git bug "foo bar" baz
Use queries, flags, and full text search:
git bug status:open --by creation "foo bar" baz
```

## SEE ALSO

**[git-bug(1)](/git-bug/1.md)**, **[git-bug-bug-comment(1)](/git-bug-bug-comment/1.md)**, **[git-bug-bug-deselect(1)](/git-bug-bug-deselect/1.md)**, **[git-bug-bug-label(1)](/git-bug-bug-label/1.md)**, **[git-bug-bug-new(1)](/git-bug-bug-new/1.md)**, **[git-bug-bug-rm(1)](/git-bug-bug-rm/1.md)**, **[git-bug-bug-select(1)](/git-bug-bug-select/1.md)**, **[git-bug-bug-show(1)](/git-bug-bug-show/1.md)**, **[git-bug-bug-status(1)](/git-bug-bug-status/1.md)**, **[git-bug-bug-title(1)](/git-bug-bug-title/1.md)**