Getting started

Run desired state from PowerShell 7:

git clone https://github.com/norandom/DataWorkStation_Powershell.git "$HOME/Source/PowerShell"
cd "$HOME/Source/PowerShell"
Copy-Item .excluded.sample .excluded
# Edit .excluded for this workstation before applying desired state.
./Apply-Workstation.ps1 -Mode Test
./Apply-Workstation.ps1 -Mode Ensure

Open a new PowerShell session after profile installation. The prompt should show username@host path> and commands such as rg, gh, uv, docker, mem, ports, and tricky should resolve.

Install the repository-local Git hook once after cloning:

precommit-install

Commits then lint staged PowerShell files automatically. Use precommit-run to check the full tracked tree without committing.

Documentation locally

MkDocs is a locked repository dependency, not a global workstation package:

docs-serve
docs-build

The first invocation lets uv create the isolated documentation environment. docs-build uses strict mode and writes the ignored site/ directory.

Verify without changing state

./Apply-Workstation.ps1 -Mode Test
profile-status
firewall-status
defender-status
tricky capabilities

Some Windows state tests require an elevated shell. Capture and debugger commands remain explicit even after Ensure.