このページの翻訳は LLM によって生成されています。誤りに気づいた場合は GitHub で issue を開いてお知らせください。

Windows サポート

ネイティブ Windows 対応は正式に提供されています。

Windows 上の Herdr は、Herdr が本来前提としていた Unix の PTY モデルではなく、ConPTY と Windows のプロセス/ランタイム挙動を使います。主要なワークフローの多くはサポートされていますが、一部の機能は Linux/macOS と異なるか、プラットフォームに依存します。残っている差を埋める間、Windows 固有の修正がより多く提供されることがあります。

Windows に Herdr をネイティブインストールするには PowerShell を使います:

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Windows ビルドは安定版とプレビューの両方のアップデートチャンネルで提供されます。新規インストールはデフォルトで安定版を使い、通常の利用には安定版を推奨します。既存のプレビューインストールは、herdr channel set stable を実行するまでプレビューに残ります。古いプレビュービルドでこのコマンドが拒否される場合は、プレビューのまま一度 herdr update を実行してから再試行してください。プレビューでは master からの新しく検証の少ない修正を受け取れますが、リグレッションが起きる可能性があります。そのトレードオフを望む場合に限り、herdr channel set preview でオプトインしてください。

インストーラーはリリースを %USERPROFILE%\.herdr\packages\standalone\releases に保存し、%LOCALAPPDATA%\Programs\Herdr\bin を現在のリリースに向け、実行中のプロセスがアップデートを妨げないよう少数の古いリリースを保持します。

内部テスト向けに、HERDR_MANIFEST_URL でインストーラーを Herdr の安定版/プレビューマニフェストではなくカスタムマニフェストに向けられます。カスタムプレビューマニフェストでは HERDR_CHANNEL=preview も設定してください。

Windows でサポート

機能	状況
ローカル永続セッション	サポート済み
ConPTY によるネイティブペイン	サポート済み
Windows Terminal / PowerShell アプリからのアタッチ	サポート済み
Linux/macOS ホストへの `herdr --remote`	サポート済み
リモートクリップボード画像と画像ファイルのドロップ	サポート済み
`cmd.exe` ペイン	サポート済み
ネイティブのキーボード/マウス入力	サポート済み
起動時 cwd とワークスペースラベル	サポート済み
ペイン起動時の cwd	サポート済み
エージェントコマンドの発見	サポート済み
対応済みエージェントのセルフレポートインテグレーション	サポート済み
エージェントのプロセスツリー検出	サポート済み
既知の cwd からの Git/worktree 検出	サポート済み
システム通知と MP3 サウンド	サポート済み
プラグイン	プレビュー
ペイン画面履歴	サポート済み
ネストされた起動のオーバーライド	サポート済み

ローカル永続セッションは、クライアントをデタッチした後やターミナルウィンドウを閉じた後も動作し続けます。Windows OpenSSH から起動したサーバーとペインプロセスもログアウト後に存続します。再接続するには herdr をもう一度実行してください。

Windows のエージェントプロセス検出は、ペインのシェルの子孫プロセスをスキャンし、npm/Node や Git Bash のプロセスチェーンを含む直接のエージェントと一般的なコマンドラッパーを認識します。Git Bash から起動したエージェントはエミュレートされた exec 境界を越えて追跡されますが、Unix のフォアグラウンドプロセスグループ検出と同じものではありません。

Windows でインテグレーションをインストールできるのは、現在 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI、Antigravity CLI です。利用可能な対象は Unix より少なく、インストール形式が Windows で未対応のインテグレーションは表示されないか拒否されます。Devin CLI のプロセス検出とスクリーン検出は Windows でも動作しますが、オプションのセッション識別フックは現在インストールできません。

プラグインは、プレビューとしてマニフェストのプラットフォームに windows をサポートします。GitHub インストール、ローカルリンク、ビルドコマンド、アクション、イベント、プラグインペインは Windows ではベストエフォートです。コマンドは argv 形式で Windows 互換である必要があります。npm、bun、node のような Node パッケージの shim は PATH にあれば動作するはずですが、sh や Bash を使う Unix 専用の例には Windows 向けの代替が必要です。プラットフォームフィルターは、未サポートのビルドコマンドをスキップし、未サポートのアクションやペインには platform_unsupported を返します。

部分的なサポート

機能	状況
シェルで `cd` した後のライブ cwd	部分的
シェルインテグレーション/OSC7 によるライブ cwd	サポート済み
ローカルペインのエージェントへのクリップボード画像貼り付け	ターミナル/エージェント依存
CJK IME の変換候補位置	部分的
プレフィックス入力ソース切り替え (韓国語 IME)	部分的
Kitty graphics のレンダリング	ターミナル依存
ホストカーソル描画	部分的

Herdr はペインを正しいディレクトリで起動でき、Herdr を起動したディレクトリから最初のワークスペースを作成できます。起動後の PowerShell のディレクトリ変更は別問題です: Herdr が調べられるプロセスのフィールドは、その後の論理的な cd の変化を確実には追跡しません。ライブ cwd の報告には Herdr インテグレーションかプロンプトのシェルインテグレーションを使ってください。

herdr --remote では、設定されたリモート画像貼り付けキーが Windows のクリップボード画像を読み取り、リモートホストへ転送します。Windows Terminal にローカル画像ファイルをひとつドロップした場合も、そのファイルを転送してリモート側のパスを貼り付けます。

プレフィックス入力ソース切り替えは、韓国語 IME 向けのオプトイン実験機能として利用できます。プレフィックスコマンドが有効な間はハングル入力を英語に切り替え、終了後に以前のモードへ戻します:

[experimental]
switch_ascii_input_source_in_prefix = true

その他の Windows IME はまだこのオプションに対応していません。設定を参照してください。

Windows 上の一部のエージェントは ctrl+v を受け取り、クリップボード画像を直接読み取れます。Herdr 自身のクリップボード画像リーダーはローカルのネイティブ Windows ペインには配線されていないため、エージェント自身による画像貼り付けはターミナルとエージェントに依存します。alt+v などエージェントの画像貼り付けショートカットによって、Herdr が管理するローカルクリップボードブリッジが追加されるわけではありません。リモートクリップボード画像ブリッジは、Linux/macOS ホストへの herdr --remote で別途サポートされます。

Kitty graphics は実験的機能で、外側のターミナルに依存します。experimental.kitty_graphics = true の場合、Herdr は他のプラットフォームと同様に Windows でも Kitty graphics protocol の出力を送ります。この経路は Windows の WezTerm から WSL 内の Herdr をホストする構成で動作確認されていますが、ネイティブ Windows のターミナルと ConPTY の組み合わせはすべて検証済みではありません。Windows Terminal は Herdr が使う Kitty graphics 経路を提供しません。外側のターミナルが Kitty graphics に対応しており、その組み合わせをテストする場合を除いて、このオプションは無効のままにしてください。

既知の注意点

カーソル描画

Herdr はネイティブ Windows のペインに ConPTY を使用します。現在の Windows のターミナルカーソル処理では、マルチプレクサーが画面を再描画している途中のカーソル位置が表示されることがあります。そのため、出力中にネイティブカーソルがちらついたり、ジャンプしたり、古い位置に一瞬残ったりします。この挙動は他のネイティブ Windows ターミナルマルチプレクサーや、VT カーソル位置を直接連続更新するテストでも再現するため、ネイティブカーソルの挙動を維持したまま Herdr 側で完全に解消することはできません。

視覚的な安定性を優先するため、デフォルトの host_cursor = "auto" はネイティブ Windows と WSL で Herdr のカーソルを端末セルの内容として描画します。それ以外の Linux と macOS クライアントでは、引き続きネイティブの端末カーソルを使います。Windows の描画カーソルは安定していて点滅しませんが、外側ターミナルのネイティブな点滅、形状、カーソル色は反映されません。

描画カーソルは、Windows が IME の変換中テキストや候補ウィンドウの位置決めに使う実際のカーソルではありません。そのため、韓国語、日本語、中国語 IME の UI が誤った位置に表示されることがあります。この問題が発生する場合は、外側ターミナルのカーソルを有効にしてください:

[ui]
host_cursor = "native"

ネイティブモードでは IME の基準位置が正しくなりますが、出力中にカーソルのちらつき、ジャンプ、古い位置の残像が再び発生することがあります。これは現在の Windows 対応における互換性上のトレードオフです。

キーボードとマウス

Windows のターミナルは、修飾キー付きのキーをすべて同じ形で報告するわけではありません。Herdr は Windows Terminal と Windows 上の Alacritty でマウス報告と ctrl+j を保持します。ネイティブ Windows の入力経路では、物理キーの押下、リピート、解放、単独の Escape、shift+enter もデフォルトの ConPTY ペインまで保持されます。ただし修飾キーは、外側のターミナルが区別可能なキーイベントとして報告する必要があります。shift+enter が通常の Enter として報告された場合、Herdr が転送できるのも通常の Enter だけです。

古い Windows 10 ビルドのシステム ConPTY は、Kimi や Pi などのエージェントが使用する Kitty キーボードプロトコルのシーケンスを失うため、Windows パッケージには Microsoft の最新のアプリローカル ConPTY ランタイムが含まれます。バンドル版ランタイムとの互換性問題を診断する場合に限り、Herdr を起動する前に HERDR_WINDOWS_CONPTY=system を設定してください。

コピーと貼り付け

Herdr のペインテキストコピーは Windows で動作します。ペイン内でテキストをドラッグ選択すると Herdr 経由でコピーされます。

テキストの貼り付けには Windows Terminal で ctrl+shift+v を使ってください。複数行テキストの貼り付けはブラケット付きなので、シェルやエージェントのプロンプトは各行を個別に送信せず、ひとつの貼り付けとして受け取ります。shift を押しながら右クリックすると、クリックを Herdr に送らずに外側ターミナルの貼り付けアクションを使えます。

Windows で未サポート

機能	状況
ダイレクトターミナルアタッチ (`herdr terminal attach`)	未サポート
`herdr --remote` の接続先としての Windows	未サポート
ライブサーバーハンドオフ	未サポート
Unix ファイルディスクリプタのハンドオフ	未サポート
Unix フォアグラウンドプロセスグループ	未サポート
ローカルのネイティブペインでの Herdr クリップボード画像ブリッジ	未サポート
署名済みバイナリ / SmartScreen 回避	未サポート

Windows Terminal からは、Linux や macOS と同じリモートコマンドを使います:

herdr --remote workbox

接続先ホストは Linux または macOS である必要があります。Herdr はインストール済みの Windows OpenSSH クライアントと SSH 設定を使います。Windows OpenSSH では Herdr の Unix コントロールソケットによる接続再利用を使わないため、セットアップ中の繰り返しプロンプトを避けるには Windows の ssh-agent による鍵認証を推奨します。

Windows のアップデートは Windows インストーラー経由で行われ、バージョン付きインストールジャンクションを更新します。アップデート後は実行中の Herdr セッションを再起動してください。ライブハンドオフは Unix 専用です。

Windows の問題を報告する

以下を含めてください:

Herdr のバージョン。
Windows のバージョン。
ターミナルアプリ。
シェル (PowerShell、cmd など)。
名前付き HERDR_SESSION を使っていたかどうか。
関連する Herdr のログ。
正確な再現手順。