# @01/launcher

> ```ts import {launch} from '@01/launcher'

Latest version **1.1.2** (published 2026-01-02) · UNLICENSED license · 0 weekly downloads

## Install

```sh
npm install @01/launcher
pnpm add @01/launcher
yarn add @01/launcher
bun add @01/launcher
```

Provides the command `launch`.

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.1.2 |
| Published | 2026-01-02 |
| First published | 2019-07-29 |
| Weekly downloads | 0 |
| License | UNLICENSED |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=8 |
| Dependencies | 4 |
| Unpacked size | 7.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | 01 Alchemist |
| Maintainers | 01 |
| Keywords | process, launcher, spawn |

## Links

- npm: https://www.npmjs.com/package/@01/launcher
- Repository: https://github.com/01alchemist/web-service-lib
- Homepage: https://github.com/01alchemist/web-service-lib#readme
- Issues: https://github.com/01alchemist/web-service-lib/issues
- npm.io page: https://npm.io/package/@01/launcher

## Dependencies (4)

- [chalk](https://npm.io/package/chalk.md) 3.0.0
- [tslib](https://npm.io/package/tslib.md) ^2.6.2
- [dotenv](https://npm.io/package/dotenv.md) ^16.3.1
- [minimist](https://npm.io/package/minimist.md) ^1.2.8

## Recent versions

- 1.1.2 (latest) — 2026-01-02
- 1.1.0 — 2026-01-02
- 1.0.17 — 2026-01-02
- 0.2.3 — 2025-12-29
- 1.0.15 — 2023-10-05
- 1.0.14 — 2020-03-16
- 1.0.13 — 2020-03-16
- 1.0.12 — 2020-03-16
- 1.0.11 — 2019-08-21
- 1.0.10 — 2019-08-21
- 1.0.9 — 2019-08-03
- 1.0.8 — 2019-08-02
- 1.0.7 — 2019-08-01
- 1.0.5 — 2019-07-31
- 1.0.4 — 2019-07-30
- … 4 more at https://npm.io/package/@01/launcher/versions

## README

# Nodejs Process Launcher
## Usage
```ts
import {launch} from '@01/launcher'

await launch({
  cmds:['echo', 'Hello']
})

```

## Options
```ts
type Options = {
  env?: string | string[];
  cmds?: string[];
  cwd?: string;
  mode?: LaunchMode;
  exitProcessOnClose?: boolean;
  silent?: boolean;
} & SpawnOptions;
```
### env
Option to pass custom environment variable to child process.
- `env:'ENV_VAR=value'`
- `env:['ENV1=v1', 'ENV2=v2']`
- `env:'ENV1=v1,ENV2=v2'`
### cmds
Child process cmd with arguments. First element is the program location or name and remaining elements are it's arguments.
```
cmds: ['echo', 'Hello']
```
### cwd
Current working directory. Path is absolute if it's starts with slash `/` otherwise relative.
- `cwd: './relative/path'`
- `cwd: '/absolute/path'`
### mode
Launch mode
- `cli` Exit program on exceptions
- `program` Throw error on exceptions
### exitProcessOnClose
Exit parent node process on close.
### silent
Skip verbose logs

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