8 files changed, 521 insertions, 3 deletions

diff --git a/bootstrap-win/neovim-dict.ps1 b/bootstrap-win/neovim-dict.ps1
new file mode 100644
index 0000000..5aeb117
--- /dev/null
+++ b/bootstrap-win/neovim-dict.ps1
@@ -0,0 +1,58 @@
+#Requires -Version 5.1
+<#
+  Windows-natives Pendant zu bootstrap/neovim-dict.sh.
+  Laedt die deutschen Rechtschreib-Woerterbuecher fuer Neovim herunter.
+
+  Aufruf:
+    .\bootstrap-win\neovim-dict.ps1
+#>
+
+$ErrorActionPreference = "Stop"
+
+function Write-Ok($msg) {
+  Write-Host "OK   $msg" -ForegroundColor Green
+}
+
+function Write-Step($msg) {
+  Write-Host "==> $msg" -ForegroundColor Cyan
+}
+
+function Write-SkipMsg($msg) {
+  Write-Host "-    $msg bereits vorhanden" -ForegroundColor DarkGray
+}
+
+$SpellDir = Join-Path $env:LOCALAPPDATA "nvim-data\site\spell"
+
+$Urls = @(
+  "https://ftp.nluug.nl/pub/vim/runtime/spell/de.utf-8.spl",
+  "https://ftp.nluug.nl/pub/vim/runtime/spell/de.utf-8.sug"
+)
+
+function Get-SpellFile([string]$Url) {
+  $fileName = Split-Path -Leaf $Url
+  $dest = Join-Path $SpellDir $fileName
+
+  if (Test-Path $dest) {
+    Write-SkipMsg $fileName
+    return
+  }
+
+  Write-Step "Lade $fileName herunter"
+  Invoke-WebRequest -Uri $Url -OutFile $dest
+  Write-Ok $fileName
+}
+
+function Main {
+  if (-not (Test-Path $SpellDir)) {
+    New-Item -ItemType Directory -Path $SpellDir -Force | Out-Null
+  }
+
+  foreach ($url in $Urls) {
+    Get-SpellFile $url
+  }
+
+  Write-Host ""
+  Write-Host "Woerterbuecher fuer Neovim installiert!" -ForegroundColor Green
+}
+
+Main
diff --git a/bootstrap-win/neovim.ps1 b/bootstrap-win/neovim.ps1
new file mode 100644
index 0000000..32e2db7
--- /dev/null
+++ b/bootstrap-win/neovim.ps1
@@ -0,0 +1,199 @@
+#Requires -Version 5.1
+<#
+  Windows-natives Pendant zu bootstrap/neovim.sh - nutzt winget/npm statt
+  brew/pkg, daher eigenstaendiges Skript ohne Git-Bash-/WSL-Abhaengigkeit.
+
+  Aufruf (keine Admin-Rechte noetig):
+    .\bootstrap-win\neovim.ps1
+
+  yamlfmt, gawk und xmllint sind bewusst nicht enthalten (siehe
+  neovim-windows-setup.md). Fehlgeschlagene Installationen werden als
+  Warnung gemeldet, das Skript bricht nicht ab.
+#>
+
+$ErrorActionPreference = "Stop"
+$script:Failures = @()
+
+function Write-Ok($msg) {
+  Write-Host "OK   $msg" -ForegroundColor Green
+}
+
+function Write-Step($msg) {
+  Write-Host "==> $msg" -ForegroundColor Cyan
+}
+
+function Write-Skip($msg) {
+  Write-Host "-    $msg bereits vorhanden" -ForegroundColor DarkGray
+}
+
+function Write-Warn($msg) {
+  Write-Host "!    $msg" -ForegroundColor Yellow
+  $script:Failures += $msg
+}
+
+function Test-CommandExists([string]$Name) {
+  return [bool](Get-Command $Name -ErrorAction SilentlyContinue)
+}
+
+function Find-BinaryDirectory([string]$Binary) {
+  # Deckt den Fall ab, dass winget (v.a. --silent) korrekt installiert,
+  # aber die PATH-Registrierung ausgelassen hat (beobachtet bei LLVM.LLVM).
+  $searchRoots = @(
+    $env:ProgramFiles,
+    ${env:ProgramFiles(x86)},
+    (Join-Path $env:LOCALAPPDATA "Programs")
+  ) | Where-Object { $_ -and (Test-Path $_) }
+
+  foreach ($root in $searchRoots) {
+    $found = Get-ChildItem -Path $root -Recurse -Depth 4 -Filter "$Binary.exe" -File -ErrorAction SilentlyContinue | Select-Object -First 1
+    if ($found) {
+      return $found.DirectoryName
+    }
+  }
+
+  return $null
+}
+
+function Add-ToUserPath([string]$Dir) {
+  $userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+  $entries = $userPath -split ";"
+
+  if ($entries -contains $Dir) {
+    return $false
+  }
+
+  [Environment]::SetEnvironmentVariable("PATH", "$userPath;$Dir", "User")
+  $env:PATH = "$env:PATH;$Dir"
+  return $true
+}
+
+function Install-WingetPackage([string]$Binary, [string]$Id) {
+  if (Test-CommandExists $Binary) {
+    Write-Skip $Binary
+    return
+  }
+
+  Write-Step "winget install $Id"
+  $output = winget install --id $Id -e --source winget --accept-package-agreements --accept-source-agreements --silent 2>&1
+
+  if ($LASTEXITCODE -ne 0) {
+    $text = $output -join " "
+    $lastLine = ($output | Select-Object -Last 3) -join " / "
+
+    if ($text -match "bereits ein vorhandenes Paket|already installed|No applicable update") {
+      # Installiert, aber nicht im PATH - Binary suchen und PATH ergaenzen.
+      $dir = Find-BinaryDirectory $Binary
+
+      if ($dir) {
+        Add-ToUserPath $dir | Out-Null
+        if (Test-CommandExists $Binary) {
+          Write-Ok "$Id ('$Binary' in $dir gefunden, User-PATH ergaenzt)"
+        } else {
+          Write-Warn "${Id}: $dir zum User-PATH hinzugefuegt, aber '$Binary' laesst sich immer noch nicht ausfuehren - manuell pruefen."
+        }
+      } else {
+        Write-Warn "$Id ist laut winget bereits installiert, aber '$Binary' wurde nicht gefunden und konnte auch nicht automatisch lokalisiert werden (durchsucht: Program Files, Program Files (x86), $env:LOCALAPPDATA\Programs). Installationsordner manuell suchen und zum PATH hinzufuegen."
+      }
+    } else {
+      Write-Warn "winget install $Id fehlgeschlagen (Binary '$Binary' nicht gefunden): $lastLine -- Pruefen mit: winget search $Id"
+    }
+    return
+  }
+
+  Write-Ok $Id
+}
+
+function Install-NpmPackage([string]$Binary, [string]$Package) {
+  if (Test-CommandExists $Binary) {
+    Write-Skip $Binary
+    return
+  }
+
+  if (-not (Test-CommandExists "npm")) {
+    Write-Warn "npm wurde nicht gefunden - kann '$Package' nicht installieren."
+    return
+  }
+
+  Write-Step "npm install -g $Package"
+  npm install -g $Package | Out-Null
+
+  if ($LASTEXITCODE -ne 0) {
+    Write-Warn "npm install -g $Package fehlgeschlagen."
+    return
+  }
+
+  Write-Ok $Package
+}
+
+function Test-Prerequisites {
+  if (-not (Test-CommandExists "winget")) {
+    Write-Host "Fehler: winget wurde nicht gefunden. 'App Installer' aus dem Microsoft Store installieren." -ForegroundColor Red
+    exit 1
+  }
+}
+
+function Update-SessionPath {
+  # Registry-PATH-Aenderungen durch winget/npm wirken erst nach diesem Refresh.
+  $machine = [Environment]::GetEnvironmentVariable("PATH", "Machine")
+  $user = [Environment]::GetEnvironmentVariable("PATH", "User")
+  $env:PATH = "$machine;$user"
+}
+
+function Install-Prerequisites {
+  Install-WingetPackage -Binary "git" -Id "Git.Git"
+  Install-WingetPackage -Binary "node" -Id "OpenJS.NodeJS.LTS"
+  Update-SessionPath
+}
+
+function Install-Formatters {
+  Install-WingetPackage -Binary "jq" -Id "jqlang.jq"
+  Install-NpmPackage -Binary "prettier" -Package "prettier"
+  Install-WingetPackage -Binary "ruff" -Id "astral-sh.ruff"
+  Install-WingetPackage -Binary "shfmt" -Id "mvdan.shfmt"
+  Install-WingetPackage -Binary "stylua" -Id "JohnnyMorganz.StyLua"
+
+  # yamlfmt, gawk, xmllint: kein winget-Paket gefunden, siehe neovim-windows-setup.md.
+}
+
+function Install-Tools {
+  Install-WingetPackage -Binary "rg" -Id "BurntSushi.ripgrep.MSVC"
+  Install-WingetPackage -Binary "fd" -Id "sharkdp.fd"
+  Install-NpmPackage -Binary "tree-sitter" -Package "tree-sitter-cli"
+
+  # MSVC (cl.exe) ist bereits vorhanden, kein winget-Paket noetig - Neovim
+  # dafuer aber aus einer "Developer PowerShell for VS" starten.
+  Install-WingetPackage -Binary "make" -Id "ezwinports.make"
+}
+
+function Install-Lsp {
+  Install-NpmPackage -Binary "basedpyright-langserver" -Package "basedpyright"
+  Install-NpmPackage -Binary "bash-language-server" -Package "bash-language-server"
+  Install-WingetPackage -Binary "clangd" -Id "LLVM.LLVM"
+  Install-WingetPackage -Binary "shellcheck" -Id "koalaman.shellcheck"
+  Install-NpmPackage -Binary "vscode-html-language-server" -Package "vscode-langservers-extracted"
+  Install-NpmPackage -Binary "vscode-json-language-server" -Package "vscode-langservers-extracted"
+  Install-WingetPackage -Binary "lua-language-server" -Id "LuaLS.lua-language-server"
+  Install-NpmPackage -Binary "prisma-language-server" -Package "@prisma/language-server"
+  Install-NpmPackage -Binary "vtsls" -Package "@vtsls/language-server"
+}
+
+function Main {
+  Test-Prerequisites
+
+  Install-Prerequisites
+  Install-Formatters
+  Install-Tools
+  Install-Lsp
+
+  Write-Host ""
+  if ($script:Failures.Count -eq 0) {
+    Write-Host "Bootstrap abgeschlossen." -ForegroundColor Green
+  } else {
+    Write-Host "Bootstrap abgeschlossen, mit $($script:Failures.Count) Warnung(en):" -ForegroundColor Yellow
+    foreach ($f in $script:Failures) {
+      Write-Host "  - $f" -ForegroundColor Yellow
+    }
+  }
+}
+
+Main
diff --git a/install-win.ps1 b/install-win.ps1
new file mode 100644
index 0000000..aa77243
--- /dev/null
+++ b/install-win.ps1
@@ -0,0 +1,113 @@
+#Requires -Version 5.1
+<#
+  Windows-natives Pendant zu install.sh - kopiert (statt zu verlinken) die
+  relevanten Konfigurationen an ihre nativen Windows-Zielorte. Keine
+  Admin-Rechte noetig (keine Symlinks).
+
+  Aufruf:
+    .\install-win.ps1
+#>
+
+$ErrorActionPreference = "Stop"
+
+function Write-Ok($msg) {
+  Write-Host "OK   $msg" -ForegroundColor Green
+}
+
+function Write-Step($msg) {
+  Write-Host "==> $msg" -ForegroundColor Cyan
+}
+
+function Write-SkipMsg($msg) {
+  Write-Host "-    $msg" -ForegroundColor DarkGray
+}
+
+$RepoRoot = $PSScriptRoot
+
+$NvimSrc = Join-Path $RepoRoot "nvim"
+$NvimDst = Join-Path $env:LOCALAPPDATA "nvim"
+
+$GitConfigSrc = Join-Path $RepoRoot "git\config"
+$GitConfigDst = Join-Path $env:USERPROFILE ".gitconfig"
+
+$GitUp2partsSrc = Join-Path $RepoRoot "git\config-up2parts"
+$GitXdgDir = Join-Path $env:USERPROFILE ".config\git"
+$GitUp2partsDst = Join-Path $GitXdgDir "config-up2parts"
+
+$NpmrcSrc = Join-Path $RepoRoot "npm\npmrc"
+$NpmrcDst = Join-Path $env:USERPROFILE ".npmrc"
+
+function Copy-NvimConfig {
+  Write-Step "nvim -> $NvimDst"
+
+  if (Test-Path $NvimDst) {
+    Remove-Item -Recurse -Force $NvimDst
+  }
+
+  Copy-Item -Recurse -Force $NvimSrc $NvimDst
+  Write-Ok $NvimDst
+}
+
+function Copy-GitConfig {
+  Write-Step "git\config -> $GitConfigDst"
+  Copy-Item -Force $GitConfigSrc $GitConfigDst
+  Write-Ok $GitConfigDst
+
+  if (-not (Test-Path $GitXdgDir)) {
+    New-Item -ItemType Directory -Path $GitXdgDir -Force | Out-Null
+  }
+
+  Write-Step "git\config-up2parts -> $GitUp2partsDst"
+  Copy-Item -Force $GitUp2partsSrc $GitUp2partsDst
+  Write-Ok "$GitUp2partsDst (wird per includeIf aus .gitconfig eingebunden)"
+}
+
+function Copy-Npmrc {
+  if (Test-Path $NpmrcDst) {
+    Write-SkipMsg "$NpmrcDst existiert bereits, uebersprungen"
+    return
+  }
+
+  # HOME ist unter Windows i.d.R. nicht gesetzt, ${HOME} in npm/npmrc wuerde
+  # nicht expandieren - Zeile daher auskommentieren statt zweite npmrc-Datei
+  # zu pflegen.
+  Write-Step "npm\npmrc -> $NpmrcDst (prefix-Zeile auskommentiert)"
+  $lines = Get-Content -Path $NpmrcSrc | ForEach-Object {
+    if ($_ -match "^\s*prefix\s*=") {
+      "; $_ (unter Windows auskommentiert)"
+    } else {
+      $_
+    }
+  }
+  Set-Content -Path $NpmrcDst -Value $lines
+  Write-Ok $NpmrcDst
+}
+
+function Add-BinToUserPath {
+  $binDir = Join-Path $RepoRoot "windows\bin"
+  $userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+  $entries = $userPath -split ";"
+
+  if ($entries -contains $binDir) {
+    Write-SkipMsg "$binDir bereits im User-PATH"
+    return
+  }
+
+  Write-Step "$binDir zum User-PATH hinzufuegen (enthaelt gmake.cmd)"
+  [Environment]::SetEnvironmentVariable("PATH", "$userPath;$binDir", "User")
+  Write-Ok "$binDir (wirkt erst in neuen Terminal-Sitzungen)"
+}
+
+function Main {
+  Copy-NvimConfig
+  Copy-GitConfig
+  Copy-Npmrc
+  Add-BinToUserPath
+
+  Write-Host ""
+  Write-Host "Fertig. Dateien wurden KOPIERT, nicht verlinkt." -ForegroundColor Green
+  Write-Host "Nach Aenderungen im Repo dieses Skript erneut ausfuehren."
+  Write-Host "Neues Terminal oeffnen, damit PATH-Aenderungen wirksam werden." -ForegroundColor Yellow
+}
+
+Main
diff --git a/neovim-windows-setup.md b/neovim-windows-setup.md
new file mode 100644
index 0000000..c925f59
--- /dev/null
+++ b/neovim-windows-setup.md
@@ -0,0 +1,113 @@
+# Neovim-Setup unter Windows (nativ)
+
+Checkliste für die Übernahme der bestehenden `nvim/`-Config aus dem Dotfiles-Repo auf ein natives Windows-System (kein WSL). Repo selbst bleibt unverändert.
+
+Alle Windows-Skripte in diesem Repo sind reines PowerShell (kein Git Bash, kein WSL) – mit einer Ausnahme: `windows\bin\gmake.cmd` ist ein trivialer Ein-Zeiler-Wrapper, für den sich eine `.ps1`-Datei nicht lohnt.
+
+## 0. Von Hand zu erledigen (nicht durch Skripte abgedeckt)
+
+- **`winget` selbst muss vorhanden sein** ("App Installer" aus dem Microsoft Store) – `bootstrap-win/neovim.ps1` prüft das und bricht mit klarer Meldung ab, kann `winget` aber nicht selbst nachinstallieren.
+- **Nach jedem Skript-Lauf ein neues Terminal öffnen**, bevor `nvim` das erste Mal gestartet wird. PATH-Änderungen (durch winget/npm-Installer oder `install-win.ps1`) landen in der Registry, aber die aktuell offene Shell bekommt das nicht automatisch mit.
+- **PATH-Registrierung stichprobenartig prüfen** – manche winget-Pakete tragen sich nicht automatisch in den PATH ein (im Praxistest z. B. `LLVM.LLVM`: bereits installiert, aber `clangd` nicht im PATH, vermutlich weil der `--silent`-Installer die PATH-Registrierung überspringt). Nach einem neuen Terminal kurz `Get-Command clangd, jq, make` aufrufen; fehlt eins, dessen Installationsordner (bei LLVM z. B. `C:\Program Files\LLVM\bin`) manuell zum User-PATH hinzufügen (gleiches Muster wie `Add-BinToUserPath` in `install-win.ps1`).
+- **yamlfmt, gawk, xmllint (libxml2) manuell installieren, falls benötigt** – im Praxistest bestätigt, dass es dafür keine winget-Pakete gibt ("Es wurde kein Paket gefunden, das den Eingabekriterien entspricht"), deshalb absichtlich nicht in `bootstrap-win/neovim.ps1` enthalten. Betrifft nur die Formatierung von awk-, xml/xsd- und yaml-Dateien (`conform.nvim` fällt sonst auf LSP-Formatierung zurück). Bekannte Alternativen: yamlfmt via `go install github.com/google/yamlfmt/cmd/yamlfmt@latest` (falls Go installiert) oder Binary von den GitHub-Releases; für gawk/xmllint keine verifizierte Windows-native Quelle gefunden, ggf. `winget search gawk` / `winget search libxml2` selbst prüfen.
+- **Reihenfolge**: `install-win.ps1` und `bootstrap-win/neovim.ps1` sind unabhängig voneinander, `bootstrap-win/neovim-dict.ps1` ebenso. Empfehlenswert: erst Neovim/Git/Node (Abschnitt 1) installieren, dann beide Bootstrap-Skripte laufen lassen, dann neues Terminal öffnen, dann `nvim` starten (lädt beim ersten Start automatisch alle Lua-Plugins via `lazy.nvim` – Internetverbindung nötig).
+- **Neovim immer aus einer "Developer PowerShell for VS" starten** (Startmenü-Eintrag, den Visual Studio/die Build Tools mitbringen), nicht aus normalem Windows Terminal/PowerShell. `cl.exe` (MSVC) braucht die `INCLUDE`/`LIB`-Umgebungsvariablen aus `vcvarsall.bat`, die nur in dieser Developer-Shell gesetzt sind – siehe Abschnitt 4.
+
+## 1. Grundwerkzeuge installieren
+
+Execution Policy einmalig setzen, sonst starten die `.ps1`-Skripte in diesem Repo gar nicht (Alternative pro Aufruf: `powershell -ExecutionPolicy Bypass -File .\skript.ps1`):
+
+```powershell
+Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
+winget install Neovim.Neovim
+winget install Git.Git
+winget install OpenJS.NodeJS.LTS
+winget install dandavison.delta
+```
+
+`delta` wird von `git/config` als Pager vorausgesetzt (`pager = delta`, `diffFilter = delta --color-only`). War auch unter macOS/FreeBSD nie Teil von `bootstrap/neovim.sh` – wurde dort offenbar immer manuell installiert.
+
+(Kein Python nötig – der Python-Provider ist in `options.lua` deaktiviert. Auch kein separater C-Compiler nötig – MSVC ist auf den Zielsystemen bereits vorhanden, siehe Abschnitt 3 bzw. 4.)
+
+## 2. Konfiguration einrichten (Windows-nativer Weg)
+
+`install-win.ps1` im Repo-Root ausführen:
+
+```powershell
+.\install-win.ps1
+```
+
+Es kopiert (keine Symlinks, keine Admin-Rechte nötig):
+
+- `nvim/` → `%LOCALAPPDATA%\nvim`
+- `git/config` → `%USERPROFILE%\.gitconfig`
+- `git/config-up2parts` → `%USERPROFILE%\.config\git\config-up2parts` (Pfad ist im `includeIf` von `git/config` hartkodiert)
+- `npm/npmrc` → `%USERPROFILE%\.npmrc` (nur falls dort noch keine Datei existiert) – die Zeile `prefix=${HOME}/.local` wird dabei auskommentiert: `HOME` ist unter Windows i. d. R. nicht gesetzt, npm nutzt dort ohnehin schon von Haus aus `%APPDATA%\npm` als Präfix
+
+Nach Änderungen im Repo `install-win.ps1` erneut ausführen, um die Kopien zu aktualisieren.
+
+## 3. Externe Abhängigkeiten
+
+`bootstrap/neovim.sh` bricht unter Windows sofort ab (`Nicht unterstütztes Betriebssystem`). Stattdessen `bootstrap-win/neovim.ps1` ausführen (reines PowerShell, kein Git Bash/WSL nötig):
+
+```powershell
+.\bootstrap-win\neovim.ps1
+```
+
+Installiert per `winget`/`npm`: Git, Node, Formatter (jq, prettier, ruff, shfmt, stylua), Tools (ripgrep, fd, tree-sitter-cli, make über `ezwinports.make`) und LSP-Server (basedpyright, bash-language-server, clangd, shellcheck, vscode-langservers-extracted, lua-language-server, prisma, vtsls). Im Praxistest (24.07.2026) erfolgreich; yamlfmt/gawk/xmllint bewusst nicht enthalten (siehe Abschnitt 0). Einzelne Pakete, die trotzdem fehlschlagen, werden als Warnung gemeldet statt das Skript abzubrechen, inklusive der letzten Zeilen der winget-Fehlermeldung.
+
+Kein C-Compiler-Paket enthalten: MSVC ist auf den Zielsystemen bereits vorhanden, `nvim-treesitter` nutzt `cl.exe`. Dafür muss Neovim aber aus einer "Developer PowerShell for VS" gestartet werden (siehe Abschnitt 4).
+
+`windows\bin` (enthält `gmake.cmd`, Wrapper für `opt.makeprg = "gmake"`) danach einmalig zum PATH hinzufügen (PowerShell, User-Scope – nicht `setx PATH "%PATH%;..."` verwenden, das würde den kompletten Prozess-PATH inkl. System-Anteil dauerhaft in den User-PATH kopieren):
+
+```powershell
+$userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+[Environment]::SetEnvironmentVariable("PATH", "$userPath;$env:USERPROFILE\dotfiles\windows\bin", "User")
+```
+
+## 4. Bekannte Stolpersteine
+
+- **C-Compiler für `nvim-treesitter` (MSVC)**: `cl.exe` findet `nvim-treesitter` automatisch, aber nur wenn `INCLUDE`/`LIB` gesetzt sind – das passiert ausschließlich in einer "Developer PowerShell for VS" bzw. "x64 Native Tools Command Prompt", nicht in einer normalen PowerShell/Windows Terminal-Sitzung. Ohne das schlägt die Parser-Kompilierung mit einer Meldung wie "cannot find `<header>`.h" fehl, obwohl `cl.exe` selbst gefunden wird. Neovim also immer aus dieser Developer-Shell heraus starten.
+
+## 5. Verifizieren
+
+```
+nvim
+:checkhealth
+```
+
+`:checkhealth` zeigt fehlende Provider/Tools direkt an – guter letzter Schritt nach der Installation.
+
+## 6. Aktualisieren
+
+Pendant zu `brew update && brew upgrade` (macOS) bzw. `pkg update && pkg upgrade` (FreeBSD):
+
+```powershell
+winget source update      # Paketquellen aktualisieren
+winget upgrade --all      # alle winget-Pakete aktualisieren
+```
+
+Vorschau, was aktualisiert würde, ohne etwas zu ändern:
+
+```powershell
+winget list --upgrade-available
+```
+
+Einzelnes Paket gezielt aktualisieren (IDs siehe `bootstrap-win/neovim.ps1`):
+
+```powershell
+winget upgrade LLVM.LLVM
+```
+
+Zwei Besonderheiten gegenüber brew/pkg:
+
+- Manche Pakete melden nicht immer zuverlässig eine neue Version (z. B. ältere/portable Pakete). `winget upgrade --all --include-unknown` bezieht auch diese mit ein, installiert dabei aber unter Umständen unnötig neu.
+- Ein Paket dauerhaft von `--all` ausnehmen: `winget pin add <id>` (Pendant zu `brew pin`).
+
+Die npm-Pakete (`prettier`, `basedpyright`, `bash-language-server`, `vtsls`, `@prisma/language-server`, `vscode-langservers-extracted`) laufen außerhalb von winget und werden separat aktualisiert:
+
+```powershell
+npm update -g
+```
+
+`bootstrap-win/neovim.ps1` erneut auszuführen aktualisiert nichts – `Install-WingetPackage`/`Install-NpmPackage` überspringen ein Paket, sobald das Binary gefunden wird (siehe `Write-Skip`). Für Updates immer die Befehle oben verwenden.
diff --git a/nvim/lua/config/usercmds.lua b/nvim/lua/config/usercmds.lua
index 9abc50f..529b370 100644
--- a/nvim/lua/config/usercmds.lua
+++ b/nvim/lua/config/usercmds.lua
@@ -66,8 +66,16 @@ local function enable_lsp()
   vim.cmd("edit") -- triggert Reattach bei vielen Setups
 end
 
-vim.api.nvim_create_user_command("SonarScan", run_sonar, {})
-vim.api.nvim_create_user_command("SonarIssues", load_sonar_issues, {})
+-- sonar-scanner/scripts/sonarqube.sh sind POSIX-only (kein Windows-Pendant),
+-- deshalb Kommandos unter Windows gar nicht erst registrieren statt sie
+-- dort fehlschlagen zu lassen.
+local is_windows = vim.fn.has("win32") == 1
+
+if not is_windows then
+  vim.api.nvim_create_user_command("SonarScan", run_sonar, {})
+  vim.api.nvim_create_user_command("SonarIssues", load_sonar_issues, {})
+end
+
 vim.api.nvim_create_user_command("LspOff", disable_lsp, {})
 vim.api.nvim_create_user_command("LspOffBuffer", disable_lsp_buffer, {})
 vim.api.nvim_create_user_command("LspOn", enable_lsp, {})
diff --git a/readme.md b/readme.md
index 465afef..4b168d3 100644
--- a/readme.md
+++ b/readme.md
@@ -1,9 +1,11 @@
 # Dotfiles
 
-My personal dotfiles for macOS and FreeBSD.
+My personal dotfiles for macOS, FreeBSD and Windows (Beta).
 
 ## Setup
 
+### macOS / FreeBSD
+
 Create the symbolic links:
 
 ```sh
@@ -17,6 +19,18 @@ Bootstrap the Neovim environment:
 ./bootstrap/neovim-dict.sh
 ```
 
+### Windows
+
+Native PowerShell, no WSL/Git Bash required:
+
+```powershell
+.\install-win.ps1
+.\bootstrap-win\neovim.ps1
+.\bootstrap-win\neovim-dict.ps1
+```
+
+See [neovim-windows-setup.md](neovim-windows-setup.md) for prerequisites (execution policy, MSVC Developer PowerShell for `nvim-treesitter`, ...) and known caveats.
+
 ## Included configuration
 
 - [abook]
diff --git a/windows/bin/gmake.cmd b/windows/bin/gmake.cmd
new file mode 100644
index 0000000..89f3a29
--- /dev/null
+++ b/windows/bin/gmake.cmd
@@ -0,0 +1,11 @@
+@echo off

+rem Wrapper, damit opt.makeprg = "gmake" (aus nvim/lua/config/options.lua)

+rem unter Windows funktioniert, ohne die bestehende Config anzupassen.

+rem Reicht alle Argumente an das im PATH gefundene "make" weiter.

+rem

+rem Einmalig einrichten: dieses Verzeichnis (windows\bin) zum PATH

+rem hinzufuegen, z.B. ueber:

+rem   setx PATH "%PATH%;%USERPROFILE%\dotfiles\windows\bin"

+

+make %*

+exit /b %ERRORLEVEL%

diff --git a/windows/bin/nvim-update.cmd b/windows/bin/nvim-update.cmd
new file mode 100644
index 0000000..7e8260e
--- /dev/null
+++ b/windows/bin/nvim-update.cmd
@@ -0,0 +1,2 @@
+@echo off

+nvim --headless "+Lazy! sync" "+qa"