jdx/usage v3.5.5

v3.5.5: Hyphen-prefixed flag values

on GitHub

A small patch release that lets value-taking flags accept hyphen-prefixed values (such as passthrough args to a wrapped CLI), plus a redesigned logo.

Fixed

• parse: allow hyphen-prefixed flag values (#715, fixes #713). Flags that carry passthrough values (e.g. forwarding args to terraform/terragrunt) previously lost values that started with - when the first letter collided with an existing short flag — ./repro -a -destroy would tokenize -destroy as -d estroy and silently drop the intended value of -a. Value flags can now opt in via allow_hyphen_values=#true, and the parser will consume the next -… token as that flag's value before short/long flag parsing kicks in:

  flag "-a --args <ARGS>" allow_hyphen_values=#true

  This works for -a -destroy, --args=-destroy, and repeated variadic values like -a -val1 -a -val2. Flags without the opt-in keep their existing behavior. The built-in usage complete-word --cword flag now sets this internally so negative cword indices parse correctly.

Documentation

• Redesigned logo (#714). Replaces the previous raster logo with a clean flat vector flag mark — an ink flagpole with a green (#22c55e) swallowtail banner carrying the -- flag prefix. All derived favicons and app icons were regenerated from the new vector source, and an SVG favicon is now served for browsers that support it.

Full Changelog: v3.5.4...v3.5.5

💚 Sponsor usage

usage is maintained by @jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools including mise, aube, hk, and more. Work on usage is funded by sponsorships.

If usage powers CLI specs, docs, or completions for a tool you maintain or use, please consider sponsoring at jdx.dev. Every sponsorship helps the project stay independent and moving.