[{"data":1,"prerenderedAt":556},["ShallowReactive",2],{"content-/herdr-windows-beta-install":3,"all-pages-for-dir":554,"og-image-/herdr-windows-beta-install":555},{"id":4,"title":5,"body":6,"category":537,"concepts":538,"description":539,"extension":540,"meta":541,"navigation":542,"ogImage":538,"path":543,"project_name":544,"published":545,"publishedAt":546,"seo":547,"stem":548,"tags":549,"todo":538,"unpublished":545,"updatedAt":538,"__hash__":553},"pages/2026-07/2026-07-15/herdr-windows-beta-install.md","herdr を Windows ベータで導入した — AIコーディングエージェントの群れをターミナルで飼う",{"type":7,"value":8,"toc":518},"minimark",[9,13,27,30,62,67,74,81,90,99,103,106,111,161,168,172,175,178,188,192,233,237,245,248,261,264,283,287,290,294,300,329,332,336,339,349,352,356,362,375,379,388,394,401,404,431,438,442,445,451,465,468,471,505,508,514],[10,11,5],"h1",{"id":12},"herdr-を-windows-ベータで導入した-aiコーディングエージェントの群れをターミナルで飼う",[14,15,16,17,26],"p",{},"Claude Code と Codex を並走させる日が増えて、「今どのエージェントが手待ちなのか」をタブ切り替えで確認する時間が無視できなくなってきた。そこで、ターミナル内で複数のエージェントを束ねて状態を一覧できる ",[18,19,25],"a",{"href":20,"target":21,"rel":22},"https://herdr.dev/","_blank",[23,24],"noopener","noreferrer","herdr"," を Windows 11 に導入した。",[14,28,29],{},"先に結論を書く。",[31,32,33,43,46,59],"ul",{},[34,35,36,37,42],"li",{},"導入手順は",[18,38,41],{"href":39,"target":21,"rel":40},"https://herdr.dev/ja/docs/install/",[23,24],"公式ドキュメント","の PowerShell ワンライナーで足りる。世の中の記事を一通り調べたが、Windows についてはこれ以外の経路（パッケージマネージャ等）は現状ない",[34,44,45],{},"インストールスクリプト（install.ps1・465行）の中身も読んだ。管理者権限不要・ユーザー領域のみ・SHA256 検証ありの手堅い作りで、そのまま流してよい",[34,47,48,49,53,54,58],{},"ただし Windows 対応は",[50,51,52],"strong",{},"プレビュー限定のベータ","。SSH リモート接続（",[55,56,57],"code",{},"--remote","）が使えない等の制限があるので、ローカル専用と割り切って入れる",[34,60,61],{},"導入作業と検証は Claude Code に実行させた。本記事のログはその実物",[63,64,66],"h2",{"id":65},"herdr-とは-tmux-にエージェント監視が付いたもの","herdr とは — tmux にエージェント監視が付いたもの",[14,68,69,73],{},[18,70,25],{"href":71,"target":21,"rel":72},"https://github.com/ogulcancelik/herdr",[23,24]," は「agent multiplexer that lives in your terminal」を名乗る Rust 製の CLI ツールだ。GitHub スターは 16.5k、リリースは 70 回を数え、確認時点の最新は v0.7.3（2026-07-07）だった。ライセンスは AGPL-3.0 と商用のデュアル。",[14,75,76,77,80],{},"tmux と同じくペイン・タブ・セッションを永続化するが、herdr の中心はそこではない。",[50,78,79],{},"各ペインで動くエージェントの状態（idle / working / blocked / done）をサイドバーに常時表示する","のが売りだ。「3つの Claude Code を走らせて、どれが入力待ちで止まっているかを一目で知る」がやりたいことのすべてなら、tmux ではなく herdr が答えになる。",[14,82,83,84,89],{},"逆に言えば、エージェントを1つしか走らせない人や、ペイン分割だけが目的の人には tmux で足りる。",[18,85,88],{"href":86,"target":21,"rel":87},"https://www.shareuhack.com/en/posts/herdr-terminal-agent-multiplexer-guide-2026",[23,24],"Shareuhack のガイド","も「複数エージェントの状態をリアルタイムで知る必要があるか」を導入判断の軸に置いていて、これが一番納得感のある整理だった。",[14,91,92,93,98],{},"日本語圏でも Qiita に",[18,94,97],{"href":95,"target":21,"rel":96},"https://qiita.com/takish/items/5ef1eeee97e6e48404e3",[23,24],"入門記事（tmux 対応チートシート付き）","や zellij からの移行記があり、macOS / Linux での導入例は既にある。ただ Windows ベータでの導入記録は見当たらなかったので、この記事はそこを埋める。",[63,100,102],{"id":101},"世の中のベストプラクティス2026-07-時点の調査まとめ","世の中のベストプラクティス（2026-07 時点の調査まとめ）",[14,104,105],{},"導入前に公式ドキュメント・GitHub README・国内外の解説記事を読んで、共通して挙がっていた実践知をまとめる。",[107,108,110],"h3",{"id":109},"インストール経路は-os-ごとに1つ","インストール経路は OS ごとに1つ",[112,113,114,127],"table",{},[115,116,117],"thead",{},[118,119,120,124],"tr",{},[121,122,123],"th",{},"OS",[121,125,126],{},"経路",[128,129,130,141,151],"tbody",{},[118,131,132,136],{},[133,134,135],"td",{},"macOS",[133,137,138],{},[55,139,140],{},"brew install herdr",[118,142,143,146],{},[133,144,145],{},"Linux",[133,147,148],{},[55,149,150],{},"curl -fsSL https://herdr.dev/install.sh | sh",[118,152,153,156],{},[133,154,155],{},"Windows",[133,157,158],{},[55,159,160],{},"powershell -ExecutionPolicy Bypass -c \"irm https://herdr.dev/install.ps1 | iex\"",[14,162,163,164,167],{},"Windows だけチャネルが preview 固定で、",[55,165,166],{},"herdr channel set stable"," は安定版が出るまで拒否される。",[107,169,171],{"id":170},"tmux-の中で開かない","tmux の中で開かない",[14,173,174],{},"herdr を tmux のペイン内で起動するとエージェント検出が働かない。herdr は tmux の置き換えとして単体で使い、エージェントは herdr のペインで直接実行する。",[107,176,177],{"id":177},"エージェント統合を入れる",[14,179,180,183,184,187],{},[55,181,182],{},"herdr integration install claude"," のように、使うエージェントごとの統合を入れると状態検知の精度が上がる。統合なしでも画面解析で状態を推定するが、検知に数秒の遅延が出るとされる。対応エージェントは Claude Code / Codex / Copilot / Cursor / OpenCode など14種で、",[55,185,186],{},"herdr integration status"," で導入状況を確認できる。",[107,189,191],{"id":190},"設定は-configtoml運用の細かいコツ","設定は config.toml、運用の細かいコツ",[31,193,194,209,216,230],{},[34,195,196,197,200,201,204,205,208],{},"設定ファイルは ",[55,198,199],{},"~/.config/herdr/config.toml","（Windows では ",[55,202,203],{},"%APPDATA%\\herdr\\config.toml","）。",[55,206,207],{},"herdr --default-config"," でコメント付きテンプレートを出力してから編集する",[34,210,211,212,215],{},"設定変更後は ",[55,213,214],{},"herdr server reload-config"," で反映（サーバー再起動不要）",[34,217,218,219,222,223,204,226,229],{},"デタッチは ",[55,220,221],{},"prefix q","（プレフィックスは既定で ",[55,224,225],{},"Ctrl+B",[55,227,228],{},"herdr session stop"," はデタッチではなく完全停止なので取り違えない",[34,231,232],{},"dotfiles 管理に入れるのは config.toml だけ。ソケットやログなどのランタイムファイルは追跡しない",[63,234,236],{"id":235},"windows-ベータの現状と制限","Windows ベータの現状と制限",[14,238,239,244],{},[18,240,243],{"href":241,"target":21,"rel":242},"https://herdr.dev/docs/windows-beta/",[23,24],"公式の Windows beta ページ","によると、動くのはローカルの永続セッション、ConPTY 経由のネイティブペイン、Windows Terminal / PowerShell からのアタッチ、cmd.exe ペインまでだ。",[14,246,247],{},"使えないものは次の通り。",[31,249,250,255,258],{},[34,251,252,254],{},[55,253,57],{},"（SSH 経由のリモートアタッチ）",[34,256,257],{},"ライブサーバーハンドオフ（更新時の無停止引き継ぎ）",[34,259,260],{},"Unix ファイルディスクリプタハンドオフ",[14,262,263],{},"細かい注意も書かれている。",[31,265,266,273,276],{},[34,267,268,269,272],{},"テキストのペーストは ",[55,270,271],{},"Ctrl+Shift+V"," を使う",[34,274,275],{},"Shift+Enter の扱いはターミナル実装に依存する",[34,277,278,279,282],{},"既定のカーソル描画設定（",[55,280,281],{},"host_cursor = \"auto\"","）ではカーソルがちらつくことがある",[63,284,286],{"id":285},"実際の導入ログwindows-11","実際の導入ログ（Windows 11）",[14,288,289],{},"ここからが実際にやった作業だ。判断は人間、実行と検証は Claude Code という分担で進めた。",[107,291,293],{"id":292},"_1-installps1-の中身を確認してから流す","1. install.ps1 の中身を確認してから流す",[14,295,296,299],{},[55,297,298],{},"irm ... | iex"," 形式のワンライナーは中身を見ずに流したくないので、先にスクリプトをダウンロードして読んだ。465行で、要点は次の通り。",[31,301,302,313,320,326],{},[34,303,304,305,308,309,312],{},"リリースマニフェスト（preview.json）を取得し、",[55,306,307],{},"herdr.exe"," をダウンロードして ",[50,310,311],{},"SHA256 チェックサムを検証","する",[34,314,315,316,319],{},"配置先は ",[55,317,318],{},"%USERPROFILE%\\.herdr\\packages\\standalone\\releases\\\u003Cバージョン>","。バージョン別フォルダに置き、旧リリースを3世代保持する",[34,321,322,325],{},[55,323,324],{},"%LOCALAPPDATA%\\Programs\\Herdr\\bin"," をジャンクションで最新リリースに向け、ユーザー PATH の先頭に追加する",[34,327,328],{},"管理者権限は不要。書き込みはすべてユーザー領域で、インストーラー自身が管理していないジャンクションやディレクトリを置き換えない防御も入っている",[14,330,331],{},"実行中の herdr.exe を上書きしないためのバージョン別フォルダ＋ジャンクション更新という設計で、アップデートの作法として手堅い。",[107,333,335],{"id":334},"_2-インストール実行","2. インストール実行",[14,337,338],{},"レビュー済みのスクリプトを実行した。所要は1分弱。",[340,341,346],"pre",{"className":342,"code":344,"language":345},[343],"language-text","==> Fetching Herdr preview manifest\n==> Installing Herdr 0.7.2-preview.2026-07-07-f5354780e4ef for x86_64-pc-windows-msvc\n==> Downloading Herdr\n==> PATH updated for future PowerShell sessions.\nHerdr 0.7.2-preview.2026-07-07-f5354780e4ef installed successfully.\n","text",[55,347,344],{"__ignoreMap":348},"",[14,350,351],{},"preview チャネルから来たのは 0.7.2-preview（2026-07-07 ビルド）だった。GitHub の最新タグは v0.7.3 だが、preview チャネルの配信は安定版のタグとは別に管理されているようだ。",[107,353,355],{"id":354},"_3-配置とバージョンの確認","3. 配置とバージョンの確認",[340,357,360],{"className":358,"code":359,"language":345},[343],"$ herdr --version\nherdr 0.7.2-preview.2026-07-07-f5354780e4ef\n",[55,361,359],{"__ignoreMap":348},[14,363,364,367,368,371,372,374],{},[55,365,366],{},"releases"," フォルダの下にバージョン名のディレクトリが1つでき、",[55,369,370],{},"current"," ジャンクションがそこを指していた。スクリプトを読んで理解した通りの配置になっている。PATH はユーザー環境変数に追加されるので、既存のターミナルでは新しいウィンドウを開くまで ",[55,373,25],{}," が引けない。",[107,376,378],{"id":377},"_4-claude-code-統合を入れて差分を検証する","4. Claude Code 統合を入れて差分を検証する",[14,380,381,383,384,387],{},[55,382,182],{}," は Claude Code の設定ファイル（",[55,385,386],{},"~/.claude/settings.json","）に手を入れる。うちの settings.json には音声読み上げなどのフックが大量に入っているので、実行前にバックアップを取り、実行後に意味的な差分（キー順を正規化した diff）を確認した。",[340,389,392],{"className":390,"code":391,"language":345},[343],"$ herdr integration install claude\ninstalled claude integration hook to C:\\Users\\numbe\\.claude\\hooks\\herdr-agent-state.ps1\nensured claude settings at C:\\Users\\numbe\\.claude\\settings.json\n",[55,393,391],{"__ignoreMap":348},[14,395,396,397,400],{},"差分は ",[50,398,399],{},"SessionStart フック1件の追加のみ","で、既存のフックはすべて無傷だった。見かけ上の diff が大きく出たのは herdr が JSON をキーのアルファベット順で書き直すためで、中身は変わっていない。",[14,402,403],{},"追加されたフックスクリプトの冒頭はこうなっている。",[340,405,409],{"className":406,"code":407,"language":408,"meta":348,"style":348},"language-powershell shiki shiki-themes vitesse-light vitesse-light","if ($Action -ne \"session\") { exit 0 }\nif ($env:HERDR_ENV -ne \"1\") { exit 0 }\nif ([string]::IsNullOrWhiteSpace($env:HERDR_PANE_ID)) { exit 0 }\n","powershell",[55,410,411,419,425],{"__ignoreMap":348},[412,413,416],"span",{"class":414,"line":415},"line",1,[412,417,418],{},"if ($Action -ne \"session\") { exit 0 }\n",[412,420,422],{"class":414,"line":421},2,[412,423,424],{},"if ($env:HERDR_ENV -ne \"1\") { exit 0 }\n",[412,426,428],{"class":414,"line":427},3,[412,429,430],{},"if ([string]::IsNullOrWhiteSpace($env:HERDR_PANE_ID)) { exit 0 }\n",[14,432,433,434,437],{},"herdr のペイン内（",[55,435,436],{},"HERDR_ENV=1","）でなければ即座に exit 0 する。つまり herdr を使わない普段の Claude Code セッションには影響しない。この確認が取れたので安心して残せる。",[107,439,441],{"id":440},"_5-サーバーの起動テスト","5. サーバーの起動テスト",[14,443,444],{},"TUI を開く前に、サーバー単体が起動するかを確かめた。",[340,446,449],{"className":447,"code":448,"language":345},[343],"$ herdr server\nherdr server running; you can use any herdr CLI command in another terminal.\napi socket: C:\\Users\\numbe\\AppData\\Roaming\\herdr\\herdr.sock\n\n$ herdr status\nserver:\n  status: running\n  version: 0.7.2-preview.2026-07-07-f5354780e4ef\n\n$ herdr server stop\n",[55,450,448],{"__ignoreMap":348},[14,452,453,454,457,458,461,462,464],{},"起動・状態取得・停止まで問題なく通った。ソケットとログは ",[55,455,456],{},"%APPDATA%\\herdr\\"," に置かれる。なお通常の利用では ",[55,459,460],{},"herdr server"," を手で起動する必要はなく、",[55,463,25],{}," と打てばサーバーの起動からアタッチまで面倒を見てくれる。",[63,466,467],{"id":467},"アンインストールしたくなったら",[14,469,470],{},"公式ドキュメントにアンインストール手順の記載は見つからなかった。構造が分かっているので手作業で消せる。",[472,473,474,480,486,499],"ol",{},[34,475,476,479],{},[55,477,478],{},"herdr integration uninstall claude"," で統合を外す",[34,481,482,485],{},[55,483,484],{},"herdr server stop"," でサーバーを止める",[34,487,488,491,492,491,495,498],{},[55,489,490],{},"%USERPROFILE%\\.herdr","、",[55,493,494],{},"%LOCALAPPDATA%\\Programs\\Herdr",[55,496,497],{},"%APPDATA%\\herdr"," を削除",[34,500,501,502,504],{},"ユーザー環境変数 PATH から ",[55,503,324],{}," を除く",[63,506,507],{"id":507},"次にやること",[14,509,510,511,513],{},"導入と動作確認までが今回の範囲だ。次は Windows Terminal で ",[55,512,25],{}," を開き、Claude Code を複数ペインで走らせて、サイドバーの状態表示がどこまで実用になるかを試す。ConPTY 由来の描画の癖（カーソルのちらつき等）が出るかどうかも、実際に使い込まないと分からない。使用感は別記事にする。",[515,516,517],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":348,"searchDepth":421,"depth":421,"links":519},[520,521,527,528,535,536],{"id":65,"depth":421,"text":66},{"id":101,"depth":421,"text":102,"children":522},[523,524,525,526],{"id":109,"depth":427,"text":110},{"id":170,"depth":427,"text":171},{"id":177,"depth":427,"text":177},{"id":190,"depth":427,"text":191},{"id":235,"depth":421,"text":236},{"id":285,"depth":421,"text":286,"children":529},[530,531,532,533,534],{"id":292,"depth":427,"text":293},{"id":334,"depth":427,"text":335},{"id":354,"depth":427,"text":355},{"id":377,"depth":427,"text":378},{"id":440,"depth":427,"text":441},{"id":467,"depth":421,"text":467},{"id":507,"depth":421,"text":507},"dev",null,"AIコーディングエージェント用ターミナルワークスペースマネージャ herdr の Windows プレビュー版を Windows 11 に導入した記録。install.ps1 の中身の確認から、世の中のベストプラクティス調査、Claude Code 統合フックの差分検証まで。","md",{},true,"/herdr-windows-beta-install","claude-code-tools",false,"2026-07-15T00:00:00.000Z",{"title":5,"description":539},"2026-07/2026-07-15/herdr-windows-beta-install",[25,550,155,551,552],"Claude Code","ターミナル","AIエージェント","hQccrQ0J59TlAApASK6B0D_UkRQI0FV7rA9Ri50cB5M",[],"https://log.eurekapu.com/og/blog/herdr-windows-beta-install.png?v=2026-07-15T00%3A00%3A00.000Z&title=herdr%20%E3%82%92%20Windows%20%E3%83%99%E3%83%BC%E3%82%BF%E3%81%A7%E5%B0%8E%E5%85%A5%E3%81%97%E3%81%9F%20%E2%80%94%20AI%E3%82%B3%E3%83%BC%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AE%E7%BE%A4%E3%82%8C%E3%82%92%E3%82%BF%E3%83%BC%E3%83%9F%E3%83%8A%E3%83%AB%E3%81%A7%E9%A3%BC%E3%81%86&author=Kei%20Komatsu&sig=a4a57268d82e3830",1784186909960]