Lint your --help output against the CLI Guidelines.
Flagcraft is a linter for the text your command-line tool prints when someone runs it
with --help. Paste that output into the box above and it grades the flags
against the
Command Line Interface Guidelines, the widely cited spec
for how a good CLI should behave. Every finding names the exact guideline it comes from,
so you get a reason, not just a red mark.
It runs five checks:
-h short alias
for --help.
-f
that maps to two different long flags across a command tree.
--version
(or -V).
Flagcraft never runs your program or reads its source. It parses the same
--help text a user would see in a terminal, so it works with any framework
that prints column-aligned help: Python's argparse, Rust's clap, Go's cobra, Node's
commander, or a hand-rolled parser. Everything runs in your browser. The text you paste
never leaves your machine, and there is nothing to install.
--help output?--help, copy the output, and paste it in. Or
click a preset (git, docker, kubectl) to see how established tools score.
-f for different
long flags across subcommands, which is exactly the kind of inconsistency the
guidelines warn against.