# What changed in @clack/prompts

> 89 changes in @clack/prompts 1 from its official release notes, upgrade guides and advisories: 8 breaking, 46 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@clack/prompts/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @clack/prompts 1

### Breaking changes

- The default formatter of note() no longer dims lines; provide a format() function to restore the old behavior. (1.6.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.6.0)
- The package now declares a Node.js >=20.12 requirement. (1.3.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.3.0)
- The package is now distributed as ESM-only instead of being dual-published as CJS and ESM. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A placeholder is a visual hint rather than a tabbable value. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The path prompt is changed to be an autocomplete prompt. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Progress bars use a distinct cancel method instead of stop with a status code. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Progress bar errors use a distinct error method instead of stop with a status code. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Spinner errors use a distinct error method instead of stop with a status code. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)

### New APIs and options

- Prompts support asynchronous validation. (1.8.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.0)
- Adds opt-in Tab completion: pressing Tab fills the input with the focused suggestion and shows a completion hint; default behavior is unchanged. (1.8.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.0)
- Exports the CANCEL_SYMBOL constant from @clack/prompts. (1.8.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.0)
- The select, multiselect, and groupMultiselect prompts accept showInstructions; keyboard hints remain shown by default, and passing false hides them. (1.7.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.7.0)
- Adds a maxItems option to groupMultiselect. (1.4.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.4.0)
- groupMultiselect now supports scrolling. (1.4.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.4.0)
- Adds a prompt for multi-line text input. (1.3.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.3.0)
- Adds a placeholder option; when the input is empty, pressing tab sets the value to the placeholder. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- Adds a date prompt with format support for YMD, MDY, and DMY. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- The confirm prompt gains a `vertical` arrangement option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The confirm prompt now supports the `withGuide` option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The password prompt now supports the `withGuide` option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The select prompt now supports the `withGuide` option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The selectKey prompt now supports the `withGuide` option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The spinner prompt now supports the `withGuide` option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The prompts package adds an autocomplete-multiselect component. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Autocomplete multiselect adds a required option. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The prompts package adds an autocomplete component. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Autocomplete multiselect accepts a custom filter function, enabling filtering such as fuzzy searching. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- AutocompletePrompt is added to core, with autocomplete and autocomplete-multiselect components in the prompts package. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A box prompt renders boxed text, similar to a note. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Select-key adds a caseSensitive option. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A positive integer groupSpacing adds that number of new lines between groups. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Multi-select prompts allow disabled options. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The note prompt adds a format option for formatting individual lines. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The note prompt supports withGuide. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The password prompt can automatically clear input when validation fails. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A progress prompt displays a progress bar. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- All prompts accept a custom input stream. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- All prompts accept a custom output stream. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- All prompts accept withGuide to disable the default Clack border. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Select prompts allow disabled options. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Setting selectableGroups to false prevents selecting top-level groups while leaving their children selectable. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Prompt settings, including messages, are accessible directly. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Spinner cancellation uses a distinct cancel method instead of stop with a status code. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Spinner instances can customize their cancellation message. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A clear method stops and clears a spinner. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Spinner instances can customize their error message. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The spinner prompt supports custom frames. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- The spinner prompt adds a styleFrame option. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A SpinnerResult type describes the return type of spinner. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- A taskLog prompt provides log output that is cleared on success. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Task logs can use groups, and groups can have scrolling windows of logs. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Global prompt settings can customize spinner cancellation messages. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Global prompt settings can customize spinner error messages. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Prompts store user input separately from their value. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)

### Behavior and default changes

- The guide bar rendered with withGuide enabled is styled grey to match the gutter drawn by log, note, and the spinner. (1.8.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.0)
- Text prompts render validation state. (1.8.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.0)
- Shows keyboard instruction footers in the active state, with no option to disable them. (1.6.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.6.0)
- Shows keyboard instruction footers in the active state, with no option to disable them. (1.6.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.6.0)
- Shows keyboard instruction footers in the active state, with no option to disable them. (1.6.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.6.0)
- Autocomplete and select prompts support wrapping. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Prompts support signals so they can be aborted. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Spinner output wraps to support multi-line and wrapped messages. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Spinner cancellation can be detected via CTRL+C, allowing graceful handling of user interruptions. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Log messages show a symbol when withGuide is true. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)

### Fixes and other changes

- Prompt return types now specify CANCEL_SYMBOL instead of the broader symbol type, improving type accuracy. (1.8.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.1)
- Fixes extra spaces in text prompts when withGuide is enabled. (1.8.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.8.0)
- Various prompts and utilities now handle empty arrays. (1.7.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.7.0)
- Fixed spaces and uppercase characters in multiline prompt input. (1.5.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.5.0)
- Removes indent when withGuide is set to false. (1.4.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.4.0)
- Fixes line wrapping and overflow computation in group multi-select and other list-like prompts. (1.4.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.4.0)
- The autocomplete prompt now respects `withGuide: false`. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- Applies the guide to wrapped multi-line messages in the confirm prompt. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- The multiselect prompt now respects `withGuide: false`. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- With `directory: true`, the path prompt enforces directory-only selection while still allowing directory navigation. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- Pressing Enter with an existing directory as `initialValue` submits that directory instead of the first child option. (1.2.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.2.0)
- Fixes withGuide support in intro, outro, and cancel messages. (1.1.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.1.0)
- Fixes line wrapping behavior in autocomplete. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- Autocomplete no longer allows disabled options to be selected. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- The path prompt now supports the `withGuide` option. (1.0.1) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.1)
- Box rendering handles CJK correctly. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Multi-line prompts support wrapped messages. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Hints are now shown for every selected option that has a hint property, rather than only the first option. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Note text is hard-wrapped to the column limit, and a note overflow bug is fixed. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Note rendering handles CJK correctly. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Placeholder rendering in autocomplete is fixed. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Select-key wrapping is fixed. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Multi-line messages and options render correctly in select prompts. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Calling stop on a spinner that has not started is handled. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)
- Destructive ANSI codes are stripped from task log messages. (1.0.0) — [release notes](https://github.com/bombshell-dev/clack/releases/tag/%40clack/prompts%401.0.0)