cli-kneeboard

cli-kneeboard is a tool that reads Markdown checklists and lets you programmatically run through them.

It is capable of saving the progress of a checklist as TOML allowing you to have reusable to-do lists.

When the app exits it will close with an ExitCode equal to the number of unresolved checklist items. This means you can use it as a git hook example here.

Installation

From binaries

• Go to releases and download the latest binary for your architecture.
• Extract the file and copy the binary to your PATH.

From source on crates.io

• Run cargo install cli-kneeboard

From source on Github.com

• Clone or download the repo
• Use cargo run -- [OPTIONS] to run the app in debug mode
• Or compile it with cargo build --release and get the binary from ./target/release/kneeboard

Usage

$ kneeboard --help
Checklist Tool

Usage: kneeboard [OPTIONS] --checklist-path <CHECKLIST_PATH>

Options:
  -c, --checklist-path <CHECKLIST_PATH>  Path to the checklist
  -s, --save                             Save and load progress of the checklist
  -v, --verbose...                       Turn debugging information on
      --headless                         Headless mode
  -h, --help                             Print help
  -V, --version                          Print version

• --checklist-path || -c is required and is the path to the Markdown checklist you want to load
• --save || -s tells cli-kneeboard to save and load the progress from a previous run in the same folder as the checklist named .<checklist-name-hash>.kb.toml
• --verbose || -v lets you set verbosity the more v's provided the higher the verbosity

cli-kneeboard will read in a checklist following the specification described in SPEC.md