You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Sign inDemoInstall


Package Overview
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies



Simple utility for prompting the user for input in a CLI environment

Version published
Weekly downloads
increased by20.22%
Weekly downloads



Simple CLI prompter version

This repo contains simple utility methods for promting the user for input in a CLI application. There is deliberately only a few different types of prompts that behave consistently and are easy to use (both for the end-user and the developer).

When there are options to select you can always type to search for the option you want.
The search is case-insensitive and looks for subsequences, e.g. to find the item This is a test you can type is test, which will match (and highlight) is and test in the item.


There are 4 methods for prompting users for input.


export type Choice = { message?: string; name: string; hint?: string };

export type StringOrChoice = string | Choice;

export async function ask(
  text: string,
  choices?: StringOrChoice[],
): Promise<string>;

The ask function prompts the user for a string, and if the choices parameter is provided, the user can only select one of the provided options. The selected option is returned as a string.

If using the Choice type the name field is the value that is returned when the user selects the option, and message and hint are used to display the option to the user.


export async function confirm(
  message: string,
  defaultChoice = true,
  secondsTimeout = 0,
): Promise<boolean>;

The confirm function prompts the user for a boolean value, and if the secondsTimeout parameter is provided the default choice is used after the timeout has passed.


export async function file(text: string, ext?: string, cwd?: string): Promise<string>;

The file function prompts the user for a file path, and if the ext parameter is provided the user can only select files with the provided extension. cwd is used as the base directory for the file path. It defaults to the current working directory.


export async function multiple(
  text: string,
  choices: StringOrChoice[],
  requiredAtLeastOne = true,
): Promise<string[]>;

Similar to ask but allows the user to select multiple options. Tapping the space key toggles the selection of the currently highlighted option.


export function logAbove(str: string): void;

There is additionally a utility function logAbove that logs a string above current prompting UI. Simply logging a string using console.log(...) will overwrite the prompting UI, so this function has to be used if a user might be actively interacting with a prompt.

Guidelines for application developers

  • Provide options to select from whenever possible.
    The UI scales to an absurd amount of options, so it's fine to present a UI where there are thousands of options to select from.
  • Prepare things in the background using promises.
    Heavy work can often be prepared in the background. E.g. in the example app (see exampleApp) a git repository is cloned in the background while the user is prompted for what to do.
  • async all the things! Any synchronous IO that happens while the user is prompted will block the UI.


Package last updated on 14 May 2024

Did you know?


Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.


Related posts

SocketSocket SOC 2 Logo


  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog


Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc