# tisket

> tisket is a plaintext issue tracker that stores issues as markdown files in a git repository.

Each link below opens a page's Markdown twin. Diátaxis sections are Tutorials, How-to guides, Reference, and Optional; Optional holds explanation pages and may be skipped. Installation packages are Homebrew `cjohnhanson/tap/tisket`, crate `tisket`, PyPI `tisket`, and npm `tisket`.


## Tutorials

- [Getting Started with Tisket](https://tisket.eng.rip/getting-started.md): Set up plaintext issue tracking in your project

## How-to guides

- [How to manage issues day to day](https://tisket.eng.rip/workflow.md): Create, organize, and manage issues with tisket

## Reference

- [tisket CLI reference](https://tisket.eng.rip/cli-reference.md): Every command, argument, and flag of the tisket binary, generated from its definition
- [tisket file format](https://tisket.eng.rip/file-format.md): Issue IDs, statuses, the files tisket reads and writes, and its JSON output

## Optional

- [What is Tisket?](https://tisket.eng.rip/what-is-tisket.md): Why plaintext issue tracking and how tisket's design works