Installer Paneflow sur Windows

Paneflow publie un MSI Windows natif pour Windows 10 1809+ et Windows 11 sur x86_64. Utilise le MSI pour un usage Windows normal. Utilise WSL2 seulement quand tes fichiers, agents et toolchains vivent déjà côté Linux.

Le MSI est signé sous l'identité d'éditeur StriveX. Pour vérifier un MSI téléchargé avant de le lancer :

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

Status doit être Valid. SmartScreen peut encore apparaître pendant que la réputation du certificat se construit.

Installer Paneflow avec le MSI

1. Ouvre la page de téléchargement ou la dernière release GitHub.

2. Télécharge le MSI Windows:

paneflow-0.8.2-x86_64-pc-windows-msvc.msi

3. Lance l'installeur. Le MSI installe Paneflow comme une app Windows standard, ajoute un raccourci au menu Démarrer, et expose paneflow dans le PATH.

4. Ouvre Paneflow depuis le menu Démarrer.

5. Ouvre une nouvelle fenêtre PowerShell et vérifie la commande:

paneflow --version

Si la commande affiche une version, le MSI et l'entrée PATH fonctionnent.

Les nouveaux volets utilisent le shell configuré. Sans shell configuré, Paneflow essaie PowerShell 7, Windows PowerShell, %ComSpec%, puis cmd.exe. Change le shell par défaut dans Settings.

Matrice Windows supportée

Le runtime Windows de Paneflow utilise Win32, DirectX, ConPTY et des named pipes. L'app rend des contrôles Windows natifs, pas une couche Electron.

Moteur de terminal

À partir de Paneflow 0.8.1, le build Windows x64 MSVC officiel sélectionne par défaut le moteur Ghostty libghostty-vt épinglé et lié statiquement pour les nouvelles sessions lorsque terminal.backend est omis ou vaut auto. Paneflow conserve son propre moteur de rendu GPUI et sa couche ConPTY/session ; libghostty-vt gère l'analyse VT, l'état du terminal et l'encodage des entrées. La valeur alacritty permet un retour explicite à Alacritty. Les builds Windows ARM64 et GNU, ainsi que les builds personnalisés sans la fonctionnalité Ghostty native, restent sur Alacritty. Le changement s'applique aux nouvelles sessions ; les sessions ouvertes conservent leur moteur.

Windows natif ou WSL2 ?

Utilise le MSI natif quand tu veux l'intégration Windows: lancement depuis le menu Démarrer, sélecteur de fichiers Windows, notifications, contrôles de fenêtre natifs, configuration du PATH, et mise à jour dans l'app.

Utilise WSL2 quand tes agents, dépôts, gestionnaires de paquets et personnalisation shell vivent dans une distribution Linux. Dans ce cas, installe le build Linux dans WSL2 et laisse WSLg afficher la fenêtre.

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

Utiliser WSL dans un volet Paneflow n'est pas la même chose que lancer Paneflow lui-même depuis WSL. Lance l'app native depuis le menu Démarrer ou depuis un shell Windows natif.

Limites connues sur Windows

• Windows Defender SmartScreen peut apparaître pendant que le certificat de signature gagne en réputation. Vérifie la release et l'éditeur avant de lancer le MSI.
• cmd.exe n'émet pas les marqueurs OSC 7 de répertoire courant, donc les comportements de volet sensibles au cwd y sont moins solides. Préfère PowerShell 7, Windows PowerShell, Git Bash ou WSL.
• RDP, les lancements depuis dev container et les lancements d'app native depuis WSL2 peuvent déclencher des limites GPUI ou graphiques Windows en amont.
• Les IME CJK et certains comportements ConPTY autour de Ctrl+C gardent des cas limites spécifiques à Windows.

Pour les notes Windows de plus bas niveau, garde le document Windows du repo app comme source de vérité.

Mettre à jour et désinstaller

Utilise la mise à jour intégrée ou relance le dernier MSI. L'updater sélectionne le MSI Windows correspondant, le vérifie, sauvegarde la session en cours, puis délègue la mise à niveau à Windows Installer.

Désinstalle Paneflow depuis les paramètres Windows. La désinstallation retire l'app mais garde la configuration utilisateur dans %APPDATA%\paneflow\paneflow.json. Des binaires auxiliaires peuvent aussi vivre dans %LOCALAPPDATA%\paneflow\bin.