Zum Inhalt springen

Paneflow unter Windows installieren

Installiere das native Paneflow-MSI unter Windows 10 oder 11, prüfe den PATH-Eintrag und entscheide, wann WSL2 besser passt.

Paneflow veröffentlicht ein natives Windows-MSI für Windows 10 1809+ und Windows 11 auf x86_64. Verwende das MSI für normale Windows- Workflows. Verwende WSL2 nur dann, wenn deine Dateien, Agents und Toolchains bereits in Linux liegen.

Lade paneflow-0.8.2-x86_64-pc-windows-msvc.msi herunter, führe es aus, öffne Paneflow über das Startmenü und prüfe dann den Befehl paneflow in einem neuen PowerShell-Fenster.

Das MSI ist unter der Herausgeberidentität StriveX signiert. So prüfst du ein heruntergeladenes MSI vor dem Start:

powershell
$version = "0.8.2"
Get-AuthenticodeSignature ".\paneflow-$version-x86_64-pc-windows-msvc.msi" | Select-Object Status, SignerCertificate

Status sollte Valid sein. SmartScreen kann weiterhin erscheinen, während das Zertifikat Reputation aufbaut.

Paneflow mit dem MSI installieren

  1. Öffne die Download-Seite oder den neuesten GitHub-Release.

  2. Lade das Windows-MSI herunter:

msi
paneflow-0.8.2-x86_64-pc-windows-msvc.msi
  1. Führe den Installer aus. Das MSI installiert Paneflow als normale Windows-App, fügt eine Startmenü-Verknüpfung hinzu und stellt paneflow im PATH bereit.

  2. Öffne Paneflow über das Startmenü.

  3. Öffne ein neues PowerShell-Fenster und prüfe den Befehl:

powershell
paneflow --version

Wenn der Befehl eine Version ausgibt, funktionieren MSI und PATH-Eintrag.

Neue Panes verwenden deine konfigurierte Shell. Wenn keine Shell konfiguriert ist, fällt Paneflow auf PowerShell 7, Windows PowerShell, %ComSpec% und danach cmd.exe zurück. Ändere die Standardshell in den Settings.

Unterstützte Windows-Matrix

UmgebungStatusHinweise
Windows 11 x86_64UnterstütztEmpfohlener nativer Pfad.
Windows 10 1809+ x86_64UnterstütztBenötigt einen funktionierenden GPU-Treiber mit DirectX 11 feature level 10+.
Windows vor 10 1809Nicht unterstütztDer native Build hängt von neueren Windows-APIs für Terminal und Grafik ab.
Windows auf ARM64Noch nicht veröffentlichtDas Windows-Artefakt ist nur x86_64.
WSL2 + WSLgVom Use Case abhängigVerwende es, wenn die Linux-Toolchain die Quelle der Wahrheit ist. Starte die native Windows-App nicht aus einer WSL2- oder Dev-Container-Host-Shell.

Paneflows Windows-Runtime nutzt Win32, DirectX, ConPTY und Named Pipes. Die App rendert native Windows-Steuerelemente, keine Electron-Hülle.

Terminal-Backend

Ab Paneflow 0.8.1 wählt der offizielle Windows-x64-MSVC-Build für neue Sessions standardmäßig Ghosttys gepinnte, statisch gelinkte libghostty-vt-Engine, wenn terminal.backend fehlt oder auf auto steht. Paneflow behält seinen eigenen GPUI-Renderer und seine ConPTY-/Session-Schicht; libghostty-vt übernimmt VT-Parsing, Terminalzustand und Eingabekodierung. alacritty ermöglicht den ausdrücklichen Wechsel zurück zu Alacritty. Windows-ARM64- und GNU-Ziele sowie eigene Builds ohne natives Ghostty-Feature bleiben bei Alacritty. Die Änderung gilt für neue Sessions; laufende Sessions behalten ihre aktuelle Engine.

Natives Windows oder WSL2?

Verwende das native MSI, wenn du Windows-Integration willst: Startmenü, Windows-Dateiauswahl, Benachrichtigungen, native Fenstersteuerung, PATH-Einrichtung und In-App-Updates.

Verwende WSL2, wenn deine Agents, Repositories, Paketmanager und Shell-Anpassungen in einer Linux-Distribution leben. Installiere dann den Linux-Build in WSL2 und lasse WSLg das Fenster anzeigen.

bash
VER=0.8.2
curl -LO "https://github.com/arthjean/paneflow/releases/download/v${VER}/paneflow-${VER}-x86_64.deb"
sudo apt install "./paneflow-${VER}-x86_64.deb"
paneflow --version
paneflow

WSL in einem Paneflow-Pane ist etwas anderes als Paneflow selbst aus WSL zu starten. Starte die native App über das Startmenü oder eine native Windows-Shell.

Bekannte Windows-Einschränkungen

  • Windows Defender SmartScreen kann erscheinen, während das Signaturzertifikat Reputation aufbaut. Prüfe Release und Herausgeber, bevor du das MSI ausführst.
  • cmd.exe sendet keine OSC-7-Markierungen für das aktuelle Verzeichnis, daher ist cwd-bewusstes Pane-Verhalten dort schwächer. Verwende lieber PowerShell 7, Windows PowerShell, Git Bash oder WSL.
  • RDP, Starts aus Dev Containern und native App-Starts aus WSL2 können upstream GPUI- oder Windows-Grafikfälle treffen.
  • CJK-IME und manche ConPTY-Ctrl+C-Verhalten haben weiterhin Windows-spezifische Randfälle.

Für die tieferen Windows-Notizen bleibt das Windows-Dokument im App-Repo die Quelle der Wahrheit.

Aktualisieren und deinstallieren

Verwende den In-App-Updater oder führe das neueste MSI erneut aus. Der Updater wählt das passende Windows-MSI, prüft es, speichert die aktuelle Session und übergibt das Upgrade an Windows Installer.

Wenn du von Paneflow 0.7.7 oder 0.7.8 aktualisierst und der In-App-Updater einen beschädigten oder manipulierten Download meldet, installiere 0.7.9 einmal manuell über das MSI. Danach sollten Windows-Updates wieder direkt aus Paneflow funktionieren.

Deinstalliere Paneflow über die Windows-Einstellungen. Die Deinstallation entfernt die App, behält aber die Benutzerkonfiguration unter %APPDATA%\paneflow\paneflow.json. Hilfsbinärdateien können außerdem unter %LOCALAPPDATA%\paneflow\bin liegen.