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
cli-kneeboard 0.1.0
Alexis Lowe <agl314@chimbosonic.com>
Checklist Tool

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

OPTIONS:
    -c, --checklist-path <CHECKLIST_PATH>    Path to the checklist
    -h, --help                               Print help information
    -s, --save                               Save progress of the checklist
    -v, --verbose                            Turn debugging information on
    -V, --version                            Print version information

• --checklist-path || -c is required and is the path to the Markdown checklist you want to load
• --save || -s tells cli-kneeboard to save the progress of the checklist in the same folder as the checklist named .<checklist-name>.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