Paneflow unter Windows installieren

Paneflow läuft nativ unter Windows 10 Version 1809 oder neuer und Windows 11 auf x86_64 (Intel oder AMD). Installiere das MSI für Windows-Projekte. Wenn deine Repositories und Agents in einer Linux-Distribution liegen, lies den Abschnitt zu WSL2 weiter unten.

Paneflow mit dem MSI installieren

1. Öffne die Paneflow-Downloadseite oder das neueste Paneflow-Release auf GitHub.
2. Lade paneflow-0.17.7-x86_64-pc-windows-msvc.msi herunter.
3. Prüfe die Signatur wie unten beschrieben und führe das MSI aus. Bestätige die Windows-Abfrage für Administratorrechte.
4. Lass PATH Environment Variable ausgewählt, um paneflow im Terminal aufzurufen. Der Standardordner ist %ProgramFiles%\PaneFlow.
5. Schließe die Installation ab und öffne PaneFlow über das Startmenü.

Rust und Build-Werkzeuge sind nicht erforderlich. Installiere deine CLI-Agents separat und folge der Anleitung für die ersten Schritte, um ein Projekt zu öffnen und einen Agent zu starten.

MSI-Signatur prüfen

Öffne in PowerShell den Ordner mit dem heruntergeladenen MSI und führe aus:

$version = "0.17.7"
$signature = Get-AuthenticodeSignature ".\paneflow-$version-x86_64-pc-windows-msvc.msi"
$signature.Status
$signature.SignerCertificate.Subject

Der Status sollte Valid sein. Das Zertifikat sollte Strivex als Herausgeber ausweisen. Fehlt die Datei, prüfe Ordner und Dateinamen. Ist die Signatur ungültig oder der Herausgeber anders, lade vor der Installation eine neue Kopie von der Release-Seite herunter.

SmartScreen kann auch bei einer signierten Datei eine Reputationswarnung anzeigen. Prüfe zuerst Signatur und Herausgeber. Blockiert ein verwalteter PC die Installation, wende dich an die Administration.

Installation prüfen

Öffne ein neues PowerShell-Fenster und führe aus:

paneflow --version

Der Befehl sollte die installierte Version anzeigen. Prüfe auch, ob sich die App über das Startmenü öffnet.

Wird paneflow nicht erkannt, schließe alle Terminalfenster und öffne PowerShell erneut über das Startmenü. Ist der Befehl weiterhin nicht verfügbar, versuche den Standardpfad:

& "$env:ProgramFiles\PaneFlow\paneflow.exe" --version

Hast du einen anderen Ordner gewählt, verwende dessen Pfad. Funktioniert der vollständige Pfad, nutze ihn vorübergehend und führe das MSI erneut aus, um PATH Environment Variable wiederherzustellen. Fehlt die ausführbare Datei, prüfe den Installationsordner oder installiere die App erneut.

Neue Panes verwenden die in Paneflows Settings gewählte Shell. Ohne konfigurierte Shell versucht Paneflow PowerShell 7, Windows PowerShell, %ComSpec% und danach cmd.exe.

Windows-Versionen und Voraussetzungen

Natives Windows oder WSL2?

Verwende die native App für Windows-Dateien, Shells und Agents. Starte sie über das Startmenü oder eine Windows-Shell, auch wenn du WSL in einem Pane nutzt.

Verwende die Linux-Version in WSL2, wenn deine Repositories, Agents und Werkzeuge unter Linux installiert sind. WSLg zeigt das Fenster der Linux-App an. Richte WSL2 und die grafische Unterstützung nach Microsofts WSLg-Anleitung ein und folge der Linux-Installationsanleitung in deinem Linux-Terminal. Wähle das Paket für deine Distribution und Architektur. WSL1 kann keine Linux-GUI-Apps über WSLg anzeigen.

Bekannte Windows-Einschränkungen

• Verwende PowerShell oder Git Bash statt cmd.exe, um das aktuelle Verzeichnis eines Panes zu verfolgen. cmd.exe meldet Verzeichniswechsel nicht über OSC 7.
• Bei Remote Desktop, Starts aus WSL2 oder Dev Containern, CJK-Eingabemethoden und manchen Ctrl+C-Abläufen können Windows-spezifische Einschränkungen auftreten. Besteht ein Problem mit dem neuesten Release weiter, melde ein Windows-Problem mit Paneflow-Version, Windows-Build, Shell und Schritten zum Reproduzieren.

Terminal-Backend

Ghosttys Terminal-Engine libghostty-vt ist in der Windows-Version enthalten. Du musst sie weder installieren noch ein Backend wählen. Ein alter terminal.backend-Key in paneflow.json wird ignoriert. Lies wie Paneflow Ghostty unter Windows verwendet für den Verlauf der Migration.

Aktualisieren und deinstallieren

Speichere vor einem Upgrade deine Dateien und beende aktive Befehle. Das MSI kann beim Upgrade laufende Terminalsessions beenden.

Verwende den In-App-Updater oder lade paneflow-0.17.7-x86_64-pc-windows-msvc.msi herunter und führe es aus. Meldet ein Update einen beschädigten Download oder startet dieselbe Version erneut, installiere das neueste MSI manuell. Das gilt auch für die bekannten Updatefehler in 0.7.7/0.7.8 und 0.17.0/0.17.1. Eine Zwischenversion musst du nicht installieren.

Deinstalliere Paneflow über die Windows-Einstellungen. Die installierte App wird entfernt, %USERPROFILE%\.paneflow bleibt erhalten, einschließlich paneflow.json, gespeicherter Sessions, verwalteter Worktrees und Hilfsprogramme unter bin.