@lets/run

$ run

👟 runs npm scripts interactively

$ npm i -g @lets/run

Simply run. You'll get an interactive menu.

$ run

Pass arguments. Arguments will be forwarded to the selected script

run --color

Otherwise you will get a chance to add in arguments after selecting the script to run

You can also run dependencies executables:

Create descriptive entries using package.json property: scripts:descriptions

You can hide scripts by explicitly setting the description to null

{
  "name": "package",
  "version": "1.0.0",
  "scripts": {
    "lint": "eslint '**/*.js'",
    "prestart": "echo \"prepare things\"",
    "start": "./bin.js"
  },
  "scripts:descriptions": {
    "lint": "Check code syntax",
    "prestart": null
  }
}

Replace npm start

{
  "name": "package",
  "version": "1.0.0",
  "scripts": {
    "start": "run --color",
    "build": "...",
    "test": "..."
  },
  "scripts:descriptions": {
    "build": "Prepare application files"
  },
  "devDependencies": {
    "@lets/run": "latest"
  }
}

aliases

run, lets-run