NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #1931 most downloaded on npm
Run scripts that set and use environment variables across platforms
Last release 1 years ago
29 Sep 2025
Ships unpredictably
gaps range from 2 weeks to 4.6 years
Nearly every release is documented
notes for 45 of 47 stable releases
1 version withdrawn
withdrawn after publishing
11 years old
50 releases · first in 2015
add support for default value syntax
For example:
"dev:server": "cross-env wrangler dev --port ${PORT:-8787}",If PORT is already set, use that value, otherwise fallback to 8787.
Learn more about Shell Parameter Expansion
TL;DR: You should probably not have to change anything if:
TL;DR: You should probably not have to change anything if:
In this release (which should have been v8 except I had some issues with automated releases 🙈), I've updated all the things and modernized the package. This happened in #261
Was this needed? Not really, but I just thought it'd be fun to modernize this package.
Here's the highlights of what was done.
The tool maintains its original functionality while being completely modernized with the latest tooling and best practices
One column per quarter.
7.0.3 (2020-12-01) Bug Fixes add maintenance mode notice
Revert "fix: signal handling ( #227 )" ( 2a1f44c ), closes #227
7.0.1 (2020-03-03) Bug Fixes signal handling
7.0.0 (2020-01-25) Features update dependencies ( #223 ) ( 4ec6f40 ) BREAKING CHANGES Drop Node 8 support
## 6.0.3 (2019-10-02) ### Bug Fixes * do not compile anything
## 6.0.2 (2019-10-01) ### Bug Fixes * table of contents in README
update all packages, tests, and README
bumped cross-spawn to version 7.0.0
## 5.2.1 (2019-08-31) ### Bug Fixes * remove is-windows dependency
# 5.2.0 (2018-06-13) ### Features * deps: upgrade cross-spawn
check for sigint before setting exit code to 1
exit code should be set to 1 when os kills child process (#177) (d5170bf), closes #150
## 5.1.4 (2018-03-09) ### Bug Fixes * allow backslash
handle escaping and single quotes
remove env variables that don't exist from the converted commands in Windows.
# 5.1.0 (2017-10-16) ### Features * introduce dollar sign escaping
docs: add malware warning to README
Don't pass fn reference(commandConvert) to commandArgs.map
<a name"5.0.4"></a>
commandConvert) to commandArgs.map (#135) (c03ec7a2)Normalize command only and not command args(windows)
<a name"5.0.3"></a>
Handle relative path in cmd on windows (#130) (487241db, closes #127)
Change splitter regex to use .* instead of .+ (#117) (b10de512, closes #114, #116)
bin: add a bin entry for cross-env-shell
<a name="5.0.0"></a>
Closes #99.
(d7b48d5c)
Nothing published for this version
BREAKING CHANGE: You now must escape : to use it in a value of you don't want it to be swapped with ; on Windows
<a name="4.0.0"></a>
FOO=$BAR with the value $BAR being assigned to hello, the command will be converted to FOO=hello whereas before it was FOO=$BAR).
(e8a16146)#80
chore: Add myself (DanReyLop) to the contributors list
Simplified logic. Now only : (UNIX-style) are converted to ; (Windows-style), not the other way around
BREAKING CHANGE: You now must escape : to use it in a value of you don't want it to be swapped with ; on Windows
(ea0ac4bd)
Nothing published for this version
args: make args conversion stateless
<a name"3.2.4"></a>
### 3.2.3 (2017-03-04) #### Bug Fixes * bin: babelify bin
### 3.2.2 (2017-03-04) #### Bug Fixes * bin require
### 3.2.1 (2017-03-04) #### Bug Fixes * bin location
revamp: revamp the entire lib (backward compatible)
<a name"3.2.0"></a>
Enforce minimum Node.js version requirement using 'engines' attribute package.js
<a name"3.1.4"></a>
main: update main to transpiled version
<a name"3.1.3"></a>
kill: Add all kill signals - Adds the 4 main kill signals that NodeJS handles - Add te
<a name"3.1.2"></a>
### 3.1.1 (2016-10-04) #### Bug Fixes - build: build all of src
## 3.1.0 (2016-10-04) #### Features - vars: Convert environment vars
deps: Swap lodash.assign for Object.assign. (#29) (f2275d53, closes #28)
defaults: macOS env.APPDATA should be undefined
<a name"2.0.1"></a>
kill: Propagate SIGTERM to created process
Nothing published for this version
Merge with original environment instead of defining a new one
<a name"1.0.7"></a>
lib: Handle special characters and quoted strings
<a name"1.0.6"></a>
env: Merge with original environment instead of defining a new one
<a name"1.0.5"></a>
Removing if clause for windows detection, applying APPDATA to all platforms.
package: Use different, more up to date dependencies
<a name"1.0.3"></a>
spawn: use cross-spawn for spawn compatibility (3c21e496, closes #2)
### 1.0.1 (2015-10-01) #### Bug Fixes - deps: Add publish-latest (b03e7e3d) #### Features - lib: Initial commit! ✨
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →