Aggrega のインストール
Aggrega に必要なものは 2 つです。インストール済みの aggrega バイナリと、AI アシスタントでオーサリングする場合は、バイナリに含まれる MCP サーバーに接続したアシスタントのクライアントです。まずコマンドを示し、それぞれの動作とその他のインストール方法はその後に説明します。
バイナリのインストール
Linux と macOS では、ターミナルで次を実行します。
curl -fsSL https://aggrega.ai/install.sh | shWindows では、PowerShell で次を実行します。
irm https://aggrega.ai/install.ps1 | iexHomebrew を使う場合(macOS と Linux):
brew install aggrega-ai/tap/aggregaScoop を使う場合(Windows):
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregawinget を使う場合(Windows):
winget install Cognitio.Aggrega次に、実行できることを確認します:
aggrega versionバージョン文字列が表示されれば、バイナリが見つかり、実行可能であることを意味します。MCP サーバーに必要なのはそれだけです。各インストール方法の詳細では、各コマンドの動作、バイナリの配置場所、Windows インストーラーまたは手動でのインストール方法を説明しています。
MCP クライアントを接続する
AI アシスタントのクライアントは aggrega mcp を実行して Aggrega の MCP サーバーを起動します。サーバーを追加するコマンドまたはエントリーは、MCP サーバーの接続にクライアントごとに記載されています。プラグインをインストールできるアシスタントでは、Aggrega プラグインがサーバーと Aggrega スキルを 1 つの手順で追加します。プラグインのインストールを参照してください。
各インストール方法の詳細
Aggrega は単一の実行ファイルとして配布されます。1 つのコマンドでインストールでき、その後に示す手動の手順でも同じことを手作業で行えます。どちらの方法でも、毎回同じ自分専用のフォルダーに配置され、管理者権限は不要です。Linux と macOS では ~/.local/bin/aggrega、Windows では %LOCALAPPDATA%\Programs\aggrega\aggrega.exe です。Windows では、Windows インストーラーと winget も同じフォルダーにインストールし、やはり管理者権限なしで、インストール済みアプリの一覧に登録します。Windows インストーラーでインストールすると winget でインストールするを参照してください。macOS と Linux の Homebrew、および Windows の Scoop でもインストールでき、それぞれ独自のフォルダーにインストールします。パッケージマネージャーでインストールするを参照してください。
1 つのコマンドでインストールする
インストールコマンドは、Linux と macOS では curl -fsSL https://aggrega.ai/install.sh | sh、Windows の PowerShell では irm https://aggrega.ai/install.ps1 | iex で、バイナリのインストールの最初の 2 つのコマンドです。この 2 つのアドレスは最新リリースに添付されたインストールスクリプトにリダイレクトされるため、同じコマンドはリリース自体のアドレスでも実行できます:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | shirm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iexこのコマンドが行うこと:
- 最新リリースから、マシンに合ったデフォルトのバイナリを選びます。対象は 64 ビット x86 または 64 ビット ARM 上の Linux と macOS、および 64 ビット x86 上の Windows です。それ以外のシステムやプロセッサーでは、検出したものや代わりに利用すべき方法を示すメッセージを出して拒否します。Apple シリコン搭載の Mac では、Rosetta 2 経由で動作しているシェルからでも Apple シリコン用のバイナリを選びます。
- リリースの
SHA256SUMSと照合してバイナリを検証します。これは何かをインストールする前に行われます。ダウンロードしたファイルの SHA-256 ダイジェストが一覧の値と異なる場合、そのファイルは削除され、何もインストールされず、コマンドは両方のダイジェストを示すメッセージを出して停止します。 - バイナリを自分だけのためにインストールします。Linux と macOS では
~/.local/bin/aggregaとして、Windows では%LOCALAPPDATA%\Programs\aggrega\aggrega.exeとしてインストールし、フォルダーがなければ作成し、そこにある以前のコピーを 1 回の操作で置き換えます。そのため、コマンドを再度実行すると手元のコピーが更新されます。sudoは一切使いません。Windows では、手動の手順のUnblock-Fileと同じように、インターネットからダウンロードしたファイルに付くことがあるマークも取り除きます。macOS ではcurlでダウンロードするため、インストールされるバイナリには検疫マークが付きません(macOS 用ビルド済みバイナリを参照)。 - コマンドを実行できる状態にします。 Linux と macOS では、フォルダーが
PATHにない場合、シェルが起動時に読み込むファイルにそのフォルダーを追加するコマンドを表示します。zsh では~/.zshrc、bash では~/.bashrc(macOS では~/.bash_profile)、fish では~/.config/fish/config.fish(fish_add_pathの行を使います)、その他のシェルでは~/.profileです。そのコマンドを自動では実行しないので、実行してから新しいターミナルを開いてください。Windows では、フォルダーがユーザーのPATHになければ追加し、実行中の PowerShell ウィンドウのPATHにも追加します。そのため、そのウィンドウと、その後に開くすべてのターミナルでaggregaを実行できます。また、フォルダーを追加したことを表示します。 - インストールしたバイナリが実行できることを確認し、実行できない場合は、ほかの設定を行う前にメッセージを表示して停止します。また、
PATH上でインストールしたものより前に別のaggregaがある場合は、その旨の注記を加えます。 - インストールしたバージョンを表示します。インストールしたバイナリをフルパスで実行するので、
PATHがそのフォルダーを含む前でもバージョンが表示されます。 - 最後に次のステップを示します。
Next:の下に 1 行ずつ並びます。はじめにで説明している、AI クイックスタートを実行するコマンド、インストール時にアシスタントのスキルを追加するで説明している、マシン上の AI アシスタントに Aggrega スキルを追加するaggrega skills install --global、そしてシェル補完と上記の MCP クライアントの接続のためのこのページのアドレスです。オプションですでにスキルがインストールされている場合、その行は省かれます。
表示される内容は簡潔です。バージョンとインストール対象のシステム、ダウンロードがチェックサムと一致した時点での 1 行、そしてインストール先のパスです。はじめにに実行全体の例があります。--verbose を、下記のオプションと同じく sh -s -- の後に指定すると、チェックサム一覧のアドレス、リリースファイルの名前、およびそのダウンロード元のアドレスも表示されます。install.ps1 には同じスイッチが -Verbose としてあり、引数付きでスクリプトを実行する場合に使えますが、irm … | iex ではスクリプトに引数を渡せません。コマンドが拒否した場合やステップが失敗した場合は、その旨を 1 行で示します。install.sh では標準エラーに出力し、install.ps1 では PowerShell が表示するエラーまたは警告として示します:
aggrega install: error: <what went wrong> - <what to do>Linux と macOS 用のスクリプトである install.sh には、curl または wget、uname、そして sha256sum または shasum が必要です。Windows 用の install.ps1 は Windows PowerShell 5.1 と PowerShell 7 で動作します。
インストール内容を変える設定が 2 つあります。いずれもスクリプトを実行する環境から読み取られます。
AGGREGA_VERSIONはインストールするリリースを指定します。例えば0.8.7のように、先頭のvを付けても付けなくても構いません。未設定の場合、コマンドは最新リリースをインストールします。これは GitHub が latest とマークしたもので、プレリリースになることはないため、プレリリースはここで指定した場合にのみインストールされます。AGGREGA_INSTALL_DIRは、デフォルトの代わりにインストール先とするフォルダーを指定します。そこでのバイナリ名はaggrega(Windows ではaggrega.exe)で、コマンドはそのフォルダーを上記と同じように実行可能な状態にします。
Linux と macOS では、スクリプトが設定を受け取れるよう、設定を curl の前ではなく sh の前に置きます。
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shPowerShell では、まずウィンドウで設定します。設定は Remove-Item Env:AGGREGA_VERSION で削除するまでそのウィンドウで有効なままです。
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexインストール時にシェル補完を設定する
--completion を付けると、install.sh はシェル補完も設定し、Tab キーで aggrega のコマンドとフラグを補完できるようにします。オプションは sh -s -- の後に置きます。これにより、sh がパイプから読み込むスクリプトにオプションが渡されます:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | iex はスクリプトにオプションを渡しません。PowerShell では、インストールの完了後に、aggrega completion powershell が書き出すスクリプトを使って補完を設定します。手順はシェル補完で説明しています。install.ps1 も、引数付きでスクリプトを実行する場合には -Completion を受け付けます。
補完は自分だけのために、管理者権限なしで設定されます。対象は SHELL 設定が示すシェル、PowerShell では実行中の PowerShell です。インストールされたバイナリ自身の aggrega completion が書き出すスクリプトを使い、書き込んだり変更したりするすべてのファイルの名前を示します:
- bash:スクリプトを
~/.local/share/bash-completion/completionsに書き込みます。これは bash-completion パッケージがユーザー独自の補完を読み込むフォルダーです。aggregaの Bash 補完にはこのパッケージが必要です。 - zsh:
_aggregaを~/.local/share/zsh/site-functionsに書き込み、~/.zshrcに 3 行を追加します。この 3 行はそのフォルダーを zsh の関数パスに加えて読み込み、ファイル内でそれより前に実行されていなければcompinitを実行します。 - fish:
aggrega.fishを~/.config/fish/completionsに書き込みます。fish はこのフォルダーを自動的に読み込みます。 - PowerShell:スクリプトを
%LOCALAPPDATA%\aggrega\completion.ps1として書き込み、それを読み込む 2 行を、実行中の PowerShell のすべてのホスト向けのプロファイル$PROFILE.CurrentUserAllHostsに追加します。Windows PowerShell と PowerShell 7 はそれぞれ別のプロファイルを持つため、使用するそれぞれから実行してください。プロファイルが実行されるのは、新しいウィンドウに適用される実行ポリシーがRemoteSigned、Unrestricted、Bypassのいずれかの場合だけです。Restrictedなどそれ以外のポリシーでは何も書き込まず、検出したポリシーを示します。ポリシーを変更することはありません。
XDG_DATA_HOME、XDG_CONFIG_HOME、BASH_COMPLETION_USER_DIR、ZDOTDIR は、各シェルが読み込むとおりに、これらのフォルダーとファイルの場所を変えます。新しいターミナルまたはウィンドウで補完が読み込まれます。コマンドを再度実行すると、インストールされた aggrega が異なるスクリプトを書き出す場合にのみスクリプトを書き直し、~/.zshrc またはプロファイルへの行の追加は 1 回だけ行います。コマンドはその過程でバイナリを再インストールするため、既存のインストールに補完を追加する方法もこれと同じです。
インストール時にアシスタントスキルを追加する
--skills(PowerShell では -Skills)を指定すると、インストールコマンドはマシン上の AI アシスタント向けに、すべてのプロジェクトで使える Aggrega スキル(AI アシスタントに Aggrega のインストールと使い方を教える指示)もインストールします。両方のオプションを同時に指定できます:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsPowerShell では irm … | iex がオプションを渡さないため、インストールの完了後に aggrega skills install --global を実行します。これは -Skills が実行するコマンドです。
インストールされたバイナリ自身の aggrega skills install --global を実行します。このコマンドはマシン上のアシスタント(設定フォルダーがホームディレクトリにあるもの、またはコマンドが PATH 上にあるもの)を探し、見つかった各アシスタントと、それを見つけた手がかりを表示します。その後:
- ターミナルでは、まず確認します。 Enter キーを押すと、見つかったアシスタント向けにスキルをインストールします。ほかのアシスタントを追加するには、その識別子をスペースまたはカンマで区切って入力します。識別子は
aggrega skills listで表示されます。curl … | shの場合、スクリプトはパイプから自身を読み込むため、代わりにターミナルを通じて確認します。 - 確認に使えるターミナルがない場合(スクリプト内など)は、見つかったアシスタント向けにインストールします。
- アシスタントを自分で選ぶには、オプションの後にカンマ区切りで指定します。
--skills claude-code,cursorまたは--skills=claude-code,cursor、PowerShell では-Skills claude-code,cursorです。この場合、指定したアシスタント向けにインストールし、ほかのアシスタントは探しません。
書き込んだ各スキルフォルダー(Claude Code の場合は ~/.claude/skills/aggrega など)を表示します。いずれもホームディレクトリの下にあります。コマンドを再度実行すると、以前の実行で書き込まれたコピーが置き換えられます。こうしてスキルはバイナリに合わせて新しいバージョンに追従します。コマンド、各アシスタントが読み込むフォルダー、各アシスタントを見つける手がかりについては aggrega skills で説明しています。
ステップを実行できない場合
補完を設定できない場合(dash のように設定に対応していないシェル、書き込めないフォルダー、またはプロファイルを実行しない PowerShell の実行ポリシー)や、スキルをインストールできない場合(アシスタントが見つからず指定もされていない、認識できない識別子、またはインストールによって書き込まれたものではないファイルがスキルフォルダーにある)でも、バイナリはインストールされ、実行できます。コマンドはステップが失敗した理由を示し、次のステップを表示し、どのステップが失敗したかを示すステータスで終了します。ステータスは次のとおりです:
| ステータス | 意味 |
|---|---|
0 | aggrega がインストールされ、オプションで指定したすべてのステップが成功しました |
1 | 何もインストールされなかったか、インストールされた aggrega が実行できませんでした |
2 | コマンドが受け付けないオプション、またはアシスタントを 1 つも指定しないリストが渡されました。何も行っていません |
3 | aggrega はインストールされ実行できますが、シェル補完の設定に失敗しました |
4 | aggrega はインストールされ実行できますが、スキルのインストールに失敗しました |
5 | aggrega はインストールされ実行できますが、その両方に失敗しました |
PowerShell スクリプトは実行中のウィンドウを閉じないため、ステータスを $LASTEXITCODE に残します。0 以外のステータスはすべてエラーで終わり、powershell -Command と pwsh -Command はそれを終了ステータス 1 として報告します。
Windows インストーラーでインストールする
各リリースには、リリースページ https://github.com/aggrega-ai/aggrega-cli/releases に Windows インストーラー aggrega-<version>-windows-amd64-setup.exe が含まれています。ダウンロードして実行してください。短いウィザードを通じて、デフォルトの aggrega.exe を自分だけのために、管理者権限なしで、また権限を求めることもなくインストールします:
- ようこそページ、次にライセンス(Aggrega の Apache License 2.0):I Agree を押すまで、何もインストールされません。次にコンポーネント:常にインストールされる Aggrega 本体と、選択済みの Add to PATH。
- インストール先フォルダー、別のフォルダーを選ばない限り
%LOCALAPPDATA%\Programs\aggregaです。これはインストールコマンドが使うのと同じフォルダーです。 - 進行状況、次に完了ページ。完了ページはフォルダーを示し、このインストールでそのフォルダーを
PATHに追加したかどうかを伝え、次の手順を案内します。aggrega skills install --globalで Aggrega スキルをインストールすることと、MCP クライアントを接続するの説明に従って AI クライアントを接続することです。
動作は次のとおりです:
- Add to PATH が選択されている場合、インストールフォルダーをユーザーの
PATHに追加します(すでにある場合を除きます)。インストール後に開いたターミナルはaggregaを見つけられますが、すでに開いているターミナルは起動時のPATHのままです。選択を外した場合、PATHには何も追加されず、ターミナルではaggrega.exeをフルパスで実行します。以前のインストールが追加したエントリーはそのまま残ります。 - Aggrega をインストール済みアプリの一覧に登録します。発行元は Cognitio s.r.l. で、他のアプリと同様に 設定 → アプリ からアンインストールできます。アンインストーラーは確認を求めたうえで、インストーラーがフォルダーに置いたファイル、
PATHのエントリー、一覧のエントリーを削除し、フォルダーに何も残っていなければフォルダーも削除します。 - 再度実行すると、既存のものに上書きインストールします。その際、前回インストールしたフォルダーが提示されます。そのため、新しいリリースのインストーラーで手元のコピーを更新でき、
PATHのエントリーは 1 つのままです。 - このフォルダーには、
aggrega.exeの横にuninstall.exe、ライセンス本文を収めたLICENSE、そしてEnVar.dll(インストーラーとアンインストーラーがPATHの編集に使うコンポーネント)が置かれます。
エディターや AI クライアントによって起動された aggrega.exe が実行中の場合、インストーラーはそれを置き換えられず、その旨のメッセージを出して停止します。起動元を閉じてから、インストーラーを再度実行してください。アンインストーラーも同じように、何も削除しないうちに停止します。
ウィンドウなしでインストールするには、スクリプトや多数のマシンにソフトウェアをインストールするツールから、大文字の /S を付けてインストーラーを実行します。この場合、ウィンドウも質問もなしに、以前のインストールが使ったフォルダー、なければデフォルトのフォルダーに Add to PATH を有効にしてインストールし、失敗は 0 以外の終了コードで報告します。アンインストーラーも同じスイッチを受け付けます:
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /Sインストーラーは実行ファイルと同様に、発行元 Cognitio S.r.l. とタイムスタンプ付きで署名されています。Windows 用ビルド済みバイナリの確認方法は aggrega.exe と同じようにインストーラーにも当てはまり、ダウンロードしたファイルに対して Windows が表示することのあるプロンプトについての説明も同様です。SHA256SUMS には、リリースの他のすべてのファイルと同じくインストーラーのダイジェストも記載されています。
インストーラーが適さない場合は、上記のインストールコマンドと手動の手順で、同じ aggrega.exe を同じフォルダーにインストールできます。
パッケージマネージャーでインストールする
各リリースでは Homebrew の formula と Scoop のマニフェストも更新されるため、普段使っているパッケージマネージャーで Aggrega をインストールし、最新の状態に保てます。どちらもインストールコマンドと同じデフォルトのバイナリをインストールし、リリースの SHA256SUMS に記載された SHA-256 ダイジェストと照合します。
macOS と Linux では、brew install aggrega-ai/tap/aggrega で Homebrew を使ってインストールします。Homebrew は初回に aggrega-ai/tap tap を追加し、システムとプロセッサーに合ったバイナリをインストールします。対象は Apple シリコンまたは Intel 上の macOS、64 ビット x86 または 64 ビット ARM 上の Linux です。新しいリリースが出たら、brew upgrade でインストール済みの他のすべての formula とともに更新されます。
Windows では、Scoop を使い、scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket で Aggrega の bucket を一度追加してから、scoop install aggrega でそこからインストールします。Scoop は Windows 用バイナリを aggrega.exe としてインストールし、PATH 上に保持する shim のフォルダーを通じて aggrega として実行できるようにします。新しいリリースが出たら、scoop update で bucket を更新し、scoop update aggrega で Aggrega を更新します。
Homebrew と Scoop は、~/.local/bin や %LOCALAPPDATA%\Programs\aggrega ではなくそれぞれ独自のフォルダーにインストールし、自分がインストールしたコピーだけを更新します。1 台のマシンではインストール方法を 1 つに絞ってください。インストールコマンドや手動でインストールしたコピーと、Homebrew や Scoop でインストールしたコピーは別々の 2 つのコピーになり、PATH で先に来るフォルダーによってどちらが実行されるかが決まります。
winget でインストールする
Windows では、winget install Cognitio.Aggrega で、Windows パッケージマネージャーである winget を使ってインストールします。winget はリリースページからそのリリースの Windows インストーラーをダウンロードし、パッケージのマニフェストに記載された SHA-256 ダイジェストと照合してから、無人で実行します。結果はインストーラーそのものと同じです。aggrega.exe が %LOCALAPPDATA%\Programs\aggrega、または以前のインストールが使ったフォルダーに置かれ、そのフォルダーがユーザーの PATH に追加され、Aggrega がインストール済みアプリの一覧に載ります。いずれも管理者権限は不要です。winget は実行中のターミナルの PATH を変更しないため、aggrega version を実行する前に新しいターミナルを開いてください。
winget upgrade Cognitio.Aggrega は新しいリリースを上書きインストールし、winget uninstall Cognitio.Aggrega はそのアンインストーラーを実行します。インストーラーで別のフォルダーを選ばない限り、winget、インストーラー、インストールコマンドはいずれも同じフォルダーにインストールするため、最後に実行したものがそこに aggrega.exe を置きます。
手動でインストールする
各リリースには、64 ビット x86 と 64 ビット ARM 上の Linux 用、64 ビット x86 上の Windows 用、Apple シリコンと Intel 上の macOS 用のビルド済みバイナリが、リリースページ https://github.com/aggrega-ai/aggrega-cli/releases に含まれています。お使いのオペレーティングシステムとプロセッサー用の実行ファイルをダウンロードし(それぞれの名前は後述のファイルの選び方にあります)、そこで説明しているとおりリリースの SHA256SUMS と照合します。次に、実行可能にして ~/.local/bin/aggrega に移動します。Linux では、ダウンロードしたファイルのあるディレクトリから、<version> をダウンロードしたバージョンに、64 ビット ARM では amd64 を arm64 に置き換えて、次のようにします。
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaWindows については後述の Windows 用ビルド済みバイナリを、macOS については macOS 用ビルド済みバイナリを参照してください。
~/.local/bin が PATH にない場合は、シェルが起動時に読み込むファイル(zsh では ~/.zshrc、bash では ~/.bashrc、macOS では ~/.bash_profile)に次の行を追加し、新しいターミナルを開きます。
export PATH="$HOME/.local/bin:$PATH"ソースからビルドする場合は、Go ツールチェーンがインストールされている環境で、ソースツリーから aggrega コマンドをビルドし、生成されたバイナリを同じフォルダーに置きます。
バイナリのインストールの最後と同様に、aggrega version でインストールを確認します。
ファイルの選び方
リリースでは各実行ファイルに aggrega-<version>-<system>-<processor> という名前が付けられ、Windows では .exe が付きます。
| システム | プロセッサー | ファイル |
|---|---|---|
| Linux | 64 ビット x86(uname -m が x86_64 を出力) | aggrega-<version>-linux-amd64 |
| Linux | 64 ビット ARM(uname -m が aarch64 を出力) | aggrega-<version>-linux-arm64 |
| Windows | 64 ビット x86 | aggrega-<version>-windows-amd64.exe |
| macOS | Apple シリコン | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<version>-darwin-amd64 |
このファイルが、インストールコマンドがインストールするものであり、手動でダウンロードするものです。その隣には 2 つのバリアントがあります。インストールコマンドはどちらもインストールせず、どちらも同じ方法で手動でインストールします。
aggrega-debug-<version>-…は、デバッガーやプロファイラーが読み取るデバッグ情報を含んだ同じプログラムです。デフォルトのファイルとまったく同じように動作し、同じバージョンを報告しますが、サイズが大きくなります。aggrega-light-<version>-…は組み込みプラグインなしでビルドされています。コアのプラグインを自身の内部で見つけるのではなく、ワークスペースの設定に従ってプラグインのカスケードを通じてすべてのプラグインを解決します。
Windows 向けには、リリースに aggrega-<version>-windows-amd64-setup.exe も含まれています。これはデフォルトのファイルをインストールする Windows インストーラーです。
各リリースには SHA256SUMS も含まれています。これは、2 つのインストールスクリプトを含め、リリースに添付された他のすべてのファイルの SHA-256 ダイジェストを、sha256sum が読み取れる形式で記載したものです。インストールコマンドはこの確認を自動で行います。Linux でダウンロードを手動で確認するには、SHA256SUMS を同じディレクトリに置いて次を実行します。
sha256sum --check --ignore-missing SHA256SUMSダウンロードしたファイルは OK と報告されます。それ以外の報告は、そのファイルがリリースで公開されたものではないことを意味します。
Windows 用ビルド済みバイナリ
Windows 用の実行ファイルは aggrega-<version>-windows-amd64.exe です(リリース内でその隣にある debug 版と light 版も同じ方法でインストールします)。これを aggrega.exe にリネームし、インストールコマンドが使うフォルダーである %LOCALAPPDATA%\Programs\aggrega に移動して、そのフォルダーをユーザーの PATH に追加します。Windows は .exe で終わるファイルを実行可能にする操作なしで実行し、その名前により aggrega コマンドとして見つけます。たとえば PowerShell から、<version> をダウンロードしたバージョンに置き換えて次のようにします。
$dir = "$env:LOCALAPPDATA\Programs\aggrega"New-Item -ItemType Directory -Force $dir | Out-NullMove-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"Unblock-File "$dir\aggrega.exe"[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")その後に開いたターミナルは aggrega を見つけます。すでに開いているターミナルは、起動時の PATH を保持します。
実行ファイルは署名されています。 各ファイルには Windows が検証するコード署名である Authenticode 署名が付いており、Windows が表示する発行元は Cognitio S.r.l. です。各署名にはタイムスタンプも付いています。署名の元となる証明書の有効期間は数日のみであり、その証明書の期限切れ後も署名を有効に保つのがタイムスタンプです。ダウンロードしたファイルを実行前に確認するには、次のようにします。
-
エクスプローラーでは、 ファイルの プロパティ を開き、デジタル署名 タブを開きます。署名の一覧に Cognitio S.r.l. が表示されます。それを選択して 詳細 を選ぶと、このデジタル署名は問題ありません。 と表示されます。
-
PowerShell では、 上の例と同じ
$dirを使って次のようにします。Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatusはValidを示し、サブジェクトはCN=Cognitio S.r.l.で始まります。NotSignedまたはHashMismatchは、そのファイルがリリースで公開されたものではないか、署名後に変更されたことを意味します。
署名は発行元を示しますが、すべての警告をなくすわけではありません。どの警告が表示されるかは、ファイルの入手方法と起動方法によって異なります。
- ダウンロード中に、 ブラウザーが、このファイルは一般的にダウンロードされていないと警告し、保存するかどうかを尋ねることがあります。保存を選ぶと、ファイルはダウンロードされたとおりに保存されます。
- エクスプローラー やブラウザーから起動すると、Windows が Windows によって PC が保護されました と表示することがあります。この画面は Microsoft Defender SmartScreen によるもので、ファイルとその発行元が築いた評価を考慮するため、新しくリリースされたバージョンは署名されていても、それ自体の評価が蓄積されるまではこの画面が表示されることがあります。署名されたファイルの場合、この画面には発行元が表示されます。詳細情報 を選択し、Cognitio S.r.l. とダウンロードしたファイル名が表示されていることを確認してから、実行 を選択します。代わりに PowerShell やコマンドプロンプトから起動した場合、同じファイルがこの画面なしで実行されることがあります。そうなるかどうかは Windows のバージョンと設定によります。
Unblock-Fileはこの画面に事前に応答します。 ダウンロードしたファイルにはインターネットから来たことを示すマークが付き、Windows によって PC が保護されました のチェックはこのマークに反応します。上の例のように PowerShell でUnblock-Fileを実行するとこのマークが削除されます。エクスプローラーでファイルの プロパティ の 全般 タブにある 許可する チェックボックスでも同様です。- スマート アプリ コントロールが有効な場合(Windows 11)、プログラムの起動時にそのプログラムがチェックされます。Microsoft の説明によると、スマート アプリ コントロールはまず Microsoft のクラウドセキュリティサービスにそのプログラムが安全かどうかを問い合わせます。そのサービスが確信を持って予測できない場合は署名をチェックし、有効な署名を持つプログラムは実行を許可し、署名がないか署名が無効なプログラムはブロックします。有効かどうかは、Windows セキュリティの アプリとブラウザー コントロール で確認できます。
macOS 用ビルド済みバイナリ
macOS 用の実行ファイルは、Apple シリコン搭載の Mac 向けの aggrega-<version>-darwin-arm64 と、Intel プロセッサ搭載の Mac 向けの aggrega-<version>-darwin-amd64 です。どちらの Mac かは、Apple メニューの この Mac について で確認できます。リリース内でその隣にある debug 版と light 版も同じ方法でインストールします。Apple シリコン搭載の Mac は、Rosetta 2 がインストールされていれば Intel 用のファイルも実行できますが、その Mac 向けにビルドされたのは Apple シリコン用のファイルです。
ファイルを aggrega にリネームし、実行可能にして、インストールコマンドが使うフォルダーである ~/.local/bin に移動します。たとえばターミナルで、ダウンロードしたファイルのあるディレクトリから、<version> をダウンロードしたバージョンに、Intel Mac では arm64 を amd64 に置き換えて、次のようにします。
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregamkdir は、フォルダーがまだ存在しない場合にそれを作成します。~/.local/bin は macOS が新しいターミナルに与える PATH に含まれていないため、まだ追加していなければ、手動でインストールするの行を ~/.zshrc(bash の場合は ~/.bash_profile)に追加します。
実行ファイルは署名と公証を受けています。 各ファイルには、Cognitio s.r.l. の Developer ID(Mac App Store 以外で配布するソフトウェアのために Apple が開発者に発行する証明書)による、Hardened Runtime と安全なタイムスタンプ付きのコード署名があり、Apple の公証サービスが各ファイルを確認して公証しています。インターネットから入手したソフトウェアに対する macOS のチェックである Gatekeeper は、検疫マーク(Web ブラウザーがダウンロードしたファイルに付けるマーク)が付いたプログラムを評価し、Apple が公証したものを受け入れます。そのため、リリースページからダウンロードしたファイルはそのまま実行できます。公証チケットは単一の実行ファイルに添付できないため、Gatekeeper はファイルの初回実行時にオンラインでチケットを確認します。その時点で Mac がオフラインの場合、Mac が Apple に接続できるようになるまで Gatekeeper がファイルをブロックすることがあります。
ダウンロードしたファイルを実行前に確認するには、ターミナルで、ダウンロードしたファイル名を使って次を実行します。
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm641 つ目は、ファイルが valid on disk であり、satisfies its Designated Requirement であると報告します。2 つ目は署名の認証局を一覧表示します。その先頭は Developer ID Application: COGNITIO SRL で、後ろに括弧付きでチーム ID が続き、さらに Timestamp が表示されます。どちらかに失敗するファイルは、リリースで公開されたものではないか、署名後に変更されています。
curl で取得したファイルには検疫マークが付かないため、Gatekeeper はそれをまったく評価しません。curl はブラウザーのようにマークを付けないからです。インストールコマンドが配置するバイナリがその評価なしで実行されるのも、これが理由です。