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.11.0"
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.11.0-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

Desde Paneflow 0.10.0, la compilación oficial para Windows x64 MSVC emula cada panel con el motor libghostty-vt de Ghostty, fijado a una versión concreta y enlazado estáticamente. Es el único motor de terminal: no hay un segundo parser, ni fallback en tiempo de ejecución, ni ajuste para elegir uno. 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. Una clave terminal.backend que quede en paneflow.json desde una versión anterior se ignora. Windows ARM64 no tiene archivo de motor fijado y no es un target publicado.

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.11.0
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.