# batchrun

> Run and manage multiple processes concurrently in one terminal

Latest version **1.0.7** (published 2023-08-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install batchrun
pnpm add batchrun
yarn add batchrun
bun add batchrun
```

Provides the commands `batchrun`, `batch-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.0.7 |
| Published | 2023-08-25 |
| First published | 2023-08-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 12.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Benjamin Toby |
| Maintainers | tben |
| Keywords | process, batch, autoreload, terminal, cli, server, monitor |

## Links

- npm: https://www.npmjs.com/package/batchrun
- Repository: https://github.com/BenjaminToby/batch-run
- Homepage: https://github.com/BenjaminToby/batch-run#readme
- Issues: https://github.com/BenjaminToby/batch-run/issues
- npm.io page: https://npm.io/package/batchrun

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.0.7 (latest) — 2023-08-25
- 1.0.6 — 2023-08-20
- 1.0.5 — 2023-08-17

## README

# Run multiple concurrent processes

Do you run an application that needs multiple processes? Like `npm run dev` and `npm run tailwind`. Typically in a dev environment you would need to have more than one terminal open if you're running more than on processes. But with batch run you only need one terminal to run all processes concurrently.

## Installation

You can install and run this package directly by running:

```bash
npx batchrun "npm run dev, npm run tailwind"
```

To install this module globally simply run:

```bash
npm install -g batchrun
```

To install this module locally(for just the project) run:

```bash
npm install batchrun
```

_NOTE_: You will have to append `npx` to your command for just a local installation.

## Requirements

For this package to work you need an argument of strings in the terminal command, or a `batchrun.config.json` file at the root of your project directory, which is simply an array of strings, each string being the command to run. Example:

```json
["node index.js", "npm run tailwind"]
```

More entries mean more processes.

# Usage

To fire up the process without a `batchrun.config.json` file simply run:

```bash
batchrun "npm run dev, npm run tailwind"
```

If you did not install the package globally, run:

```bash
npx batchrun "npm run dev, npm run tailwind"
```

If you already have a `batchrun.config.json` file just run

```bash
batchrun
```

# Process actions

When your process is up and running, you can perform a few more actions to your running processes.

### Reload all processes

To reload all processes, while the process is active in your terminal type

```bash
reload
```

Press `Enter` after tyring this. This will reload all the processes you started. Alternatively, you can simply press `Ctrl+R`: this does the same thing. `restart` amd `reboot` commands work also.

### Reload processes

You can also target a single process and reload it. This will need an index appended to the `reload` command. Example:

```bash
- Processes Started ...
...
reload 0
```

This will reload the first command in your list of commands. You can add more indexes by separating them with a comma(,): Example:

```bash
- Processes Started ...
...
reload 0,3,4
```

_NOTE_: Do not add a space between the commands or else the `reload` command won't work.

### Kill processes

To kill all processes simply type:

```bash
- Processes Started ...
...
kill
```

This is the equivalent of pressing `Ctrl+C`. To kill specific processes just follow the same convention as the `reload` command. Example:

```bash
- Processes Started ...
...
kill 1,2
```

To restart a killed process simple use the `reload` command again.

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