Description:
Tool for working with usage-spec CLIs
|
|
Type: Formula
|
Latest Version: 2.9.0@0
|
Tracked Since: Dec 19, 2025
|
|
Links:
Homepage |
formulae.brew.sh
|
|
Category: Developer tools
|
|
Tags:
cli
documentation
developer-tools
shell-completion
argument-parsing
|
|
Install:
brew install usage
|
About:
Usage is a CLI tool and library for working with usage specifications defined in a structured format. It can generate documentation, parse command-line arguments, and provide shell completion scripts based on these specs. This streamlines CLI development by ensuring consistency between implementation and user-facing help text.
|
Key Features:
- Generate documentation (man pages, markdown) from usage specs
- Parse CLI arguments and flags according to a spec
- Produce shell completion scripts for bash, zsh, and fish
- Declarative specification format for CLI interfaces
|
Use Cases:
- Standardizing help text and documentation across multiple CLI tools
- Building robust argument parsing for new command-line applications
- Automating the creation of shell completion scripts for projects
|
Alternatives:
-
clap
– Rust library providing similar parsing and completion features, but tightly coupled to Rust code rather than a separate spec format.
-
cobra
– Go framework for CLIs that includes documentation generation and completion, but requires Go-specific struct definitions.
|
| Detected |
Version |
Rev |
Change |
Commit |
| Dec 19, 2025 1:13am |
2.9.0 |
0 |
VERSION_BUMP |
47335acb |
| Nov 11, 2025 2:28pm |
|
0 |
VERSION_BUMP |
9f514f04 |
| Nov 1, 2025 12:14am |
|
0 |
VERSION_BUMP |
963f17d6 |
| Oct 26, 2025 8:02pm |
|
0 |
VERSION_BUMP |
c0c5f63a |
| Oct 26, 2025 12:34pm |
|
0 |
VERSION_BUMP |
f68fd694 |
| Oct 22, 2025 12:45am |
|
0 |
VERSION_BUMP |
7938a4ee |
| Sep 28, 2025 8:55pm |
|
0 |
VERSION_BUMP |
1aa4ee84 |
| Jan 10, 2025 9:43pm |
|
0 |
VERSION_BUMP |
58ef7b28 |
| Dec 21, 2024 1:05pm |
|
0 |
VERSION_BUMP |
17b6a80f |
| Dec 18, 2024 3:22pm |
|
0 |
VERSION_BUMP |
677c59fd |
| Dec 14, 2024 4:45pm |
|
0 |
VERSION_BUMP |
5c5fb25b |
| Dec 12, 2024 7:11pm |
|
0 |
VERSION_BUMP |
d60af08e |
| Dec 4, 2024 11:33pm |
|
0 |
VERSION_BUMP |
0a3bb3b9 |
| Nov 16, 2024 2:29am |
|
0 |
VERSION_BUMP |
269099b9 |
| Nov 16, 2024 2:09am |
|
0 |
VERSION_BUMP |
35a6dee1 |
| Nov 14, 2024 4:56pm |
|
0 |
VERSION_BUMP |
64420a8b |
| Nov 10, 2024 7:19pm |
|
0 |
VERSION_BUMP |
8704c49c |
| Oct 31, 2024 7:57pm |
|
0 |
VERSION_BUMP |
ecfd3e27 |
| Oct 28, 2024 4:41pm |
|
0 |
VERSION_BUMP |
3b1b1510 |
| Oct 27, 2024 8:54pm |
|
0 |
VERSION_BUMP |
dd3742b1 |
| Oct 12, 2024 9:50pm |
|
0 |
VERSION_BUMP |
e586e4f3 |
| Oct 12, 2024 8:04pm |
|
0 |
VERSION_BUMP |
2df59d3f |
| Sep 29, 2024 5:30pm |
|
0 |
VERSION_BUMP |
bedfdd9a |
| Sep 28, 2024 10:46pm |
|
0 |
VERSION_BUMP |
4c393e9d |
| Sep 28, 2024 9:41pm |
|
0 |
VERSION_BUMP |
092d95da |
| Sep 27, 2024 6:29pm |
|
0 |
VERSION_BUMP |
097faa90 |
| Sep 27, 2024 1:45pm |
|
0 |
VERSION_BUMP |
885d9268 |
| Sep 26, 2024 3:09pm |
|
0 |
VERSION_BUMP |
a90e8b66 |
|