git-bug
A distributed, offline-first bug tracker that stores issues inside your git repository.
At a Glance
Self-hosted git-bug core released under GPLv3 or later; free to use, modify and distribute under the license terms.
Engagement
Available On
Alternatives
Listed Nov 2026
About git-bug
git-bug is an open-source bug tracker developed under the git-bug GitHub organization and released under GPLv3 or later. It stores bugs inside a git repository, so a normal git remote is enough to share, push and pull issues without adding files to the project. The latest listed release is v0.12.0.
What It Is
git-bug is a distributed issue tracker written in Go. Bugs live in the git repository itself, which lets users read and write them offline and keep a full backup of their tracker data. Users work through a CLI, an interactive terminal UI, or a web UI, and can integrate with other tooling via the CLI or a GraphQL API.
How the Workflow Works
A user creates an identity with git bug user new, adds bugs with git bug add (which opens an editor for title and message), and shares them with git bug push and git bug pull. Bugs can be listed with git bug ls, filtered and sorted with a query language (for example status:open sort:edit), or searched by text. Commands such as show, comment, open and close display and modify bugs.
Interfaces
The terminal UI (git bug termui) lets users browse and edit bugs interactively. The web UI (git bug webui) supports browsing, searching and filtering issues, opening new ones, commenting, and editing titles, labels and status. It also acts as a code browser with a file tree, syntax-highlighted files, commit history and diffs. The web UI is packaged in the same Go binary and served by a local HTTP server that talks to a GraphQL API. The README describes using the web UI as a public portal that accepts external input as a work in progress.
Bridges to Other Trackers
Bridges import from and export to GitHub, GitLab, Jira and Launchpad. With git bug bridge pull and git bug bridge push, git-bug can serve as a local, offline-capable interface to those trackers. The on-disk format is formally specified in a separate spec repository for anyone writing another implementation.
Community Discussions
Be the first to start a conversation about git-bug
Share your experience with git-bug, ask questions, or help others learn from your insights.
Pricing
Open Source (GPLv3+)
Self-hosted git-bug core released under GPLv3 or later; free to use, modify and distribute under the license terms.
- Bug tracker fully integrated in git
- Distributed and works offline
- CLI, interactive terminal UI and Web UI
- GraphQL API
- Bridges to GitHub, GitLab, Jira and Launchpad
Capabilities
Key Features
- Bugs stored inside the git repository without adding files to the project
- Distributed collaboration through git push and pull
- Offline reading and writing of bugs
- Query language for filtering and sorting bugs
- Interactive terminal UI
- Web UI with issue management and code browser
- GraphQL API
- Bridges for GitHub, GitLab, Jira and Launchpad
- Shell completion and man pages
