Herdr のインストール

Herdr は Linux、macOS、Windows 向けに安定版チャンネルのバイナリを提供しています。Windows 対応は正式提供されており、プラットフォーム固有の既知の制限と継続的な修正があります。

インストール

Linux または macOS では次を実行します:

curl -fsSL https://herdr.dev/install.sh | sh

Windows では次を実行します:

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

インストーラーはプラットフォームに合ったリリースバイナリをダウンロードして PATH 上に配置します。新しい直接インストールは安定版アップデートチャンネルを使います。既存の Windows プレビューインストールは、herdr channel set stable で切り替えるまでプレビューに残ります。Windows インストーラーはバージョン付きインストールフォルダーを使い、current ジャンクションを更新します。そのため、アップデート時に実行中の herdr.exe を上書きする必要がありません。

Homebrew でインストール

すでに Homebrew を使っている場合:

brew install herdr

mise でインストール

すでに mise を使っている場合:

mise use -g herdr

mise が herdr not found in mise tool registry と報告する場合は、mise をアップデートして再試行してください。古い mise は Herdr のレジストリ登録より前のバージョンです。一時的な回避策として mise use -g github:herdrdev/herdr も使えます。

Nix でインストール

すでに Nix を使っている場合、Herdr はソースからビルドする flake を提供しています:

nix run github:herdrdev/herdr/v0.x.y
nix build github:herdrdev/herdr/v0.x.y
nix profile install github:herdrdev/herdr/v0.x.y

v0.x.y は最新のリリースタグに置き換えてください。タグを省略すると master を追跡できますが、通常のインストールにはリリースタグを推奨します。

flake は開発用シェルも公開しています:

nix develop github:herdrdev/herdr

アップデートは、Herdr のインストールに使ったのと同じ Nix ワークフローで行います。プロファイルインストールの場合は、プロファイルのエントリを一覧して Herdr のエントリをアップグレードします:

nix profile list
nix profile upgrade <index-or-name>

Herdr が自分の flake の input になっている場合は、その input を更新してシステム、Home Manager、または開発環境を再ビルドします:

nix flake update herdr

手動でダウンロード

GitHub releases からバイナリをダウンロードすることもできます。

システムに合ったアセットを選んでください:

システム	アセット
Linux x86_64	herdr-linux-x86_64
Linux aarch64	herdr-linux-aarch64
macOS Intel	herdr-macos-x86_64
macOS Apple silicon	herdr-macos-aarch64
Windows x86_64	herdr-windows-x86_64.zip

Linux または macOS では、実行可能にして PATH 上のどこかに移動します。

chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr

Windows アーカイブ

安定版リリースとプレビュープレリリースの両方に herdr-windows-x86_64.zip が含まれます。アーカイブには herdr.exe とアプリローカルの ConPTY ランタイムが含まれます。展開したディレクトリをまとめて保持し、herdr.exe だけをコピーしないでください。

動作確認

Herdr を起動します:

herdr

シェルが herdr を見つけられない場合は、ターミナルを再起動するか、インストール先ディレクトリが PATH に含まれているか確認してください。

アップデート

Herdr は新しいリリースをチェックし、アプリ内で通知します。手動でアップデートすることもできます:

herdr update

herdr update は Herdr 自身のインストーラーで管理されているインストール向けです。Homebrew、mise、Nix のインストールは、それぞれのパッケージマネージャーでアップデートしてください。

Linux、macOS、Windows の直接インストールは、デフォルトで安定版アップデートチャンネルを使います。master からのプレビュービルドにオプトインするには、チャンネルを設定します:

herdr channel set preview

直接インストールを安定版に戻すのも同じ方法です:

herdr channel set stable

直接インストールの場合、チャンネルの変更はそのチャンネルをチェックして最新バイナリをインストールします。そのアップデートが失敗した場合は、herdr update を実行して設定済みチャンネルから再試行してください。

プレビュービルドは、現在の開発ブランチから定期的に公開される GitHub プレリリースです。次の安定版リリースより前に修正が欲しいときに便利ですが、リグレッションの可能性があります。Homebrew、mise、Nix のインストールはプレビューチャンネルを使いません。

Windows の通常利用には安定版を推奨します。プレビューでは修正をより早く受け取れますが、リグレッションの可能性があるため、そのトレードオフを望む場合に限りオプトインしてください。既存の Windows プレビューインストールは、明示的に切り替えるまでプレビューに残ります。古いプレビュービルドで herdr channel set stable が拒否される場合は、プレビューのまま一度 herdr update を実行してから、チャンネル切り替えを再試行してください。

デフォルトでは、herdr update は新しいバイナリをインストールし、互換性のある実行中セッションには手を付けません。アップデートが Herdr のクライアント/サーバープロトコルを変更する場合、Herdr はインストール後に古いサーバーを停止するか尋ねます。新しいバージョンを使うには古いサーバーを停止してください。停止するとペインのプロセスは終了します。デフォルトセッションでは herdr server stop を実行してから再度 herdr を実行します。名前付きセッションでは herdr session stop <name> を実行してから再度 herdr session attach <name> を実行します。

対応する実行中セッションで実験的なライブサーバーハンドオフにオプトインするには:

herdr update --handoff

ライブハンドオフは Homebrew、mise、Nix のパッケージマネージャー経由のアップデートには適用されません。それらのインストールではパッケージマネージャーでアップデートし、新しいサーバーを使う準備ができたらその Herdr セッションを再起動してください。実行中のセッションがまだ古いサーバーを使っている場合は、herdr server stop または herdr session stop <name> で停止してから、再度 Herdr を実行します。

動作要件

安定版チャンネルのバイナリは Linux、macOS、Windows x86_64 で利用できます。サポートされるワークフローと既知の制限は Windows サポートを参照してください。Windows ARM64 では x86_64 ビルドが Windows のエミュレーション上で動作します。