7 files changed, 159 insertions, 30 deletions

diff --git a/bootstrap-win/neovim.ps1 b/bootstrap-win/neovim.ps1
index 548583e..77abf83 100644
--- a/bootstrap-win/neovim.ps1
+++ b/bootstrap-win/neovim.ps1
@@ -11,11 +11,15 @@
   Aufruf (PowerShell, keine Admin-Rechte noetig):
     .\bootstrap-win\neovim.ps1
 
-  Hinweis: Einzelne winget-Paket-IDs (v.a. GnuWin32.Gawk, GnuWin32.Libxml2,
-  google.yamlfmt, mvdan.shfmt, astral-sh.ruff) konnten in dieser Session
-  nicht gegen eine aktuelle winget-Quelle verifiziert werden. Schlaegt eine
-  Installation fehl, meldet das Skript das als Warnung (bricht nicht ab)
-  und nennt den Befehl zum manuellen Nachschlagen ("winget search <name>").
+  Hinweis: yamlfmt, gawk und xmllint/libxml2 sind bewusst NICHT enthalten -
+  im Praxistest (24.07.2026) bestaetigt, dass es dafuer keine winget-Pakete
+  unter den urspruenglich vermuteten IDs gibt. Siehe Install-Formatters und
+  neovim-windows-setup.md fuer manuelle Alternativen. mvdan.shfmt und
+  astral-sh.ruff liefen im Test erfolgreich durch.
+
+  Schlaegt eine winget-Installation trotzdem fehl, meldet das Skript das
+  als Warnung (bricht nicht ab) und zeigt die letzten Zeilen der winget-
+  Ausgabe zur Fehlersuche an.
 
   C-Compiler fuer nvim-treesitter: kein winget-Paket enthalten, da MSVC auf
   den Zielsystemen bereits vorhanden ist. Neovim muss dafuer aus einer
@@ -46,6 +50,40 @@ function Test-CommandExists([string]$Name) {
   return [bool](Get-Command $Name -ErrorAction SilentlyContinue)
 }
 
+function Find-BinaryDirectory([string]$Binary) {
+  # Sucht nach "<Binary>.exe" unter den ueblichen Installationswurzeln.
+  # Deckt den Fall ab, dass ein winget-Paket (v.a. im --silent-Modus)
+  # die PATH-Registrierung ausgelassen hat, obwohl es korrekt installiert
+  # wurde - beobachtet bei LLVM.LLVM/clangd.
+  $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
@@ -53,10 +91,34 @@ function Install-WingetPackage([string]$Binary, [string]$Id) {
   }
 
   Write-Step "winget install $Id"
-  winget install --id $Id -e --source winget --accept-package-agreements --accept-source-agreements --silent | Out-Null
+  $output = winget install --id $Id -e --source winget --accept-package-agreements --accept-source-agreements --silent 2>&1
 
   if ($LASTEXITCODE -ne 0) {
-    Write-Warn "winget install $Id fehlgeschlagen (Binary '$Binary' nicht gefunden). Pruefen mit: winget search $Id"
+    $text = $output -join " "
+    $lastLine = ($output | Select-Object -Last 3) -join " / "
+
+    if ($text -match "bereits ein vorhandenes Paket|already installed|No applicable update") {
+      # Paket ist laut winget installiert, aber die Binary steht trotzdem
+      # nicht im PATH - z.B. weil der Installer (im --silent-Modus) die
+      # PATH-Registrierung uebersprungen hat. winget search hilft hier
+      # nicht weiter, da das Paket ja gefunden wurde - stattdessen selbst
+      # danach suchen und den User-PATH ergaenzen (dauerhaft + fuer diese
+      # Sitzung).
+      $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
   }
 
@@ -115,9 +177,15 @@ function Install-Formatters {
   Install-WingetPackage -Binary "ruff" -Id "astral-sh.ruff"
   Install-WingetPackage -Binary "shfmt" -Id "mvdan.shfmt"
   Install-WingetPackage -Binary "stylua" -Id "JohnnyMorganz.StyLua"
-  Install-WingetPackage -Binary "yamlfmt" -Id "google.yamlfmt"
-  Install-WingetPackage -Binary "gawk" -Id "GnuWin32.Gawk"
-  Install-WingetPackage -Binary "xmllint" -Id "GnuWin32.Libxml2"
+
+  # yamlfmt, gawk, xmllint: im Praxistest bestaetigt, dass es unter diesen
+  # IDs kein winget-Paket gibt ("Es wurde kein Paket gefunden, das den
+  # Eingabekriterien entspricht"). Kein verifizierter Ersatz gefunden,
+  # deshalb bewusst nicht automatisiert - siehe neovim-windows-setup.md
+  # fuer manuelle Alternativen. conform.nvim faellt bei fehlendem
+  # Formatter fuer die jeweilige Dateiart einfach auf LSP-Formatierung
+  # zurueck (default_format_opts.lsp_format = "fallback"), betrifft also
+  # nur awk/xml/xsd/yaml-Dateien.
 }
 
 function Install-Tools {
@@ -140,7 +208,10 @@ function Install-Tools {
   # dauerhaft in den User-PATH kopieren):
   #   $userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
   #   [Environment]::SetEnvironmentVariable("PATH", "$userPath;$env:USERPROFILE\dotfiles\windows\bin", "User")
-  Install-WingetPackage -Binary "make" -Id "GnuWin32.Make"
+  # GnuWin32.Make ist im Praxistest fehlgeschlagen (Paket 2006er-Stand,
+  # unklar ob im winget-Repo ueberhaupt noch gepflegt). ezwinports.make
+  # ist ein aktiver gepflegter GNU-Make-Port fuer Windows.
+  Install-WingetPackage -Binary "make" -Id "ezwinports.make"
 }
 
 function Install-Lsp {
diff --git a/bootstrap/neovim.sh b/bootstrap/neovim.sh
index 6ffefaf..94bf82b 100755
--- a/bootstrap/neovim.sh
+++ b/bootstrap/neovim.sh
@@ -141,6 +141,17 @@ install_lsp() {
   install_npm vtsls @vtsls/language-server
 }
 
+install_analysis() {
+  # sonar-scanner wird direkt von nvim/lua/config/usercmds.lua (:SonarScan)
+  # und nvim/scripts/sonarqube.sh (:SonarIssues) genutzt. Nur beruflich
+  # unter macOS im Einsatz, deshalb kein FreeBSD-Zweig.
+  case "$OS" in
+  Darwin)
+    install_pkg sonar-scanner sonar-scanner
+    ;;
+  esac
+}
+
 main() {
   check_prerequisites
   setup_homebrew_env
@@ -149,6 +160,7 @@ main() {
   install_formatters
   install_tools
   install_lsp
+  install_analysis
 
   printf "\nBootstrap abgeschlossen.\n"
 }
diff --git a/install-win.ps1 b/install-win.ps1
index 632c25e..15f39e4 100644
--- a/install-win.ps1
+++ b/install-win.ps1
@@ -75,8 +75,22 @@ function Copy-Npmrc {
     return
   }
 
-  Write-Step "npm\npmrc -> $NpmrcDst"
-  Copy-Item -Force $NpmrcSrc $NpmrcDst
+  # npm/npmrc setzt "prefix=${HOME}/.local", damit globale npm-Installationen
+  # unter POSIX ohne sudo/root ins Home-Verzeichnis gehen. HOME ist unter
+  # Windows i.d.R. nicht gesetzt, ${HOME} wuerde also nicht expandieren.
+  # Der Grund fuer die Einstellung entfaellt unter Windows ohnehin (npm
+  # nutzt dort schon von Haus aus %APPDATA%\npm, automatisch im PATH) -
+  # die Zeile wird beim Kopieren einfach auskommentiert, statt eine 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, siehe install-win.ps1: Copy-Npmrc)"
+    } else {
+      $_
+    }
+  }
+  Set-Content -Path $NpmrcDst -Value $lines
   Write-Ok $NpmrcDst
 }
 
diff --git a/neovim-windows-setup.md b/neovim-windows-setup.md
index 24e5bc0..c925f59 100644
--- a/neovim-windows-setup.md
+++ b/neovim-windows-setup.md
@@ -2,28 +2,32 @@
 
 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. Falls die Ausführung der `.ps1`-Skripte durch die Execution Policy blockiert wird, entweder pro Aufruf `powershell -ExecutionPolicy Bypass -File .\skript.ps1` verwenden, oder einmalig `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`.
+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)
 
-- **Execution Policy** setzen (siehe oben), sonst starten die `.ps1`-Skripte gar nicht.
 - **`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.
-- **Neovim selbst installieren** (`winget install Neovim.Neovim`, Abschnitt 1) – kein Skript hier installiert Neovim, nur seine Config/Abhängigkeiten.
-- **`delta` installieren** (`git/config` setzt `pager = delta` und `diffFilter = delta --color-only`). War auch unter macOS/FreeBSD nie Teil von `bootstrap/neovim.sh` – wurde dort offenbar immer manuell nachgezogen. Unter Windows z. B. `winget install dandavison.delta` (ID ungeprüft, ggf. `winget search delta` gegenchecken).
 - **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**, vor allem bei den GnuWin32-Paketen (`jq`, `gawk`, `make`, `libxml2`/`xmllint`) – ältere/portable winget-Pakete tragen sich nicht immer automatisch in den PATH ein. Nach einem neuen Terminal kurz `Get-Command jq, gawk, make, xmllint` aufrufen; fehlt eins, dessen Installationsordner manuell zum User-PATH hinzufügen (gleiches Muster wie `Add-BinToUserPath` in `install-win.ps1`).
+- **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
 ```
 
-(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/4.)
+`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)
 
@@ -38,7 +42,7 @@ 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)
+- `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.
 
@@ -50,11 +54,12 @@ Nach Änderungen im Repo `install-win.ps1` erneut ausführen, um die Kopien zu a
 .\bootstrap-win\neovim.ps1
 ```
 
-Installiert per `winget`/`npm`: Git, Node, Formatter (jq, prettier, ruff, shfmt, stylua, yamlfmt, gawk, xmllint), Tools (ripgrep, fd, tree-sitter-cli, make) und LSP-Server (basedpyright, bash-language-server, clangd, shellcheck, vscode-langservers-extracted, lua-language-server, prisma, vtsls). Einzelne Pakete, die fehlschlagen, werden als Warnung gemeldet statt das Skript abzubrechen – Details siehe Kopfkommentar im Skript (einige winget-IDs, v. a. GnuWin32.Gawk/Libxml2, google.yamlfmt, mvdan.shfmt, astral-sh.ruff, sind ungeprüft).
+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")
@@ -63,10 +68,6 @@ $userPath = [Environment]::GetEnvironmentVariable("PATH", "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.
-- **Rechtschreibprüfung (Deutsch)**: `bootstrap-win/neovim-dict.ps1` ausführen – lädt `de.utf-8.spl`/`.sug` nach `%LOCALAPPDATA%\nvim-data\site\spell` (nativer Windows-Datenpfad von Neovim).
-- **`scripts/sonarqube.sh`** (`:SonarIssues`): reines POSIX-Shellskript, kein Windows-Pendant vorhanden. Läuft nur, wenn ein `sh` im PATH liegt (z. B. `sh.exe` aus Git for Windows im PATH verfügbar machen); ansonsten `:SonarIssues` auf Windows nicht nutzen.
-- **Clipboard** (`unnamedplus`): funktioniert nativ unter Windows-Neovim ohne Zusatztool – anders als unter WSL, wo `win32yank` nötig wäre.
-- **`opt.guifont`**: wirkt nur bei GUI-Frontends wie Neovide. Im Windows Terminal muss die Schriftart dort separat eingestellt werden.
 
 ## 5. Verifizieren
 
@@ -100,7 +101,7 @@ winget upgrade LLVM.LLVM
 
 Zwei Besonderheiten gegenüber brew/pkg:
 
-- Ältere/portable Pakete (v. a. die GnuWin32-Reihe: `jq`, `gawk`, `make`, `libxml2`) melden nicht immer zuverlässig eine neue Version. `winget upgrade --all --include-unknown` bezieht auch diese mit ein, installiert dabei aber unter Umständen unnötig neu.
+- 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:
diff --git a/nvim/lua/config/statusline.lua b/nvim/lua/config/statusline.lua
index 0ec6579..8a9c75a 100644
--- a/nvim/lua/config/statusline.lua
+++ b/nvim/lua/config/statusline.lua
@@ -20,6 +20,10 @@ end
 -- Git branch (buffer-lokal, gecached, kein redraw-spam)
 ----------------------------------------------------------------------
 
+-- /dev/null gibt es unter Windows nicht (cmd.exe versteht das nicht als
+-- Pfad und meldet "Das System kann den angegebenen Pfad nicht finden").
+local devnull = vim.fn.has("win32") == 1 and "NUL" or "/dev/null"
+
 local function update_git_branch(bufnr)
   bufnr = bufnr or 0
 
@@ -35,7 +39,12 @@ local function update_git_branch(bufnr)
     return
   end
 
-  local branch = vim.fn.systemlist("git rev-parse --abbrev-ref HEAD 2>/dev/null")[1]
+  local branch = vim.fn.systemlist("git rev-parse --abbrev-ref HEAD 2>" .. devnull)[1]
+  if branch then
+    -- unter Windows bleibt an systemlist()-Zeilen mitunter ein
+    -- trailing \r haengen (^M in der Statuszeile sichtbar)
+    branch = branch:gsub("\r$", "")
+  end
 
   if branch and branch ~= "" then
     vim.b[bufnr].git_branch = "  " .. branch .. " "
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]