<div align="center">

git-bug: a decentralized issue tracker

Issues - Documentation - Feedback

</div>

Overview<a name="overview"></a>

git-bug is a standalone, distributed, offline-first issue management tool that embeds issues, comments, and more as objects in a git repository (not files!), enabling you to push and pull them to one or more remotes.

<!-- mdformat-toc start --slug=github --maxlevel=6 --minlevel=2 -->

• Overview
• Key Features
• Getting Started
• Our Community
  • Backers :star:
  • Sponsors :star2:
• License

<!-- mdformat-toc end -->

Key Features<a name="key-features"></a>

• Native Git Storage: Manage issues, users, and comments directly within your repository - keeping everything versioned and clutter-free
• Distributed & Versioned: Leverage Git’s decentralized architecture to work offline and sync seamlessly later
• Lightning Fast: List and search issues in mere milliseconds
• Third-Party Bridges: Easily synchronize issues with platforms like GitHub and GitLab using bridges
• Flexible Interfaces: Choose how you interact - via CLI, TUI, or a web browser
• Effortless Integration: Start managing issues your repository with minimal setup

Getting Started<a name="getting-started"></a>

• :triangular_flag_on_post: Install: Check out //:INSTALLATION.md for step-by-step installation instructions or explore the latest release to get started immediately.
• :page_with_curl: Explore: Read the documentation to learn how to use git-bug effectively
• :computer: Contribute: Interested in hacking on git-bug? Head over to //:CONTRIBUTING.md and see how you can help shape the project
• :speech_balloon: Connect: Chat with us live on Matrix at #git-bug:matrix.org
• :books: Discuss: Browse existing discussions or start a new one to ask questions and share ideas

Our Community<a name="our-community"></a>

git-bug thrives thanks to the passion of its contributors, the generosity of independent backers, and the strategic support of our sponsors. Each of you plays a crucial role in our journey, and we deeply appreciate every contribution that helps drive our project forward.

Make a contribution to support this project and get featured below!

Backers :star:<a name="backers-star"></a>

<div align="center">

</div>

Sponsors :star2:<a name="sponsors-star2"></a>

<div align="center">

</div>

License<a name="license"></a>

Unless otherwise stated, this project and all assets within it are released under GPLv3 or later, copyright Michael Muré.

The git-bug logo is authored by and copyright Viktor Teplov, released under a CC BY 4.0 license.

---

<div align="center">

This project and its vibrant community was initially dreamt up and built by Michael Muré.

Thank you for all of your hard work!

:heart:

</div>