Instalar

O kit não tem dependências de runtime, não chama a rede e não pede credenciais.

npx (recomendado)

Requer Node.js 20 ou mais novo. Nada fica instalado.

npx -y moretes-builder-workshops doctor

npm

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

Docker

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

Para gravar um experimento na sua pasta:

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

Código-fonte

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

Saída esperada

✓ Node.js >= 20 v22.23.4
✓ Motor do lab offline, sem mutação
✓ Documentos do kit 6
✓ Skill skills/builder-workshops

Não precisa de credenciais. Nada aqui chama a rede.

O que ainda não existe na primeira versão

Se npx ou npm não encontrarem o pacote, ele ainda não foi publicado no npm. Use o pacote do release, que é o mesmo programa:

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

Problemas comuns

Sintoma	O que fazer
SyntaxError ou versão antiga	Confira node --version. Precisa ser 20 ou mais novo
npx pede confirmação	Use -y, como nos exemplos
Docker sem permissão para gravar	Use --user "$(id -u):$(id -g)"
Windows	Use PowerShell ou WSL. Os exemplos com $PWD são de shells Unix