Skip to content

ad-si/gitis

Repository files navigation

Gitis

A git-backed and YAML-based distributed issue tracker.

Reasons

  • Code and documentation are in the git repo and so should your issues
  • You shouldn't have to leave your programming environment to manage issues
  • You should be able to view and edit issues offline

Installation

npm install -g gitis

Usage

Issues are stored as YAML files inside an issues/ directory at the root of your project. The filename is used as the issue's timestamp/id (e.g. 2016-05-31T0759.yaml).

List issues in the current directory:

gitis

List issues in a specific project directory:

gitis path/to/project

Options

Option Default Description
--state open Filter by state: open or closed
--sortBy datetime Field to sort issues by
--sortOrder ascending Sort order: ascending or descending
--help, -h Show help
--version Show version

Examples:

gitis --state closed
gitis --sortOrder descending

Configuration

Defaults can be set per-project via a .gitisrc file (JSON) in the project root, or via environment variables.

Schema

title: Use Gitis instead of GitHub issues
user: adius
tags:
  - must_have
  - important
  - easy_to_implement
state: open
assignee: everyone
comments:
  - user: octocat
    body: Great idea!
    created_at: 2015-01-12 14:45:21
  - user: offlineJoe
    body: Can't wait for it!
    created_at: 2015-01-12 14:51:34
milestone: finally_independent
created_at: 2015-01-12 13:44:46
updated_at: 2015-01-12 13:46:12
closed_at: null
body: |
  Our issues should be managed with Gitis and not with GitHub Issues

Related

Name Git Based Own Branch Storage format CLI UI License
t txt t X11
beastie YAML beastie MIT
gaskit ✔︎ ✔︎ ? ✔︎ GPL
gitissius ✔︎ ✔︎ JSON ✔︎ GPLv3
bugseverywhere ✔︎ ? ? ✔︎ ✔︎ GPLv2
gi ✔︎ ✔︎ txt ✔︎ GPLv3
gitis ✔︎ YAML ✔︎ ✔︎ MIT

About

A git-backed and YAML-based distributed issue tracker

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors