Windows に Paneflow をインストール

Paneflow は Windows 10 バージョン 1809 以降と Windows 11 の x86_64 (Intel または AMD) でネイティブに動作します。Windows の プロジェクトには MSI を使ってください。リポジトリとエージェントが Linux ディストリビューション内にある場合は、後述の WSL2 の項目を参照してください。

MSI で Paneflow をインストール

1. Paneflow のダウンロードページ または GitHub の最新 Paneflow リリース を開きます。
2. paneflow-0.17.7-x86_64-pc-windows-msvc.msi をダウンロードします。
3. 後述の手順で署名を確認してから MSI を実行します。 Windows の管理者権限の確認を承認します。
4. ターミナルから paneflow を使えるよう、PATH Environment Variable を選択したままにします。標準のインストール先は %ProgramFiles%\PaneFlow です。
5. インストールを完了し、スタートメニューから PaneFlow を開きます。

Rust やビルドツールは不要です。CLI エージェントは別途インストールし、 はじめにのガイド に沿ってプロジェクトを開き、エージェントを実行してください。

MSI の署名を確認

PowerShell でダウンロードした MSI のあるフォルダーを開き、実行します。

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

状態は Valid、証明書のサブジェクトに記載された発行元は Strivex であることを確認します。ファイルが見つからない場合は、フォルダーと ファイル名を確認してください。署名が無効、または発行元が異なる場合は、 続行する前にリリースページから新しいコピーをダウンロードしてください。

署名済みのファイルでも、SmartScreen の評価に関する警告が表示される 場合があります。先に署名と発行元を確認してください。組織が管理する PC で インストールがブロックされる場合は、管理者に問い合わせてください。

インストールを確認

新しい PowerShell ウィンドウを開き、実行します。

paneflow --version

インストール済みのバージョンが表示されることを確認します。 スタートメニューからアプリが開くことも確認してください。

paneflow が認識されない場合は、すべてのターミナルウィンドウを閉じ、 スタートメニューから PowerShell を開き直してください。まだ使えない場合は、 標準のインストール先を指定します。

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

別のフォルダーを選んだ場合は、そのパスを使ってください。フルパスで 実行できる場合は、当面そのパスを使い、MSI を再実行して PATH Environment Variable を復元してください。実行ファイルがない場合は、 インストール先を確認するか、再インストールしてください。

新しいペインは Paneflow の Settings で選択したシェルを使います。 未設定の場合、PowerShell 7、Windows PowerShell、%ComSpec%、 cmd.exe の順に試します。

Windows のバージョンと要件

ネイティブ Windows か WSL2 か

Windows のファイル、シェル、エージェントにはネイティブアプリを使います。 ペイン内で WSL を使う場合も、アプリはスタートメニューか Windows シェルから 起動してください。

リポジトリ、エージェント、ツールが Linux 内にインストールされている場合は、 WSL2 内で Linux 版を使います。WSLg が Linux アプリのウィンドウを表示します。 Microsoft の WSLg 設定手順 で WSL2 と GUI サポートを設定し、Linux ターミナルから Linux のインストールガイド に従ってください。 ディストリビューションとアーキテクチャに合うパッケージを選びます。 WSL1 では WSLg による Linux GUI アプリの表示はできません。

Windows の既知の注意点

• ペインの現在のディレクトリを追跡するには、cmd.exe より PowerShell または Git Bash を使ってください。cmd.exe は OSC 7 でディレクトリの 変更を通知しません。
• リモートデスクトップ、WSL2 や開発コンテナーからの起動、CJK 入力方式、 一部の Ctrl+C の動作には、Windows 固有の制限がある場合があります。 最新版でも問題が続く場合は、Paneflow のバージョン、Windows のビルド、 シェル、再現手順を添えて Windows の問題を報告 してください。

ターミナル バックエンド

Ghostty のターミナルエンジン libghostty-vt は Windows 版に含まれています。 別途インストールしたり、バックエンドを選んだりする必要はありません。 paneflow.json に残った古い terminal.backend キーは無視されます。 移行の経緯は Windows 版 Paneflow での Ghostty の使用 を参照してください。

更新とアンインストール

更新前にファイルを保存し、実行中のコマンドを終了してください。 MSI は更新中に実行中のターミナルセッションを停止することがあります。

アプリ内の更新機能を使うか、 paneflow-0.17.7-x86_64-pc-windows-msvc.msi をダウンロードして実行します。 ダウンロードの破損が報告されたり、同じバージョンが再起動したりする場合は、 最新の MSI を手動でインストールしてください。0.7.7/0.7.8 と 0.17.0/0.17.1 の既知の更新エラーにも同じ手順を使います。 中間バージョンのインストールは不要です。

Windows の設定から Paneflow をアンインストールします。インストール済みの アプリは削除されますが、%USERPROFILE%\.paneflow は保持されます。 paneflow.json、保存済みセッション、管理対象の worktree、 bin 配下の補助実行ファイルも残ります。