Install

The kit has no runtime dependencies, doesn’t call the network and doesn’t ask for credentials.

npx (recommended)

Requires Node.js 20 or newer. Nothing stays installed.

npx -y moretes-builder-workshops doctor --lang en

npm

npm install -g moretes-builder-workshops
builder-workshops doctor --lang en

Docker

docker run --rm ghcr.io/fernando-moretes/builder-workshops doctor --lang en

To write an experiment to your folder:

docker run --rm -v "$PWD:/work" -w /work --user "$(id -u):$(id -g)" \
  ghcr.io/fernando-moretes/builder-workshops experiment my-experiment --lang en

Source code

git clone https://github.com/fernando-moretes/aws-builder-workshops.git
cd aws-builder-workshops
node bin/cli.mjs doctor --lang en

Expected output

✓ Node.js >= 20 v24.15.0
✓ Lab engine offline, no mutation
✓ Kit documents 6
✓ Skill skills/builder-workshops

No credentials needed. Nothing here calls the network.

What doesn’t exist yet in the first version

If npx or npm can’t find the package, it hasn’t been published to npm yet. Use the release package, which is the same program:

npx -y https://github.com/fernando-moretes/aws-builder-workshops/releases/latest/download/moretes-builder-workshops.tgz doctor --lang en

Common problems

Symptom	What to do
SyntaxError or old version	Check node --version. It must be 20 or newer
npx asks for confirmation	Use -y, as in the examples
Docker can’t write to the folder	Use --user "$(id -u):$(id -g)"
Windows	Use PowerShell or WSL. The examples with $PWD are for Unix shells