8 releases

0.1.7 Feb 8, 2023
0.1.6 Feb 7, 2023
0.1.4 Dec 6, 2022
0.1.3 Nov 18, 2022

#282 in Command line utilities

Download history 10/week @ 2022-11-20 1/week @ 2022-11-27 29/week @ 2022-12-04 1/week @ 2022-12-11 7/week @ 2022-12-18 6/week @ 2022-12-25 1/week @ 2023-01-01 5/week @ 2023-01-08 1/week @ 2023-01-15 3/week @ 2023-01-22 29/week @ 2023-01-29 64/week @ 2023-02-05 14/week @ 2023-02-12 17/week @ 2023-02-19 17/week @ 2023-02-26

56 downloads per month

MIT license

654 lines

Crate License Crate Downloads Build


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.



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


$ kneeboard --help
cli-kneeboard 0.1.0
Alexis Lowe <agl314@chimbosonic.com>
Checklist Tool

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

    -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


~249K SLoC