git-dit - the distributed issue tracker for git

WARNING: This is pre-1.0! Expect bugs and incompatibilities!

However, we try to avoid breaking changes.

git-dit features

• Distributed issue tracking, without checking files into the repository
• Convenient commandline interface (plumbing + porcelain)
• Implemented as git subcommand: git dit
• Each command has a --help
• No structured data
  • An issue/comment is a commit
  • "Tags" are supported (see man git-interpret-trailers)
• Convenience git dit push and git dit pull
• No additional software needed on the server-side.

When playing with this, please keep in mind that this is alpha quality - there are bugs, missing things and rough edges.

Installing

Cargo is used for building git-dit. Run

cargo build

in this directory in order to build git-dit. Building the git-dit man page is enabled through the "manpage" feature of the Cargo package. E.g. run

cargo build --features manpage

instead.

We do not provide any installation scripts. If you intent using or testing git-dit, make sure to have the binary in your PATH.

Additionally, for building the man page, pandoc is required.

If you use Nixpkgs, it is also available as the attribute gitAndTools.git-dit, so you can try it out with simply nix-shell -p gitAndTools.git-dit.

Documentation

For a system overview and conceptual information, refer to the documentation. For a more practical documentation, refer to the man page.

License

The library module is licensed under terms of MPL-2.0. The binary module (this directory) uses the library and provides a commandline interface for it and is licensed under terms of GNU GPLv2.

(c) Julian Ganz, Matthias Beyer