This is a macOS adaptation of the Windows/WSL2 procedure in README-windows.md. The original files are unchanged apart from that rename. Only these were added:

README.md                        this file (the original is now README-windows.md)
docs/09-macos-apple-silicon.md   full procedure, risks, troubleshooting
scripts/macos/setup-host.sh      installs QEMU, downloads and verifies the Ubuntu ISO
scripts/macos/vm.sh              create, install, start, stop, ssh, push
scripts/macos/find-jetson.sh     shows whether the Mac sees the board in recovery mode

Why a VM

NVIDIA's L4T R32.7.5 flash tools are x86_64 Linux binaries and cannot run on macOS. The port boots an x86_64 Ubuntu 22.04 VM in QEMU, forwards any NVIDIA USB device (0955:*) into it, and runs the existing scripts/wsl/ scripts there unchanged.

Status

Untested on hardware. The original procedure was also never flashed end to end. On Apple Silicon the VM emulates x86, so builds are slow. On Intel Macs it uses hardware virtualization. Read docs/09-macos-apple-silicon.md before starting.

Fast path

bash scripts/macos/setup-host.sh
bash scripts/macos/vm.sh create
bash scripts/macos/vm.sh install        # enable OpenSSH server
export JETSON_VM_USER=<your VM username>
bash scripts/macos/vm.sh start
bash scripts/macos/vm.sh push
bash scripts/macos/vm.sh ssh
# inside the VM, follow steps 2 to 7 of README-windows.md, skipping the PowerShell parts

Same standard-TX2-only warning applies: do not use this profile for TX2i or TX2 4GB modules.