node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



script-file maps a npm-script to the exports of a .js file.


npm install script-file


Create a file scripts/foo.js in your project root

const main = (params) => console.log(`hello ${}`); // Read command line arguments
const foo = 'ls -al'; // A string runs a simple command
const bar = [
    'python -m SimpleHTTPServer',
]; // An array of string runs on command after another
module.exports = { main, foo, bar };

Add the following to your package.json:

    "scripts": {
        "foo": "script-file --name=script-file",
        "foo:foo": "script-file",
        "foo:bar": "script-file",
        "bar:foo": "script-file-alias foo:bar"

run your scripts, npm run foo, npm run foo:foo, npm run foo:bar, npm run bar:foo

Parameter Usage

Arguments passed to script file are processed by the yargs package. Check the documentation for details on how you can specify the arguments.


script-file comes with some build-in utils, which make working with external commands easy.


Run all passed scripts in parallel.

const {parallel} = require('script-file');
const main = parallel(
    'python -m SimpleHTTPServer'
module.exports = { main };

env(string|object) : function

Returns a function which sets environment variables. If you pass in a string it will be set as process.env.NODE_ENV. If you pass an object it takes the key as environment variable and assigns the corresponding value to it.

const main = 'webpack';
const production = [
const staging = [
    env({NODE_ENV: 'production', HOST: ''}),
module.exports = { main, production, staging };

spawn(cmd, [options]) : Promise

A slightly more advanced version of child_process.spawn which returns a promise when the process exits. You can optionally pass an options object to wait until the command line prints out a specified string. E.g. {resolve: 'Server is running'}

const {spawn} = require('script-file');
const webdriverio = require('webdriverio');
const options = {
    desiredCapabilities: {
        browserName: 'safari',
        marionette: 'true',
const browser = webdriverio.remote(options);
const SELENIUM_STARTED_SIGNIFIER = '35bf4d76-394c-4a0d-b31f-9a2ee2d51bf6';
const captureScreenshot = () => browser.init()
const main = () => spawn('node dev-server.js', { resolve: 'server-running' })
    .then(() => spawn(`webdriver-manager --started-signifier=${SELENIUM_STARTED_SIGNIFIER}`, {resolve: SELENIUM_STARTED_SIGNIFIER, reject: 'run webdriver-manager update'}))
    .then(() => captureScreenshot());
module.exports = { main };

killAll() : Promise

Kills all subprocess which have been spawned. This is useful when you want to quit all running processes on a remote after you executed some commands.

const {spawn, killAll} = require('script-file');
const main () => spawn('node -e "let i = 0; setInterval(() => console.log(i++), 10);"', { resolve: '0' })
    .then(() => killall());
module.exports = { main };