Instalar Paneflow en Windows

Instala Paneflow en Windows con el MSI firmado. Verifica la instalación, recupera el comando en el terminal y elige la versión Linux para WSL2.

Última actualización el 2 de octubre de 2026

Paneflow funciona de forma nativa en Windows 10 versión 1809 o posterior y Windows 11, con procesadores x86_64 (Intel o AMD). Instala el MSI para proyectos de Windows. Si tus repositorios y agentes están en una distribución Linux, consulta la sección de WSL2.

Instalar Paneflow con el MSI

Abre la página de descarga de Paneflow o la última versión de Paneflow en GitHub.
Descarga paneflow-0.17.7-x86_64-pc-windows-msvc.msi.
Verifica la firma como se indica más abajo y ejecuta el MSI. Acepta la solicitud de permisos de administrador de Windows.
Mantén PATH Environment Variable seleccionado para usar paneflow desde un terminal. La carpeta predeterminada es %ProgramFiles%\PaneFlow.
Completa la instalación y abre PaneFlow desde el menú Inicio.

No necesitas Rust ni herramientas de compilación. Instala tus agentes CLI por separado y sigue la guía de primeros pasos para abrir un proyecto y ejecutar un agente.

Verificar la firma del MSI

En PowerShell, abre la carpeta que contiene el MSI descargado y ejecuta:

powershell

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

El estado debe ser Valid y el titular del certificado debe identificar a Strivex como editor. Si no se encuentra el archivo, comprueba la carpeta y el nombre. Si la firma no es válida o el editor es distinto, descarga otra copia desde la página de la versión antes de continuar.

SmartScreen puede mostrar una advertencia de reputación incluso para un archivo firmado. Comprueba primero la firma y el editor. Si un equipo gestionado por tu organización bloquea la instalación, contacta con su administrador.

Verificar la instalación

Abre una nueva ventana de PowerShell y ejecuta:

powershell

paneflow --version

El comando debe mostrar la versión instalada. Comprueba también que la aplicación se abre desde el menú Inicio.

Si paneflow no se reconoce, cierra todas las ventanas de terminal y vuelve a abrir PowerShell desde el menú Inicio. Si sigue sin encontrarse, prueba la ruta predeterminada:

powershell

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

Si elegiste otra carpeta, usa esa ruta. Si la ruta completa funciona, úsala mientras vuelves a ejecutar el MSI para restaurar PATH Environment Variable. Si falta el ejecutable, comprueba la carpeta de instalación o reinstala la aplicación.

Los paneles nuevos usan el shell elegido en Settings de Paneflow. Sin un shell configurado, Paneflow prueba PowerShell 7, Windows PowerShell, %ComSpec% y después cmd.exe.

Versiones de Windows y requisitos

Entorno	Disponibilidad	Requisitos
Windows 11 x86_64	MSI nativo	Controlador GPU funcional con DirectX 11, nivel de característica 10 o superior.
Windows 10 1809+ x86_64	MSI nativo	Los mismos requisitos gráficos.
Windows anterior a 10 1809	No compatible	Actualiza Windows antes de instalar.
Windows ARM64	Sin MSI ARM64	La versión de Windows solo incluye un instalador x86_64.
WSL2 con WSLg	Versión Linux	Windows 10 compilación 19044+ o Windows 11 y un controlador GPU compatible.

Windows nativo o WSL2

Usa la aplicación nativa para archivos, shells y agentes de Windows. Iníciala desde el menú Inicio o un shell de Windows, incluso cuando uses WSL dentro de un panel.

Usa la versión Linux en WSL2 si tus repositorios, agentes y herramientas están instalados en Linux. WSLg muestra la ventana de la aplicación Linux. Configura WSL2 y el soporte gráfico siguiendo las instrucciones de WSLg de Microsoft y luego sigue la guía de instalación en Linux desde tu terminal Linux. Elige el paquete para tu distribución y arquitectura. WSL1 no puede mostrar aplicaciones gráficas de Linux mediante WSLg.

Limitaciones conocidas en Windows

Usa PowerShell o Git Bash en lugar de cmd.exe para seguir el directorio actual de un panel. cmd.exe no informa de cambios de directorio mediante OSC 7.
Escritorio remoto, los inicios desde WSL2 o contenedores de desarrollo, los métodos de entrada CJK y algunos comportamientos de Ctrl+C pueden tener limitaciones específicas de Windows. Si un problema persiste en la última versión, informa de un problema en Windows con la versión de Paneflow, la compilación de Windows, el shell y los pasos para reproducirlo.

Motor de terminal

El motor de terminal libghostty-vt de Ghostty está incluido en la versión de Windows. No necesitas instalarlo ni elegir un motor. Una clave antigua terminal.backend en paneflow.json se ignora. Lee cómo Paneflow usa Ghostty en Windows para conocer la historia de la migración.

Actualizar y desinstalar

Antes de actualizar, guarda los archivos y termina los comandos activos. El MSI puede detener las sesiones de terminal en curso durante la actualización.

Usa el actualizador de la aplicación o descarga y ejecuta paneflow-0.17.7-x86_64-pc-windows-msvc.msi. Si una actualización informa de una descarga dañada o reinicia la misma versión, instala el último MSI manualmente. Esto también se aplica a los fallos conocidos de 0.7.7/0.7.8 y 0.17.0/0.17.1. No necesitas instalar una versión intermedia.

Desinstala Paneflow desde la configuración de Windows. Se elimina la aplicación instalada, pero se conserva %USERPROFILE%\.paneflow, incluidos paneflow.json, las sesiones guardadas, los worktrees gestionados y los ejecutables auxiliares de bin.