Setup

Setup is lane-specific. Use the host bootstrap for the machine you are on, then run the source validation and post-apply smoke checks for that lane.

Entry points

Lane	Bootstrap	Validate
WSL	scripts/install-prereqs-wsl.sh	scripts/smoke-test.sh --source-only
CachyOS	scripts/install-prereqs-cachyos.sh	scripts/smoke-test.sh --source-only
Droplet	just droplet-bootstrap-preview, then just droplet-bootstrap-core	scripts/smoke-test.sh --source-only
Native Windows	.\scripts\bootstrap-windows.ps1	.\scripts\smoke-test-windows.ps1

The default droplet agent/SSH toolset is installed only through the explicit guarded path:

scripts/install-prereqs-droplet.sh --dry-run --codex-tools
scripts/install-prereqs-droplet.sh --codex-tools

After applying dotfiles on a Unix-like host, run:

~/.local/bin/dotfiles-smoke-test --fast

On droplet, --fast stays scoped to core lane tools. Use ~/.local/bin/dotfiles-smoke-test --fast --with-agent-tools --with-codex --with-claude after the optional agent/SSH toolset bootstrap.

Source files

Edit chezmoi source files under home/, not live files in $HOME. dot_foo maps to .foo; executable_foo renders with the executable bit.

Before adding setup automation or a new tool manager responsibility, check the non-goals and anti-patterns policy.