Interactive wizard

Run the command from the root of the project you want to license and you'll be guided through a short flow:

npx license-wizard

• Choose a license. Start typing to search the full SPDX catalog (e.g. MIT, Apache-2.0, GPL-3.0-or-later) and select one. If your project already declares a license, it's offered as the default.
• Standard or customized. If the license has fillable copyright fields, keep the official text verbatim or fill in each field — typically the copyright holder and year.
• Save your settings. Choose whether to remember your selection for next time.

When you're done, License Wizard writes the LICENSE file and records the selected identifier in every manifest it finds. If you opted in, it also offers to stamp source-file headers.

Prefer to skip the prompts? Every step has a flag equivalent — see one-shot generation and scripting & agents.

The wizard runs on prompts alone — --dry-run is the only flag it accepts, and it simply previews the run without writing anything. Any other flag passed alongside an interactive invocation is rejected before the prompts even start: License Wizard prints what's wrong and exits non-zero, rather than silently applying the flag or quietly ignoring it. Advanced knobs such as --headers-comment and --headers-ignore only mean something on a flag-driven run, so they can't ride along and reshape the guided flow behind your back — switch to one-shot generation when you want that level of control.