Configuration

$.shell

Specifies what shell is used. Default is which bash.

$.shell = '/usr/bin/bash'

Or use a CLI argument: --shell=/bin/bash

$.spawn

Specifies a spawn api. Defaults to require('child_process').spawn.

To override a sync API implementation, set $.spawnSync correspondingly.

$.prefix

Specifies the command that will be prefixed to all commands run.

Default is set -euo pipefail;.

Or use a CLI argument: --prefix='set -e;'

$.postfix

Like a $.prefix, but for the end of the command.

$.postfix = '; exit $LastExitCode' // for PowerShell compatibility

$.preferLocal

Specifies whether to prefer node_modules/.bin located binaries over globally system installed ones.

$.preferLocal = true

await $`c8 npm test`

You can also specify a directory to search for local binaries:

$.preferLocal = '/some/to/bin'
$.preferLocal = ['/path/to/bin', '/another/path/bin']

$.quote

Specifies a function for escaping special characters during command substitution.

$.verbose

Specifies verbosity. Default is false.

In verbose mode, zx prints all executed commands alongside with their outputs.

Or use the CLI argument: --verbose to set true.

$.quiet

Suppresses all output. Default is false.

Via CLI argument: --quiet sets $.quiet = true.

$.env

Specifies an environment variables map.

Defaults to process.env.

$.cwd

Specifies a current working directory of all processes created with the $.

The cd() func changes only process.cwd() and if no $.cwd specified, all $ processes use process.cwd() by default (same as spawn behavior).

$.log

Specifies a logging function.

import {LogEntry, log} from 'zx/core'

$.log = (entry: LogEntry) => {
  switch (entry.kind) {
    case 'cmd':
      // for example, apply custom data masker for cmd printing
      process.stderr.write(masker(entry.cmd))
      break
    default:
      log(entry)
  }
}