GIT-BUG(1)

💅 GIT-BUG(1) — like, the git-bug-bug page, bestie 🐛✨

okay so real quick — this is a page from the git-bug manual, and it's literally all about the git-bug-bug command. yes the name is a lil silly. no we're not changing it. let's go 🫶

---

✨ NAME ✨

git-bug-bug — list bugs 📋 (that's it. that's the whole vibe.)

---

🦋 SYNOPSIS 🦋

git-bug bug [QUERY] [flags]

---

🌸 DESCRIPTION 🌸

So basically it shows you a summary of each bug. every single one. cute lil overview energy 💖

And here's the fun part: you can slide in an extra query to filter and order the list. and that query can be expressed in any of these ways — or honestly a combo of all of them, she's flexible like that:

• with a simple query language 🔤
• with flags 🚩
• with a natural language full text search 🔍
• or any combination of the aforementioned 💫

---

🎀 OPTIONS 🎀

• -s, --status=[] — filter by status. valid values are [open,closed] — pick a side bestie 👀
• -a, --author=[] — filter by author ✍️
• -m, --metadata=[] — filter by metadata. e.g. 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 (iconic, honestly). valid values are [label] 🚫
• -b, --by="creation" — sort the results by a characteristic. valid values are [id,creation,edit] 📊 (default is creation, in case you were wondering)
• -d, --direction="asc" — pick the sorting direction. valid values are [asc,desc] ⬆️⬇️ (default asc)
• -f, --format="default" — pick the output formatting style. valid values are [default,plain,id,json,org-mode] 🎨 (default default, yes really)
• -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 — all at once, because why not:

git bug status:open --by creation "foo bar" baz

---

👑 SEE ALSO 👑

go read these too, they're all part of the fam 🫶

git-bug(1), git-bug-bug-comment(1), git-bug-bug-deselect(1), git-bug-bug-label(1), git-bug-bug-new(1), git-bug-bug-rm(1), git-bug-bug-select(1), git-bug-bug-show(1), git-bug-bug-status(1), git-bug-bug-title(1)

---

ngl this page was generated from git-bug's source … dated Apr 2019, and it lives at the top as GIT-BUG(1) and at the bottom as GIT-BUG(1) again, because symmetry slays 💅 that's the whole sign-off, mwah 💋