https://github.com/omrilotan/run

👟 run npm scripts interactively
https://github.com/omrilotan/run

cli nodejs npm-scripts productivity

Last synced: about 1 year ago
JSON representation

👟 run npm scripts interactively

• Host: GitHub
• URL: https://github.com/omrilotan/run
• Owner: omrilotan
• License: mit
• Created: 2019-10-17T10:42:56.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-02-02T17:38:29.000Z (over 4 years ago)
• Last Synced: 2025-04-18T18:56:44.342Z (about 1 year ago)
• Topics: cli, nodejs, npm-scripts, productivity
• Language: JavaScript
• Size: 20.5 KB
• Stars: 15
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# `$ run`

## 👟 runs npm scripts interactively [![](https://img.shields.io/npm/v/@lets/run.svg)](https://www.npmjs.com/package/@lets/run) [![](https://github.com/omrilotan/run/workflows/Publish/badge.svg)](https://github.com/omrilotan/run/actions) [![](https://img.shields.io/badge/source--000000.svg?logo=github&style=social)](https://github.com/omrilotan/run)

![](https://user-images.githubusercontent.com/516342/68541500-02d39b00-03a9-11ea-9df6-fd0d880af441.gif)

```

$ 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:

![](https://user-images.githubusercontent.com/516342/69226314-9e72c180-0b88-11ea-8fc2-fd5ff3aac71f.gif)

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

> You can hide scripts by explicitly setting the description to null

```json

{

  "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

  }

}

```

![](https://user-images.githubusercontent.com/516342/69716427-a4314f80-1112-11ea-957f-3385b9e0155a.png)

## Replace `npm start`

```json

{

  "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