A simple way to run command-line programs from gulp in a cross-platform way.
Last updated 8 months ago by klathmon .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install gulp-run-command 
SYNC missed versions from official npm registry.



A simple way to run command-line programs from gulp in a cross-platform way.


npm install gulp-run-command


import gulp from 'gulp'
import run from 'gulp-run-command' // or `var run = require('gulp-run-command').default` for ES5

gulp.task('clean', run('rm -rf build'))
gulp.task('build', ['clean'], run('babel index.js --out-file index.es5.js', {
  env: { NODE_ENV: 'production' }


run(command, options)


type: Array or String

A command will be run "as if you typed it in the console". An array of commands will be run sequentially (waiting for each to finish before the next begins), stdin will be blank for all commands. Commands will be run like they are from npm scripts, locally installed modules can be run without having to prefix node_modules/.bin.


type: Boolean
default: false

Setting to true will ignore all output from the command (both stdout and stderr)


type: Boolean
default: false

Setting to true will ignore any errors that the command throws. It will also ignore return values.


type: String
default: process.cwd()

Sets the current working directory for the command. This is where the node_modules/.bin is searched for as well to be added to the path.


type: Number
default: undefined (no timeout)

The max time (in milliseconds) that the command is allowed to run


type: Object
default: {}

This object will be added to the normal environment, overwriting defaults with what you pass in. So if your "main" environment includes NODE_ENV="development" and you pass in { NODE_ENV: 'production'} the command will be run with NODE_ENV="production".


I loved Gulp's dependency management and plugin ecosystem, but I hated having to use file streams or plugins which wrap my tools which are often out of date, buggy, or missing functionality. This plugin lets you define gulp tasks as command line commands which will be run. Most tools have a command line interface, so you are cutting out several unnecessary layers and giving yourself more flexibility.

What not just use gulp-shell?
gulp-shell is great, but sadly it uses child_process.exec. That means that output from the plugin is buffered and only output in chunks. This causes issues with command line applications that are expecting direct access to the console. (it also has a tendency to strip colors from the output). This uses child_process.spawn which is more difficult to use, but works much better.

Can you add this new feature?
Maybe... I'm trying to keep this a small single-purpose plugin, but if you want a feature feel free to open an issue and I'll take a look.

Gulp@4 support
In order to use gulp-run-command with Gulp@4, you need to call the return function after passing the command and options (formally known as currying). For example:

gulp.task('clean', async () => run('echo "Hello World!"')());


  • gulp-shell came up with the idea, I just changed it's underlying implementation.


The code is written in ES6 using Javascript Standard Style. Feel free to make PRs adding features you want, but please try to follow Standard. Also, codumentation/readme PRs are more then welcome!


MIT Copyright (c) Gregory Benner

Current Tags

  • 0.0.8-beta.4                                ...           beta (3 years ago)
  • 0.0.10                                ...           latest (8 months ago)

9 Versions

  • 0.0.10                                ...           8 months ago
  • 0.0.9                                ...           3 years ago
  • 0.0.8-beta.4                                ...           3 years ago
  • 0.0.8-beta.3                                ...           3 years ago
  • 0.0.8-beta.2                                ...           3 years ago
  • 0.0.7                                ...           4 years ago
  • 0.0.6                                ...           4 years ago
  • 0.0.5                                ...           4 years ago
  • 0.0.2                                ...           4 years ago
Maintainers (1)
Today 8
This Week 50
This Month 86
Last Day 9
Last Week 150
Last Month 413
Dependencies (4)
Dev Dependencies (6)

Copyright 2014 - 2016 © |