License npm npm Donate to this project using Buy Me A Coffee wakatime


By: Justin Sunday
GitHub: sundayj/npm-script-selector
NPM: npm-script-selector

NPM Script Selector

The NPM Script Selector is a CLI tool for discovering and running project scripts within package.json files. Have you ever worked on a project that contains so many scripts that you can’t always remember the available options? That’s what happened to me. I currently contribute to a project with 30+ scripts. I became tired of having to open the package file and/or IDE in order to find and run the needed scripts, so I created this small CLI.

Currently, you provide the path to the package.json file, the NPM Script Selector will then list the available scripts for you, where you can interactively select the one you want. It will then run the script for you within the selected project’s directory. I plan to add more functionality in the near future.

Uses figlet, commander, and inquirer.


If you like this package, please consider sponsoring:

Buy Me A Coffee

Feature Requests or Bugs

For feature requests, or bugs, please create an issue here


Future Features

Installation and Usage

Install NPM Script Selector with npm:

  npm i -g npm-script-selector

To run:

> npmss -f path/to/desired/package.json

For Help:

> npmss -h

Usage: npmss [options]

The NPM Script Selector is a CLI tool for discovering and running project scripts within package.json files.

  -V, --version               output the version number
  -f, --file <value>          Path to the package.json.
  -b, --banner <value>        Value for the title to be displayed to the user. (Replaces the NPM-Script-Selector banner.)
  -hb, --hide-banner          Use this flag if you'd like to not display a banner at all.
  -bf, --banner-font <value>  Pass the name of a font listed here to print the banner in the desired font.
  -h, --help                  display help for command

Path can be relative to current directory, or absolute.

NPM Script Selector Screenshot 20231025


Bug reports and pull requests are welcome on GitHub at sundayj/npm-script-selector. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


The package is available as open source under the terms of the MIT License.