# @comet/dev-process-manager

> dev-process-manager is a Node.js process manager for local development environments that need multiple processes. It can be easily integrated into existing Node.js projects.

Latest version **3.2.0** (published 2026-07-28) · BSD-2-Clause license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @comet/dev-process-manager
pnpm add @comet/dev-process-manager
yarn add @comet/dev-process-manager
bun add @comet/dev-process-manager
```

Provides the command `dev-pm`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 3.2.0 |
| Published | 2026-07-28 |
| First published | 2022-05-16 |
| Weekly downloads | 0 |
| License | BSD-2-Clause |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=18 |
| Dependencies | 11 |
| Unpacked size | 112.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 21 |
| Author | Vivid Planet Software GmbH |
| Maintainers | kaufmo, franzel, dkarnutsch, nsams, manuelblum, vividplanet, johnnyomair |

## Links

- npm: https://www.npmjs.com/package/@comet/dev-process-manager
- Repository: https://github.com/vivid-planet/dev-process-manager
- Homepage: https://github.com/vivid-planet/dev-process-manager#readme
- Issues: https://github.com/vivid-planet/dev-process-manager/issues
- npm.io page: https://npm.io/package/@comet/dev-process-manager

## Dependencies (11)

- [colors](https://npm.io/package/colors.md) ^1.4.0
- [dotenv](https://npm.io/package/dotenv.md) ^16.6.1
- [pidtree](https://npm.io/package/pidtree.md) ^0.6.0
- [wait-on](https://npm.io/package/wait-on.md) ^8.0.5
- [pidusage](https://npm.io/package/pidusage.md) ^3.0.2
- [unconfig](https://npm.io/package/unconfig.md) ^7.5.0
- [commander](https://npm.io/package/commander.md) ^12.1.0
- [cli-table3](https://npm.io/package/cli-table3.md) ^0.6.5
- [log-update](https://npm.io/package/log-update.md) ^4.0.0
- [pretty-bytes](https://npm.io/package/pretty-bytes.md) ^5.6.0
- [dotenv-expand](https://npm.io/package/dotenv-expand.md) ^11.0.7

## Recent versions

- 3.2.0 (latest) — 2026-07-28
- 3.2.1-canary-20260728082847 (canary) — 2026-07-28
- 3.2.0-canary-20260728082431 — 2026-07-28
- 3.2.0-canary-20260721103658 — 2026-07-21
- 3.2.0-canary-20260721083707 — 2026-07-21
- 3.2.0-canary-20260721083537 — 2026-07-21
- 3.2.0-canary-20260602054930 — 2026-06-02
- 3.2.0-canary-20260602054805 — 2026-06-02
- 3.2.0-canary-20260601064758 — 2026-06-01
- 3.2.0-canary-20260518112010 — 2026-05-18
- 3.2.0-canary-20260511091839 — 2026-05-11
- 3.2.0-canary-20260511091814 — 2026-05-11
- 3.2.0-canary-20260511090834 — 2026-05-11
- 3.2.0-canary-20260511065205 — 2026-05-11
- 3.2.0-canary-20260414064339 — 2026-04-14
- … 158 more at https://npm.io/package/@comet/dev-process-manager/versions

## README

# @comet/dev-process-manager

dev-process-manager is a Node.js process manager for local development environments that need multiple processes. It can be easily integrated into existing Node.js projects.

## Installation

```console
$ npm install @comet/dev-process-manager
```

Recommended Alias:
```console
alias dpm="npm exec -- dev-pm"
```


## Usage

Add `dev-pm.config.ts` file to the project root.
This file defines all available scripts, which should be started by dev-process-manager.

### dev-pm.config.ts

```typescript
import { defineConfig } from '@comet/dev-process-manager';

export default defineConfig({
    scripts: [
        {
             name: "api",
             script: "npm run start",
             alias: "backend", //to access the script using an alternative name in all commands
             group: ["foo", "bar"], //to access a group of scripts in all commands using @groupname
             waitOn: [
                "packages/foo/lib/index.d.ts", //wait until package is built
                "tcp:5432"  //wait until database is started (tcp:$POSTGRESQL_PORT is also supported)
             ]
        },
        ...
    ],
});

```

(Other supported file types are 'ts', 'mts', 'cts', 'js', 'mjs', 'cjs' and 'json')

## Environment Variables

dev-process-manager loads environment variables from the following files in the project root, in order:

1. `.env` — shared defaults, typically committed to version control
2. `.env.local` — local overrides, typically added to `.gitignore`

Values defined in `.env.local` take precedence over those in `.env`. Variable expansion (e.g. `$OTHER_VAR`) is supported in both files.

These variables are only used for substitution within `waitOn` resources (e.g. `tcp:$POSTGRESQL_PORT`). They are **not** passed to the script processes — scripts inherit the daemon's environment.

## Commands

### Start

Start one or all processes. The script-name argument can also be multiple names, an alias, "all" or a @group.

```console
$ npx dev-pm start [options] [script-name, alias or @group]
```

Options:
`--follow` Follow logs after starting script (script will not be stopped when stopping this process)

### Stop

Stop running processes

```console
$ npx dev-pm stop [script-name, alias or @group]
```

### Restart

Restart a previously started processes

```console
$ npx dev-pm restart [options] [script-name, alias or @group]
```

Options:
`--follow` Follow logs after starting script (script will not be stopped when stopping this process)

### Status

Lists running processes

```console
$ npx dev-pm status [options] [script-name, alias or @group]
```

Options:
`--interval [seconds]` Keep status open and refresh periodically at specified interval

### Logs

Prints logs of either a specific process or all running processes in real time.

```console
$ npx dev-pm logs [script-name, alias or @group]
```
Options:
`-n [lines]` print n log lines and exit.

### Start Daemon

Starts the dev-pm daemon, usually done automatically by other commands.

```console
$ npx dev-pm start-daemon
```

### Shutdown

Stop all running processes and shutdown dev-pm

```console
$ npx dev-pm shutdown
```

## Development

Use in existing project with

```
npx ts-node ~/ws/dev-process-manager/src/index.ts
```

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