# envimist

> Applies minimist to process.env

Latest version **0.0.7** (published 2026-04-13) · MIT license · 0 weekly downloads

## Install

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

## Health

**Score 65/100 (B)** — status: active.

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

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.0.7 |
| Published | 2026-04-13 |
| First published | 2023-12-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 8.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | Anton Golub |
| Maintainers | antongolub |
| Keywords | env, environment, minimist, argv, cli |

## Links

- npm: https://www.npmjs.com/package/envimist
- Repository: https://github.com/antongolub/misc
- Homepage: https://github.com/antongolub/misc/tree/master/packages/env/envimist
- Issues: https://github.com/antongolub/misc/issues
- npm.io page: https://npm.io/package/envimist

## Dependencies (1)

- [minimist](https://npm.io/package/minimist.md) ^1.2.8

## Alternatives

- [replicas-cli](https://npm.io/package/replicas-cli.md) — 3.0K weekly downloads
- [env-contract](https://npm.io/package/env-contract.md) — 133 weekly downloads
- [@openveo/api](https://npm.io/package/@openveo/api.md) — 61 weekly downloads
- [@ryniaubenpm2/cumque-error-reiciendis](https://npm.io/package/@ryniaubenpm2/cumque-error-reiciendis.md) — 54 weekly downloads
- [ts-global-type-extra](https://npm.io/package/ts-global-type-extra.md) — 11 weekly downloads

## Recent versions

- 0.0.7 (latest) — 2026-04-13
- 0.0.0 (draft) — 2023-12-13
- 0.0.5 — 2026-04-05
- 0.0.4 — 2024-01-03
- 0.0.3 — 2023-12-14
- 0.0.2 — 2023-12-14
- 0.0.1 — 2023-12-14

## README

# envimist
> Applies [minimist](https://github.com/minimistjs/minimist) to process.env

[![lcov](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgithub.com%2Fantongolub%2Fmisc%2Freleases%2Fdownload%2Flcov%2Flcov-sum.json&query=%24.scopes.packages_env_envimist.max&label=lcov&color=brightgreen)](https://github.com/antongolub/misc/releases/download/lcov/lcov.info)
[![npm](https://img.shields.io/npm/v/envimist.svg?&color=white)](https://www.npmjs.com/package/envimist)

## Oh...
* [cross-env](https://www.npmjs.com/package/cross-env) — ok
* [dotenv](https://www.npmjs.com/package/dotenv) — ok
* Where's smth like arvg parser, env-utils?
* ...
* [env](https://www.npmjs.com/package/env)
* [xenv](https://www.npmjs.com/package/xenv)
* [envx](https://www.npmjs.com/package/envx)
* [envar](https://www.npmjs.com/package/envar)
* [envars](https://www.npmjs.com/package/envars)
* [enve](https://www.npmjs.com/package/enve)
* [envex](https://www.npmjs.com/package/envex)
* [env-map](https://www.npmjs.com/package/env-map)
* [env-util](https://www.npmjs.com/package/env-util)
* [env-utils](https://www.npmjs.com/package/env-utils)

## Status
Working draft

## Install
```sh
yarn add envimist
``` 

## Usage
```ts
import envimist from 'envimist'

const envs = envimist()

envs.path   // '/users/username/go/bin:/users/username/.kube:..'
envs.shell  // '/bin/zsh'
envs.user   // 'username'
// ...
```

You can provide some extra options to instruct the parser.
```ts
// Pass env records to parse. Defaults to process.env
const env = {
  FOO: 'false' 
}

// Regular minimist.Opts. Follow its docs for details
// https://github.com/minimistjs/minimist
const opts = {
  boolean: ['foo']
}
const envs = envimist(env, opts)

envs.foo // === false
```

To resolve variables as arrays, set splitting params:
```ts
const env = {
  FOO: 'bar,baz,qux',
  ABC: 'a,b,c',
  PATH: '/some/bin/path:/another/bin/dir'
}
const opts = {
  split: ['foo']
}

// You can also specify a custom separator:
const opts1 = {
  split: [['foo', ':']]
}
// Compbine diff vars with diff separators
const opts2 = {
  split: [['path', ':'], ['foo', 'abc', ',']]
}

envimist(env, opts2)
// {
//   foo: ['bar', 'baz', 'qux'],
//   abc: ['a', 'b', 'c'],
//   path: ['/some/bin/path', '/another/bin/dir'],
//   _: []
// }
```

## License
[MIT](./LICENSE)

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