free-live-dev
Installation
SKILL.md
free-live-dev
preflight → provision → credentials → feature/* → local QA loop → PR → CI → preview URL → release
bash blocks are POSIX (Git Bash on Windows). Any logic beyond one command/pipe lives in resources/*.js, never in shell control flow. If your Bash tool is cmd.exe or PowerShell, translate each snippet before running it.
1. Preflight (run silently, before planning)
| Check | Probe | On fail |
|---|---|---|
| git, gh | command -v git, command -v gh, gh auth status |
run scripts/install-git-gh-macos.command | scripts/install-git-gh-windows.ps1. Never improvise install steps. |
| node | node --version ≥ scripts/toolchain/catalog.json:node_lts_major |
scripts/course-toolchain-macos.command base | scripts/course-toolchain-windows.ps1 -Profile base |
| vercel, firebase | npx vercel whoami, npx firebase login:list |
npm install -D vercel firebase-tools (never -g: EACCES). Login must pass before §2. |
| gitleaks | command -v gitleaks |
install per table below, re-probe, never skip the §4 scan gate |
| OS | Install | Fallback |
|---|---|---|
| macOS | brew install gitleaks — brew may NOT exist (course installer uses Xcode CLT + curl, not brew) |
curl latest release gitleaks_*_darwin_$(uname -m).tar.gz → extract to ~/.local/bin (mkdir + append to shell profile if absent). No sudo, no /usr/local/bin. |
| Windows | winget install gitleaks.gitleaks |
download gitleaks_*_windows_x64.zip → extract gitleaks.exe → %USERPROFILE%\bin → setx PATH "%PATH%;%USERPROFILE%\bin". ~/.local/bin and shell profiles do not apply here. |