git-bug
[](https://travis-ci.org/MichaelMure/git-bug)
[](#backers) [](#sponsors) [](http://www.gnu.org/licenses/gpl-3.0)
[](https://godoc.org/github.com/MichaelMure/git-bug)
[](https://goreportcard.com/report/github.com/MichaelMure/git-bug)
[](https://gitter.im/the-git-bug/Lobby)
`git-bug` is a bug tracker that:
- **is fully embeded in git**: you only need your git repository to have a bug tracker
- **is distributed**: use your normal git remote to collaborate, push and pull your bugs!
- **works offline**: in a plane or under the sea? Keep reading and writing bugs!
- **prevents vendor lock-in**: your usual service is down or went bad? You already have a full backup.
- **is fast**: listing bugs or opening them is a matter of milliseconds
- **doesn't pollute your project**: no files are added in your project
- **integrates with your tooling**: use the UI you like (CLI, terminal, web) or integrate with your existing tools through the CLI or the GraphQL API
- **bridges to other bug trackers**: use [bridges](#bridges) to import and export to other trackers.
:construction: This is now more than a proof of concept, but still not fully stable. Expect dragons and unfinished business. :construction:
## Install
Pre-compiled binaries
1. Go to the [release page](https://github.com/MichaelMure/git-bug/releases/latest) and download the appropriate binary for your system.
2. Copy the binary anywhere in your $PATH
3. Rename the binary to `git-bug` (or `git-bug.exe` on windows)
That's all !
Linux packages
* [Archlinux (AUR)](https://aur.archlinux.org/packages/?K=git-bug)
go install (unstable)
```shell
go install github.com/MichaelMure/git-bug
```
If it's not done already, add the golang binary directory in your PATH:
```bash
export PATH=$PATH:$(go env GOROOT)/bin:$(go env GOPATH)/bin
```
This web UI is entirely packed inside the same go binary and serve static content through a localhost http server.
The web UI interact with the backend through a GraphQL API. The schema is available [here](graphql/).
## Bridges
### Importer implementations
| | Github | Gitlab | Launchpad |
| --- | --- | --- | --- |
| **incremental**
(can import more than once) | :heavy_check_mark: | :heavy_check_mark: | :x: |
| **with resume**
(download only new data) | :heavy_check_mark: | :heavy_check_mark: | :x: |
| **identities** | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| identities update | :x: | :x: | :x: |
| **bug** | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| comments | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| comment editions | :heavy_check_mark: | :x: | :x: |
| labels | :heavy_check_mark: | :heavy_check_mark: | :x: |
| status | :heavy_check_mark: | :heavy_check_mark: | :x: |
| title edition | :heavy_check_mark: | :heavy_check_mark: | :x: |
| **media/files** | :x: | :x: | :x: |
| **automated test suite** | :heavy_check_mark: | :heavy_check_mark: | :x: |
### Exporter implementations
| | Github | Gitlab | Launchpad |
| --- | --- | --- | --- |
| **bug** | :heavy_check_mark: | :heavy_check_mark: | :x: |
| comments | :heavy_check_mark: | :heavy_check_mark: | :x: |
| comment editions | :heavy_check_mark: | :heavy_check_mark: | :x: |
| labels | :heavy_check_mark: | :heavy_check_mark: | :x: |
| status | :heavy_check_mark: | :heavy_check_mark: | :x: |
| title edition | :heavy_check_mark: | :heavy_check_mark: | :x: |
| **automated test suite** | :heavy_check_mark: | :heavy_check_mark: | :x: |
#### Bridge usage
Interactively configure a new github bridge:
```bash
git bug bridge configure
```
Or manually:
```bash
git bug bridge configure \
--name=mybridge \
--target=github \
--url=https://github.com/michaelmure/git-bug \
--token=$TOKEN
```
Import bugs:
```bash
git bug bridge pull []
```
Export modifications:
```bash
git bug bridge push []
```
Deleting a bridge:
```bash
git bug bridge rm []
```
## Internals
Interested by how it works ? Have a look at the [data model](doc/model.md) and the [internal bird-view](doc/architecture.md).
## Misc
- [Bash completion](misc/bash_completion)
- [Zsh completion](misc/zsh_completion)
- [PowerShell completion](misc/powershell_completion)
- [ManPages](doc/man)
## Planned features
- media embedding
- more bridges
- extendable data model to support arbitrary bug tracker
- inflatable raptor
## Contribute
PRs accepted. Drop by the [Gitter lobby](https://gitter.im/the-git-bug/Lobby) for a chat or browse the issues to see what is worked on or discussed.
Developers unfamiliar with Go may try to clone the repository using "git clone". Instead, one should use:
```shell
go get -u github.com/MichaelMure/git-bug
```
The git repository will then be available:
```shell
# Note that $GOPATH defaults to $HOME/go
$ cd $GOPATH/src/github.com/MichaelMure/git-bug/
```
You can now run `make` to build the project, or `make install` to install the binary in `$GOPATH/bin/`.
To work on the web UI, have a look at [the dedicated Readme.](webui/Readme.md)
## Contributors :heart:
This project exists thanks to all the people who contribute.
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/git-bug#backer)]
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/git-bug#sponsor)]
## License
Unless otherwise stated, this project is released under the [GPLv3](LICENSE) or later license © Michael Muré.
The git-bug logo by [Viktor Teplov](https://github.com/vandesign) is released under the [Creative Commons Attribution 4.0 International (CC BY 4.0)](misc/logo/LICENSE) license © Viktor Teplov.