# google/zx

A tool for writing better scripts

Repository: https://github.com/google/zx
Canonical: https://ross.abutalabs.com/products/zx
Homepage: https://google.github.io/zx/
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: javascript, nodejs, shell, bash, cli, child-process, exec, pipe, spawn
Last push: 2026-08-14T07:30:27+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 53, longevity 100
- inputs: {"age_days": 1946, "days_push": 19, "days_rel": 318, "gap_med": 7.5, "n_releases_24m": 33}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 45704, forks 1288 (observed 2026-08-28T04:12:09.595770+00:00)

## What it is
zx is a JavaScript/Node.js library and CLI for writing shell scripts with template literals that wrap child_process, handling argument escaping and sensible defaults. It lets developers replace complex bash scripts with JavaScript while using the npm ecosystem.

## Use cases
- write shell scripts in javascript
- replace bash scripts with nodejs
- run child processes with escaping
- automate deployment scripts
- run commands in parallel
- cross-platform scripting

## When to choose
- you need complex logic (variables, promises, error handling) beyond what bash handles well
- you want to use npm libraries inside automation scripts
- you need scripts that run on Linux, macOS, and Windows

## When to avoid
- you only need simple one-liner shell commands
- your environment has no Node.js, Bun, or Deno runtime
- you need POSIX-strict shell portability without a JS runtime

## Facets
- artifact type: cli-tool
- maturity: stable
- function: cli, developer-tools, concurrency, file-system
- domain: developer-tools
- platform: cli, cross-platform, windows, bun
- tags: shell-scripting, child-process, script-runner, bash-alternative, javascript, command-line, automation, nodejs, linux, macos, deno

## Member repositories
- google/zx (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:09.595770+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:21:39.000640+00:00, confidence not recorded.
  - readme: https://github.com/google/zx (fetched 2026-08-28T04:12:09.595770+00:00, sha 952b5b10d116)
  - homepage: https://google.github.io/zx/ (fetched 2026-08-29T07:45:17.809650+00:00, sha 064bbe678a8e)
- Data as of 2026-08-30T08:39:29.467469+00:00.