Installer Paneflow sur Windows

Paneflow fonctionne nativement sur Windows 10 version 1809 ou ultérieure et Windows 11, avec un processeur x86_64 (Intel ou AMD). Installez le MSI pour vos projets Windows. Si vos dépôts et agents se trouvent dans une distribution Linux, consultez la section WSL2 ci-dessous.

Installer Paneflow avec le MSI

1. Ouvrez la page de téléchargement de Paneflow ou la dernière version de Paneflow sur GitHub.
2. Téléchargez paneflow-0.17.7-x86_64-pc-windows-msvc.msi.
3. Vérifiez la signature du fichier comme indiqué ci-dessous, puis lancez le MSI. Acceptez la demande d'autorisation administrateur de Windows.
4. Gardez PATH Environment Variable sélectionné pour utiliser paneflow depuis un terminal. Le dossier d'installation par défaut est %ProgramFiles%\PaneFlow.
5. Terminez l'installation, puis ouvrez PaneFlow depuis le menu Démarrer.

Vous n'avez pas besoin de Rust ni d'outils de compilation. Installez vos agents CLI séparément, puis suivez le guide des premiers pas pour ouvrir un projet et lancer un agent.

Vérifier la signature du MSI

Dans PowerShell, ouvrez le dossier contenant le MSI téléchargé et exécutez :

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

Le statut doit être Valid et le sujet du certificat doit identifier Strivex comme éditeur. Si le fichier est introuvable, vérifiez le dossier et son nom. Si la signature est invalide ou l'éditeur différent, téléchargez une nouvelle copie depuis la page de version avant de continuer.

SmartScreen peut afficher un avertissement de réputation même pour un fichier signé. Vérifiez d'abord la signature et l'éditeur. Si un ordinateur géré par votre organisation bloque l'installation, contactez l'administrateur.

Vérifier l'installation

Ouvrez une nouvelle fenêtre PowerShell et exécutez :

paneflow --version

La commande doit afficher la version installée. Vérifiez aussi que l'application s'ouvre depuis le menu Démarrer.

Si paneflow n'est pas reconnu, fermez toutes les fenêtres de terminal et rouvrez PowerShell depuis le menu Démarrer. Si la commande reste introuvable, essayez le chemin d'installation par défaut :

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

Si vous avez choisi un autre dossier, utilisez ce chemin. Si le chemin complet fonctionne, utilisez-le en attendant de relancer le MSI pour rétablir l'option PATH Environment Variable. Si le fichier exécutable est absent, vérifiez le dossier d'installation ou réinstallez l'application.

Les nouveaux panneaux utilisent le shell choisi dans Settings de Paneflow. Sans shell configuré, Paneflow essaie PowerShell 7, Windows PowerShell, %ComSpec%, puis cmd.exe.

Versions de Windows et prérequis

Windows natif ou WSL2 ?

Utilisez l'application native pour vos fichiers, shells et agents Windows. Lancez-la depuis le menu Démarrer ou un shell Windows, y compris lorsque vous utilisez WSL dans un panneau.

Utilisez la version Linux dans WSL2 lorsque vos dépôts, agents et outils sont installés dans Linux. WSLg affiche la fenêtre de l'application Linux. Configurez WSL2 et l'affichage graphique avec les instructions WSLg de Microsoft, puis suivez le guide d'installation Linux depuis votre terminal Linux. Choisissez le paquet adapté à votre distribution et à votre architecture. WSL1 ne permet pas d'afficher des applications Linux avec WSLg.

Limites connues sur Windows

• Préférez PowerShell ou Git Bash à cmd.exe pour suivre le répertoire courant d'un panneau. cmd.exe ne signale pas les changements de répertoire avec OSC 7.
• Le Bureau à distance, les lancements depuis WSL2 ou des conteneurs de développement, les méthodes de saisie CJK et certains comportements de Ctrl+C peuvent présenter des limites propres à Windows. Si un problème persiste avec la dernière version, signalez un problème Windows en précisant la version de Paneflow, le build Windows, le shell et les étapes pour le reproduire.

Moteur de terminal

Le moteur de terminal Ghostty libghostty-vt est inclus dans la version Windows. Vous n'avez pas à l'installer ni à choisir un moteur. Une ancienne clé terminal.backend dans paneflow.json est ignorée. Consultez l'utilisation de Ghostty par Paneflow sur Windows pour l'historique de la migration.

Mettre à jour et désinstaller

Avant une mise à niveau, enregistrez vos fichiers et terminez les commandes actives. Le MSI peut arrêter les sessions de terminal en cours pendant la mise à niveau.

Utilisez la mise à jour intégrée ou téléchargez et lancez paneflow-0.17.7-x86_64-pc-windows-msvc.msi. Si une mise à jour signale un téléchargement corrompu ou relance la même version, installez le dernier MSI manuellement. Cela vaut aussi pour les échecs de mise à jour connus des versions 0.7.7/0.7.8 et 0.17.0/0.17.1. Vous n'avez pas besoin d'installer une version intermédiaire.

Désinstallez Paneflow depuis les paramètres Windows. Cela retire l'application installée mais conserve %USERPROFILE%\.paneflow, dont paneflow.json, les sessions enregistrées, les worktrees gérés et les binaires auxiliaires sous bin.