# @lets/run

> 👟 run npm scripts interactively

Latest version **1.4.1** (published 2019-11-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install @lets/run
pnpm add @lets/run
yarn add @lets/run
bun add @lets/run
```

Provides the commands `run`, `lets-run`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.4.1 |
| Published | 2019-11-27 |
| First published | 2019-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 7.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 15 |
| Author | omrilotan |
| Maintainers | omrilotan |
| Keywords | npm, run, scripts, interactive, 👟 |

## Links

- npm: https://www.npmjs.com/package/@lets/run
- Repository: https://github.com/omrilotan/run
- Homepage: https://omrilotan.com/run/
- Issues: https://github.com/omrilotan/run/issues
- npm.io page: https://npm.io/package/@lets/run

## Dependencies (4)

- [colors](https://npm.io/package/colors.md) ^1.4.0
- [inquirer](https://npm.io/package/inquirer.md) ^7.0.0
- [@does/exist](https://npm.io/package/@does/exist.md) ^1.0.0
- [async-execute](https://npm.io/package/async-execute.md) ^1.1.0

## Alternatives

- [@mce/gif](https://npm.io/package/@mce/gif.md) — 2.6K weekly downloads
- [cleanse](https://npm.io/package/cleanse.md) — 173 weekly downloads
- [str](https://npm.io/package/str.md) — 127 weekly downloads
- [naming](https://npm.io/package/naming.md) — 95 weekly downloads
- [tap-telco-api](https://npm.io/package/tap-telco-api.md) — 19 weekly downloads

## Recent versions

- 1.4.1 (latest) — 2019-11-27
- 1.4.0 — 2019-11-27
- 1.3.1 — 2019-11-27
- 1.3.0 — 2019-11-27
- 1.2.0 — 2019-11-20
- 1.1.0 — 2019-11-10
- 1.0.4 — 2019-10-17
- 1.0.3 — 2019-10-17
- 1.0.2 — 2019-08-26
- 1.0.1 — 2019-07-30
- 1.0.0 — 2019-04-30
- 0.0.0 — 2019-03-27

## 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

---
_Source: https://npm.io/package/@lets/run · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._