Instalar Paneflow en Windows

Paneflow publica un MSI nativo para Windows 10 1809+ y Windows 11 en x86_64. Usa el MSI para el trabajo normal en Windows. Usa WSL2 solo cuando tus archivos, agentes y toolchains ya vivan dentro de Linux.

El MSI está firmado con la identidad de editor StriveX. Para verificar un MSI descargado antes de ejecutarlo:

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

Status debería ser Valid. SmartScreen puede seguir apareciendo mientras se construye la reputación del certificado.

Instalar Paneflow con el MSI

1. Abre la página de descarga o la última release de GitHub.

2. Descarga el MSI de Windows:

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

3. Ejecuta el instalador. El MSI instala Paneflow como una app estándar de Windows, añade un acceso directo al menú Inicio y expone paneflow en el PATH.

4. Abre Paneflow desde el menú Inicio.

5. Abre una nueva ventana de PowerShell y verifica el comando:

paneflow --version

Si el comando muestra una versión, el MSI y la entrada en PATH funcionan.

Los paneles nuevos usan tu shell configurado. Si no hay shell configurado, Paneflow intenta PowerShell 7, Windows PowerShell, %ComSpec% y luego cmd.exe. Cambia el shell predeterminado en Settings.

Matriz de Windows soportado

El runtime de Windows de Paneflow usa Win32, DirectX, ConPTY y named pipes. La app renderiza controles nativos de Windows, no una envoltura Electron.

Motor de terminal

A partir de Paneflow 0.8.1, la compilación oficial para Windows x64 MSVC selecciona por defecto el motor libghostty-vt de Ghostty, fijado a una versión concreta y enlazado estáticamente, para las sesiones nuevas cuando terminal.backend se omite o está en auto. Paneflow conserva su propio renderizador GPUI y su capa ConPTY/de sesión; libghostty-vt gestiona el análisis VT, el estado del terminal y la codificación de entrada. El valor alacritty permite volver explícitamente a Alacritty. Los targets de Windows ARM64 y GNU, y las compilaciones personalizadas sin la función nativa de Ghostty, siguen usando Alacritty. El cambio se aplica a las sesiones nuevas; las sesiones abiertas conservan su motor actual.

Windows nativo o WSL2

Usa el MSI nativo cuando quieras integración con Windows: inicio desde el menú Inicio, selector de archivos de Windows, notificaciones, controles de ventana nativos, configuración del PATH y actualizador en la app.

Usa WSL2 cuando tus agentes, repositorios, gestores de paquetes y personalización de shell vivan en una distribución Linux. En ese caso, instala el build Linux dentro de WSL2 y deja que WSLg muestre la ventana.

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

Usar WSL dentro de un panel de Paneflow no es lo mismo que lanzar Paneflow desde WSL. Lanza la app nativa desde el menú Inicio o desde un shell nativo de Windows.

Limitaciones conocidas en Windows

• Windows Defender SmartScreen puede aparecer mientras el certificado de firma gana reputación. Verifica la release y el editor antes de ejecutar el MSI.
• cmd.exe no emite marcadores OSC 7 del directorio actual, así que el comportamiento de paneles consciente del cwd es más débil ahí. Prefiere PowerShell 7, Windows PowerShell, Git Bash o WSL.
• RDP, los lanzamientos desde dev containers y los lanzamientos de la app nativa desde WSL2 pueden encontrar límites upstream de GPUI o gráficos de Windows.
• Los IME CJK y algunos comportamientos ConPTY de Ctrl+C todavía tienen casos límite específicos de Windows.

Para las notas de Windows de más bajo nivel, conserva el documento Windows del repo de la app como fuente de verdad.

Actualizar y desinstalar

Usa el actualizador de la app o ejecuta de nuevo el MSI más reciente. El actualizador selecciona el MSI de Windows correcto, lo verifica, guarda la sesión actual y delega la actualización a Windows Installer.

Desinstala Paneflow desde la configuración de Windows. La desinstalación elimina la app, pero conserva la configuración de usuario en %APPDATA%\paneflow\paneflow.json. Los binarios auxiliares también pueden vivir en %LOCALAPPDATA%\paneflow\bin.