agent-manager

ドキュメント · インストール

インストール

このページは英語版の翻訳です。内容が異なる場合は英語版が正となります。

macOS と Linux、amd64 と arm64 に対応しています。全体が tmux の上に作られているため、tmux 3.1+ が必要です。Windows ではペインのシェルを PowerShell 7.3 以降にして psmux 3.4+ 上でネイティブに動き、WSL2 の中でも引き続き動きます。

依存関係

ツール用途入手方法
tmux 3.1+macOS、Linux、WSL2 でのすべてのエージェントセッション。Homebrew、AUR、インストールスクリプト。
psmux 3.4+ネイティブ Windows でのすべてのエージェントセッション。Scoop、Windows 用インストールスクリプト、または winget install --id marlocarlo.psmux -e。
gitdiff レビューと worktree セッション。Homebrew、AUR、インストールスクリプト。
wl-clipboard または xclipLinux でプロンプトに画像を貼り付ける機能。Linux デスクトップでのインストールスクリプト、またはパッケージマネージャー。
notify-sendLinux でのデスクトップ通知。Linux デスクトップでのインストールスクリプト（apt では libnotify-bin、zypper では libnotify-tools、その他では libnotify）、またはパッケージマネージャー。

mise、go install、ビルド済みバイナリの方法ではバイナリだけがインストールされるので、tmux と git はパッケージマネージャーでインストールしてください。tmux なしでマネージャーを起動したときや、diff ビューが git を見つけられないときは、検出したインストールコマンドが表示されます。

エージェントの CLI は各自でインストールしますが、マネージャーがそれを手伝います。PATH にない CLI で起動しようとすると、その CLI のインストーラーを示すダイアログが開きます。i でシェルタブ内で実行し、c でコピーします。npm でインストールする CLI では、使える npm がなければ先に Node LTS をインストールし、グローバルの npm prefix に書き込めない場合はホームディレクトリ以下にインストールします。

Homebrew

macOS と Linux。tmux がなければ一緒にインストールし、Homebrew 自体は git で動きます。

Terminal
brew install agent-manager

Homebrew cask

macOS と Linux。ビルドせずにリリース済みのバイナリをインストールし、tmux も導入します。上の formula は homebrew-core にあってソースからビルドします。この cask はビルド済みの方法で、agent-manager update はどちらで動いているかを判別します。

Terminal
brew install --cask yoanwai/tap/agent-manager

インストールスクリプト

macOS と Linux。リリースの install.sh をダウンロードし、中身を読んでから実行します。このファイルはリリースに添付され、checksums.txt に記載されています。sh install.sh はダウンロードが成功した後にだけ実行されます。

Terminal
curl -fsSL -o install.sh https://github.com/YoanWai/agent-manager/releases/latest/download/install.sh && sh install.sh

gh attestation verify install.sh --repo YoanWai/agent-manager は、gh にログインしていれば、そのファイルのビルド来歴を確認します。同じコマンドで install.ps1 やリリースのアーカイブも確認できます。

スクリプトはお使いのプラットフォーム向けのリリースをダウンロードし、公開されたチェックサムで検証してから ~/.local/bin にインストールします。続いて tmux 3.1+ と git の有無を確認します。macOS では Homebrew でのインストールを提案し、Homebrew がなければ先にそれをインストールします。Linux では apt、dnf、pacman、zypper、apk、Homebrew のいずれかを提案し、デスクトップ環境ではクリップボードと通知のパッケージも追加します。WSL では貼り付けと通知が Windows 経由になるため、これらは省略します。提案を断るとコマンドを表示し、ターミナルなしで実行した場合は確認を省略してバイナリだけをインストールします。AGENT_MANAGER_VERIFY_ATTESTATION=1 を指定すると、ダウンロードしたアーカイブを gh attestation verify が承認しない限りインストールを拒否します。y、yes、true も大文字小文字を問わず同じ意味です。この変数が未設定なら、スクリプトは gh を呼ばずにインストールします。gh は attestation の拒否、未ログイン、ネットワークエラーに同じ終了ステータスを使うため、変数を設定している場合はそのいずれもインストール失敗として扱われます。

短い形式は、ファイルを保存して読むことなく main 上のスクリプトを実行します。

Terminal
curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh
変数効果
AGENT_MANAGER_INSTALL_DIR~/.local/bin 以外の場所にインストールします。
AGENT_MANAGER_VERSION最新版ではなく特定のバージョンに固定します。
AGENT_MANAGER_INSTALL_DEPS1 で依存関係の確認に事前に yes と答え、0 で省略します。
AGENT_MANAGER_VERIFY_ATTESTATION1、y、yes、true で、ダウンロードしたアーカイブを gh attestation verify で確認します。

Arch Linux

agent-manager-bin はリリース済みのバイナリをインストールし、tmux と git も導入します。

Terminal
yay -S agent-manager-bin

mise

GitHub のリリースを直接読むので、レジストリへの登録は不要です。tmux と git はパッケージマネージャーでインストールしてください。

Terminal
mise use -g ubi:YoanWai/agent-manager

Go

Go 1.27.3+、tmux 3.1+（Windows では psmux 3.4+）、git が必要です。$(go env GOPATH)/bin にインストールされます。

Terminal
go install github.com/YoanWai/agent-manager@latest

ビルド済みバイナリ

macOS、Linux、Windows、amd64 と arm64 に対応し、Releases から直接入手できます。Windows では psmux と git をパッケージマネージャーでインストールしてください。各リリースでは checksums.txt を公開しており、アーカイブ、install.sh、install.ps1 が対象です。gh attestation verify <file> --repo YoanWai/agent-manager は、gh にログインしていれば、ダウンロードしたファイルのビルド来歴を確認します。

Scoop

Windows。yoanwai bucket で公開されているバージョンをインストールし、Scoop が psmux も一緒にインストールします。bucket は独立して更新されるため、最新リリースより遅れることがあります。Windows 用インストールスクリプトは最新リリースをインストールします。git と PowerShell 7 がなければ scoop install git pwsh でインストールしてください。

PowerShell
scoop bucket add yoanwai https://github.com/YoanWai/scoop-bucket
scoop install yoanwai/agent-manager

Windows

ネイティブ Windows では、マルチプレクサーは psmux 3.4.0 以降、ペインのシェルは PowerShell です。リリースから install.ps1 をダウンロードし、中身を読んでから実行します。このファイルはリリースに添付され、checksums.txt に記載されています。Windows PowerShell 5.1 には && がないため、ガードには if ($?) を使います。

PowerShell
irm https://github.com/YoanWai/agent-manager/releases/latest/download/install.ps1 -OutFile install.ps1
if ($?) {
  Get-Content .\install.ps1
  Unblock-File .\install.ps1
  powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
}

gh attestation verify .\install.ps1 --repo YoanWai/agent-manager は、gh にログインしていれば、そのファイルのビルド来歴を確認します。実行ポリシーが Restricted のマシンでは、-ExecutionPolicy Bypass はファイルを読んだ後のそのプロセスにだけ適用されます。

スクリプトは agent-manager.exe を %LOCALAPPDATA%\Programs\agent-manager、または設定されていれば $env:AGENT_MANAGER_INSTALL_DIR にインストールし、そのディレクトリをユーザーの Path に追加します。足りないものはインストールを提案し、依存関係のインストールに失敗してもバイナリのインストールは失敗しません。AGENT_MANAGER_INSTALL_DEPS=1 は yes と答え、0 は確認を省略し、ターミナルなしで実行した場合も省略します。AGENT_MANAGER_VERIFY_ATTESTATION はシェルスクリプトと同じように動作します。

短い形式は、ファイルを保存して読むことなく main 上のスクリプトを実行します。

PowerShell
irm https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.ps1 | iex
ツールインストール
psmux 3.4.0+winget install --id marlocarlo.psmux -e、または cargo install psmux。マネージャーはそれより古いビルドを拒否します。
gitwinget install --id Git.Git -e
PowerShell 7.3+ (pwsh)winget install --id Microsoft.PowerShell -e。Windows PowerShell 5.1 と 7.3 より前の PowerShell は拒否されます。" を含むプロンプトを複数の引数に分割してしまうためです。

各セッションはそれぞれ専用の psmux サーバー上で動き、プレビューはペインをポーリングします。Command Code は cmd.exe と名前が同じなので、ツールの選択肢から除外され、それを指定したセッションは拒否されます。.cmd または .bat ファイルとしてのみインストールされた CLI も、同じ引用符の分割の問題で拒否されます。npm でのインストールは問題ありません。npm は .ps1 を各 .cmd の横に追加するからです。セットアップダイアログが npm でインストールした CLI は %APPDATA%\npm に入ります。マネージャーの起動時にそのディレクトリが Path になかった場合は、その CLI を起動する前にマネージャーを起動し直してください。

WSL2 も引き続き使えます。WSL のシェルでは、インストールスクリプト、Homebrew、または Linux 用バイナリを tmux 上で使います。エージェントの CLI はディストリビューションの中に置きます。CLI の Windows 版しか見つからない場合、起動は止まり、WSL の中にインストールするコマンドが表示されます。

起動する

事前に書く設定も、起動するデーモンもありません。

Terminal
agent-manager

引数なしで起動したとき、標準入力または標準出力がターミナルでなければ、使い方を標準出力に表示して終了コード 0 で終了します。標準エラー出力には agent-manager: no terminal attached; run it in a terminal to open the manager と表示されます。

キー動作
spaceアタッチせずに選択中のセッションにプロンプトを送ります。グループの行ではエージェントを起動します。
ctrl+rそのセッションの変更をレビューします。c で行にコメントし、C ですべてのコメントを送り返します。
v終了したセッションを元の会話で起動し直します。
enterセッションをその場でフォーカスします。キー入力はエージェントに届き、リストは表示されたままです。A はフルスクリーンでアタッチします。
?いつでも表示できるキー一覧のオーバーレイ。

アップデート

マネージャーは 10 分ごとに GitHub Releases を確認し、新しいバージョンが出ていればヘッダーに ↑ vX.Y.Z available バッジを表示します。ヘッダーを非表示にしている場合は、同じバッジがフレームの上端に表示されます。アップデートのメッセージで u を押すか、設定のバージョン行で enter を押すと、その後の動作はインストール方法によって決まります。Homebrew、mise、AUR でのインストールでは、ターミナルをそのパッケージマネージャー自身のアップグレードコマンドに渡すので、進捗表示やパスワードの入力はシェルで実行したときと同じように動きます。インストールスクリプト、go install、手動ダウンロードの場合は、リリースをダウンロードしてバイナリを置き換え、その場で更新します。どちらの場合も、マネージャーはすべてのセッションを動かしたまま新しいビルドで再起動します。

Scoop は、バイナリの実行中はアプリを更新できません。マネージャーはコマンドを表示し、バイナリはそのままにします。agent-manager を閉じて scoop update agent-manager を実行し、もう一度起動してください。グローバルインストールでは、管理者権限の PowerShell で scoop update agent-manager --global を使います。マネージャーを閉じている間もエージェントのセッションは動き続けます。

手動で更新する 2 つのケース pacman で管理されたインストールには、AUR ヘルパー（yay または paru）が PATH 上に必要です。ない場合、マネージャーは何も実行せず、代わりに使うコマンド yay -S agent-manager-bin を表示します。Nix でのインストールは読み取り専用のストアにあるため、マネージャーは Nix での更新方法を案内します（nix profile upgrade agent-manager や、flake または NixOS の設定など）。

シェルから agent-manager update を実行すると、マネージャーを開かずに同じことができます。Homebrew、mise、AUR でのインストールはそのパッケージマネージャーに任せ、インストールスクリプト、go install、手動ダウンロードの場合はバイナリを置き換えます。Scoop でのインストールではコマンドを表示してバイナリはそのままにします。--json を付けると、結果を機械可読な形式で得られます。各インストール方法のコマンドも引き続き直接使えます。

Terminal
agent-manager update                                # any install
brew upgrade agent-manager                          # Homebrew formula
brew upgrade --cask yoanwai/tap/agent-manager       # Homebrew cask
scoop update agent-manager                          # Scoop, after closing agent-manager
curl -fsSL -o install.sh https://github.com/YoanWai/agent-manager/releases/latest/download/install.sh && sh install.sh  # install script
mise upgrade --bump ubi:YoanWai/agent-manager       # mise
go install github.com/YoanWai/agent-manager@latest  # Go