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

Windows ベータ

Preview docs describe unreleased preview builds. Stable docs remain at /docs/.

ネイティブ Windows 対応は実験的ベータです。

Windows 上の Herdr は、Herdr が本来前提としていた Unix の PTY モデルではなく、ConPTY と Windows のプロセス/ランタイム挙動を使います。Herdr の機能には Windows にきれいに対応付くものもあれば、そうでないものもあります。このプレビューは、すべての Linux/macOS 機能が Windows で完全にサポートされることを約束するものではありません。

ベータの目的は実際の使用から学ぶことです: インストールの成功率、ペインの信頼性、エージェントのワークフロー、バグの量、不足している機能、そして Windows ユーザーが Herdr から十分な価値を得られているかどうか。そのフィードバックに基づき、Windows 対応は安定版に昇格するか、成熟するまでプレビュー限定のままか、メンテナンスコストに見合わなければ縮小される可能性があります。

ネイティブ Windows ベータビルドは PowerShell でインストールします:

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

Windows ベータビルドはプレビューチャンネルでのみ提供されます。Windows では Herdr が設定を変更せずにデフォルトでプレビューを使います。インストーラーはリリースを %USERPROFILE%\.herdr\packages\standalone\releases に保存し、%LOCALAPPDATA%\Programs\Herdr\bin を現在のリリースに向け、実行中のプロセスがアップデートを妨げないよう少数の古いリリースを保持します。

内部ベータテスト向けに、HERDR_MANIFEST_URL でインストーラーを Herdr の安定版/プレビューマニフェストではなくカスタムマニフェストに向けられます。

ベータでサポート

機能	状況
ローカル永続セッション	ベータ
ConPTY によるネイティブペイン	ベータ
Windows Terminal / PowerShell アプリからのアタッチ	ベータ
`cmd.exe` ペイン	ベータ
起動時 cwd とワークスペースラベル	ベータ
ペイン起動時の cwd	ベータ
エージェントコマンドの発見	ベータ
エージェントのセルフレポートインテグレーション	ベータ
エージェントのプロセスツリー検出	ベータ
既知の cwd からの Git/worktree 検出	ベータ
プラグイン	プレビュー
ペイン画面履歴	ベータ
ネストされた起動のオーバーライド	ベータ

Windows のエージェントプロセス検出は、ペインのシェルの子孫プロセスをスキャンし、直接のエージェントと一般的なコマンドラッパーを認識します。Codex、Claude などのエージェントには有用ですが、Unix のフォアグラウンドプロセスグループ検出と同じものではありません。

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

部分的なサポート

機能	状況
シェルで `cd` した後のライブ cwd	部分的
シェルインテグレーション/OSC7 によるライブ cwd	ベータ
エージェントへのクリップボード画像貼り付け	未検証
CJK の隠れカーソル表示	ベータ
Kitty graphics のレンダリング	未検証

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

Windows Terminal は特定のエージェント向けに画像貼り付け経路をサポートしているかもしれませんが、Herdr 自身のクリップボード画像リーダーはまだ Windows に配線されていません。Windows のクリップボードブリッジが実装・テストされるまで、alt+v の画像貼り付けは未検証として扱ってください。リモートクリップボードの画像ブリッジは別機能で、引き続き Unix/macOS の herdr --remote に紐づいています。

Kitty graphics は実験的なままで、まだ Windows でのサポートを謳っていません。Windows Terminal での画像レンダリングを特にテストしているのでない限り、experimental.kitty_graphics = false のままにしてください。

既知の注意点

カーソル描画

Windows のターミナルは ConPTY 経由で Herdr を実行するため、フルスクリーン再描画中にネイティブの端末カーソルがちらついたり、ジャンプしたり、古い位置を一瞬表示したりすることがあります。Herdr のデフォルト host_cursor = "auto" は、ネイティブ Windows ビルドと WSL では Herdr のカーソルを端末セルの内容として描画し、それ以外の Linux と macOS ではネイティブの端末カーソルを使い続けます。Windows でのトレードオフは、外側ターミナルのネイティブな点滅、形状、カーソル色の代わりに、Herdr 内で安定した非点滅カーソルを表示することです。

ネイティブ Windows または WSL で外側ターミナルのカーソルに戻すには、次を設定してください:

[ui]
host_cursor = "native"

キーボードとマウス

Windows のターミナルは、修飾キー付きのキーをすべて同じ形で報告するわけではありません。Herdr は Windows Terminal と Windows 上の Alacritty ではマウス報告と ctrl+j を保持しますが、shift+enter は外側ターミナルが修飾付き Enter として区別して報告する場合にだけ動作します。Windows またはターミナルがそれを通常の Enter として報告する場合、Herdr は通常の Enter を転送します。

コピーと貼り付け

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

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

Windows ベータで未サポート

機能	状況
ダイレクトターミナルアタッチ	未サポート
Windows バイナリからの `herdr --remote`	未サポート
ライブサーバーハンドオフ	未サポート
Unix ファイルディスクリプタのハンドオフ	未サポート
Unix フォアグラウンドプロセスグループ	未サポート
リモートクリップボード画像ブリッジ	未サポート
プレフィックスによる入力ソース切り替え	未サポート
署名済みバイナリ / SmartScreen 回避	未サポート

Windows からのリモート作業は、サーバーに SSH してそこで herdr を実行してください:

ssh you@server
herdr

このモードでは Herdr はリモートホスト上で動きます。ネイティブ Windows の herdr --remote はベータの範囲外です。

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

Windows ベータの問題を報告する

以下を含めてください:

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