PK-Herdr のインストール

Next docs describe unreleased work from master. Stable docs remain at /docs/.

PK-Herdr は Linux と macOS 向けに安定版バイナリを提供しています。ネイティブ Windows 対応はプレビュー限定のベータです。

インストール

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

curl -fsSL https://herdr.pkking.computer/install.sh | sh

Windows プレビューベータでは、プレビューチャンネルをインストールします:

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

インストーラーはプラットフォームに合ったリリースバイナリをダウンロードして PATH 上に配置します。Windows では PK-Herdr が設定を変更せずにデフォルトでプレビューを使います。インストーラーはバージョン付きインストールフォルダーを使い、current ジャンクションを更新します。そのため、アップデート時に実行中の pk-herdr.exe を上書きする必要がありません。

Homebrew でインストール

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

brew install herdr

mise でインストール

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

mise use -g herdr

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

Nix でインストール

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

nix run github:kingkillery/pk-herdr/v0.x.y
nix build github:kingkillery/pk-herdr/v0.x.y
nix profile install github:kingkillery/pk-herdr/v0.x.y

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

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

nix develop github:kingkillery/pk-herdr

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

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

PK-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

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

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

Windows ベータのダウンロード

ネイティブ Windows 対応がベータの間、Windows バイナリはプレビューリリースでのみ公開されます。通常のテストには上記のプレビューインストーラーを使うか、プレビューの GitHub プレリリースから Windows アセットをダウンロードしてください:

システム	アセット
Windows x86_64 ベータ	herdr-windows-x86_64.zip

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

動作確認

PK-Herdr を起動します:

pk-herdr

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

アップデート

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

pk-herdr update

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

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

pk-herdr channel set preview

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

pk-herdr channel set stable

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

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

Windows ベータビルドは今のところプレビュー限定です。安定版の Windows リリースが提供されるまで、Windows では pk-herdr channel set stable は拒否されます。

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

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

pk-herdr update --handoff

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

動作要件

PK-Herdr の安定版リリースは Linux と macOS をサポートします。ネイティブ Windows ビルドはプレビュー限定のベータリリースです。サポートされるワークフローと既知の制限は Windows ベータを参照してください。