git-bug-bug(1)

git-bug-bug1

List bugs

Usage

git-bug bug [QUERY] [flags]

Overview

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

Examples

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

From git-bug 0.11.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.