git-issues

A git extension for issue management

---

git-issues is an extension for git that adds issue management to the repository.

It is designed to be used by the extension, but care has been taken to ensure it can also be used by those who wish to use other tools to manage the issues.

---

Stability

git-issues is still under active development, and is not yet in a working state.

Using it will probably screw up your git tree.

Documentation likely points to incorrect information, and information that is not yet correct (i.e. Talks about unimplemented features).

Until git-issues is in a usable state, the version number will remain 0.0.0

When git-issues is in a usable state, issues will continue to be managed by th git provider (i.e. GitHub), as if you're having issues with git-issues, you may not be able to use it to raise issues here.

Roadmap

• Installer
• Uninstaller
• Open Issues
• Close Issues
• Comment Issues
• Tag Issues
• List Issues
• Issues Graph
• Issues Log
• Issues Rate
• Issues TUI
• vim plugin
• emacs plugin
• Atom plugin
• Issues Sync
• 1.0.0

---

Usage

See git-issues help

or

run:

git issues help

---

Installation

Platform Support

• Linux
  • Fully supported
• BSD
  • May work. Please raise issues if you have them.
• macOS
  • May work. Please raise issues if you have them.
• Cygwin
  • May work. Sorry, I can't help if you encounter problems.

Prequisites

These tools need to be installed and in your PATH:

• git
• make
• grep
  • usually pre-installed
• sha512sum
  • usually pre-installed
• cut
  • usually pre-installed
• tr
  • usually pre-installed
• readlink
  • usually pre-installed
  • macOS users may need to install GNU Readlink.
• less
  • usually pre-installed
  • Or set $PAGER to some other pager utility.
• dialog or whiptail
  • optional, used for tui

Note: If any tool is not found, then git-issues will complain in a helpful manner.

---

Install

make install

Note: May need to run as root. (e.g. sudo make install).

You can also specify PREFIX to change the default install location. (This destination will also be remembered by the uninstall script.)

Uninstall

git issues uninstall

Note: May need to run as root, depending on where you installed it. (e.g. sudo git-issues uninstall).

---

Contributing

All contributions should follow the instructions found in the CONTRIBUTING.md file.

---

License

Effectively public domain, however the full legal code can be found in the LICENSE file.

Released under Creative Commons 0 license.