zx

#!/usr/bin/env zx

await 
 zx
cat package.json | grep name`

const branch = await 
 zx
git branch --show-current`
await 
 zx
dep deploy --branch=${branch}`

await Promise.all([
  
 zx
sleep 1; echo 1`,
  
 zx
sleep 2; echo 2`,
  
 zx
sleep 3; echo 3`,
])

const name = 'foo bar'
await 
 zx
mkdir /tmp/${name}`

Bash is great, but when it comes to writing more complex scripts, many people prefer a more convenient programming language. JavaScript is a perfect choice, but the Node.js standard library requires additional hassle before using. No compromise, take the best of both. The zx package provides useful cross-platform wrappers around child_process, escapes arguments and gives sensible defaults.

Crow Watch

Join at crow.watch/join/zx

Share great links, cool code, and new tools.

Install

npm install zx

Usage

• Documentation at google.github.io/zx/
• Code examples

Compatibility

• Linux, macOS, or Windows
• JavaScript Runtime:

• Node.js >= 12.17.0

• Bun >= 1.0.0

• Deno 1.x, 2.x

• GraalVM Node.js
• Some kind of bash or PowerShell
• Both CJS or ESM modules in JS or TS

See also

• srf — a tiny, dependency-free static file server for Node.js
• fx — a JSON cli tool and terminal JSON viewer

License

Apache-2.0

Disclaimer: This is not an officially supported Google product.