71 releases (28 stable)

new 2.0.6 Mar 18, 2025
2.0.3 Jan 10, 2025
1.7.4 Dec 21, 2024
1.3.3 Nov 22, 2024
0.1.0 Aug 13, 2023

#522 in Configuration

Download history 1396/week @ 2024-11-29 3020/week @ 2024-12-06 3900/week @ 2024-12-13 1887/week @ 2024-12-20 1202/week @ 2024-12-27 1047/week @ 2025-01-03 1542/week @ 2025-01-10 765/week @ 2025-01-17 1050/week @ 2025-01-24 796/week @ 2025-01-31 493/week @ 2025-02-07 1149/week @ 2025-02-14 880/week @ 2025-02-21 607/week @ 2025-02-28 386/week @ 2025-03-07 726/week @ 2025-03-14

2,689 downloads per month

MIT license

210KB
5K SLoC

Usage

Usage is a spec and CLI for defining CLI tools. Arguments, flags, environment variables, and config files can all be defined in a Usage spec. It can be thought of like OpenAPI (swagger) for CLIs. Here are some potential reasons for defining your CLI with a Usage spec:

  • Generate autocompletion scripts
  • Generate markdown documentation
  • Generate man pages
  • Use an advanced arg parser in any language
  • Scaffold one spec into different CLI frameworks—even different languages
  • [coming soon] Host your CLI documentation on usage.sh

See more at usage.jdx.dev.

Dependencies

~17–45MB
~717K SLoC