Windows に Paneflow をインストール

Windows 10 または 11 に Paneflow のネイティブ MSI をインストールし、PATH エントリを確認し、WSL2 が適している場面を判断します。

2026年7月21日に更新

Paneflow は Windows 10 1809+ と Windows 11 の x86_64 向けにネイティブ Windows MSI を配布しています。通常の Windows 作業には MSI を使ってください。ファイル、エージェント、toolchain がすでに Linux 側にある場合だけ WSL2 を使います。

paneflow-0.8.2-x86_64-pc-windows-msvc.msi をダウンロードして実行し、スタートメニューから Paneflow を開き、新しい PowerShell ウィンドウで paneflow コマンドを確認します。

MSI は発行元 StriveX の ID で署名されています。実行前にダウンロードした MSI を検証するには:

powershell

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

Status は Valid になるはずです。証明書の reputation が蓄積されるまで、 SmartScreen がまだ表示されることがあります。

MSI で Paneflow をインストール

ダウンロードページまたは最新の GitHub release を開きます。
Windows MSI をダウンロードします:

msi

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

インストーラを実行します。MSI は Paneflow を標準的な Windows アプリとしてインストールし、スタートメニューのショートカットを追加し、 PATH に paneflow を公開します。
スタートメニューから Paneflow を開きます。
新しい PowerShell ウィンドウを開き、コマンドを確認します:

powershell

paneflow --version

バージョンが表示されれば、MSI と PATH エントリは動作しています。

新しいペインは設定済みのシェルを使います。シェルが未設定の場合、 Paneflow は PowerShell 7、Windows PowerShell、%ComSpec%、cmd.exe の順にフォールバックします。デフォルトシェルは Settings で変更します。

対応 Windows マトリクス

環境	状態	メモ
Windows 11 x86_64	対応	推奨されるネイティブ経路。
Windows 10 1809+ x86_64	対応	DirectX 11 feature level 10+ に対応した GPU ドライバが必要。
Windows 10 1809 より前	非対応	ネイティブ build はより新しい Windows のターミナル API とグラフィック API に依存します。
Windows on ARM64	まだ未公開	Windows release artifact は x86_64 のみです。
WSL2 + WSLg	ユースケース依存	Linux toolchain が source of truth の場合に使います。ネイティブ Windows アプリを WSL2 や dev container のホストシェルから起動しないでください。

Paneflow の Windows runtime は Win32、DirectX、ConPTY、named pipes を使います。アプリは Electron の殻ではなく、ネイティブ風の Windows コントロールを描画します。

ターミナルバックエンド

Paneflow 0.8.1 以降、公式 Windows x64 MSVC ビルドでは、 terminal.backend が省略されているか auto の場合、新しいセッションに固定バージョンを静的リンクした Ghostty の libghostty-vt エンジンがデフォルトで選択されます。Paneflow は独自の GPUI レンダラーと ConPTY/セッションレイヤーを維持し、libghostty-vt が VT 解析、ターミナル状態、入力エンコードを処理します。alacritty に設定すると、明示的に Alacritty へ戻せます。Windows ARM64 および GNU ターゲットと、ネイティブ Ghostty 機能を含まないカスタムビルドは Alacritty のままです。この変更は新しいセッションにのみ適用され、実行中のセッションは現在のエンジンを維持します。

ネイティブ Windows か WSL2 か

Windows との統合が欲しい場合はネイティブ MSI を使います: スタートメニュー起動、Windows ファイルピッカー、通知、ネイティブウィンドウコントロール、PATH 設定、アプリ内 updater。

エージェント、リポジトリ、パッケージマネージャ、シェル設定が Linux ディストリビューション内にある場合は WSL2 を使います。その場合は Linux build を WSL2 内にインストールし、WSLg にウィンドウを表示させます。

bash

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

Paneflow のペイン内で WSL を使うことと、Paneflow 自体を WSL から起動することは別物です。ネイティブアプリはスタートメニューかネイティブ Windows シェルから起動してください。

Windows の既知の注意点

署名証明書の reputation が蓄積されるまで、Windows Defender SmartScreen が表示されることがあります。MSI を実行する前に release と発行元を確認してください。
cmd.exe は現在ディレクトリの OSC 7 マーカーを送らないため、cwd を使うペイン挙動は弱くなります。PowerShell 7、Windows PowerShell、 Git Bash、WSL を優先してください。
RDP、dev container からの起動、WSL2 からのネイティブアプリ起動では、 upstream GPUI または Windows graphics のエッジケースに当たることがあります。
CJK IME と一部の ConPTY Ctrl+C 挙動には、まだ Windows 固有のエッジケースがあります。

より低レベルな Windows notes は、 app repo の Windows document を source of truth としてください。

更新とアンインストール

アプリ内 updater を使うか、最新の MSI を再実行します。Updater は一致する Windows MSI を選び、検証し、現在のセッションを保存して、アップグレードを Windows Installer に渡します。

Paneflow 0.7.7 または 0.7.8 から更新していて、アプリ内 updater が corrupt または tampered download を報告する場合は、0.7.9 を MSI から一度手動でインストールしてください。その後の Windows 更新は Paneflow 内から再び動作するはずです。

Paneflow は Windows Settings からアンインストールします。アンインストールしてもユーザー設定 %APPDATA%\paneflow\paneflow.json は保持されます。補助バイナリは %LOCALAPPDATA%\paneflow\bin にも置かれることがあります。