Instalasi Aggrega
Aggrega memerlukan dua hal: biner aggrega yang terpasang, dan, untuk menulis dengan asisten AI, klien asisten Anda yang terhubung ke server MCP yang dibawa biner tersebut. Perintah-perintahnya disajikan lebih dulu; apa yang dilakukan masing-masing, serta cara instalasi lainnya, menyusul setelahnya.
Menginstal binary
Di Linux dan macOS, di terminal:
curl -fsSL https://aggrega.ai/install.sh | shDi Windows, di PowerShell:
irm https://aggrega.ai/install.ps1 | iexDengan Homebrew, di macOS dan Linux:
brew install aggrega-ai/tap/aggregaDengan Scoop, di Windows:
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregaDengan winget, di Windows:
winget install Cognitio.AggregaLalu periksa bahwa biner tersebut berjalan:
aggrega versionString versi berarti biner ditemukan dan dapat dijalankan. Hanya itu yang dibutuhkan server MCP. Setiap cara instalasi, secara rinci menjelaskan apa yang dilakukan setiap perintah, di mana biner diletakkan, dan cara memasang dengan penginstal Windows atau secara manual.
Menghubungkan klien MCP
Klien asisten AI Anda memulai server MCP Aggrega dengan menjalankan aggrega mcp, dan Menghubungkan server MCP memberikan perintah atau entri yang menambahkannya, untuk setiap klien. Pada asisten yang memasang plugin, plugin Aggrega menambahkan server dan skill Aggrega dalam satu langkah: lihat Memasang plugin.
Setiap cara instalasi, secara rinci
Aggrega didistribusikan sebagai satu executable tunggal. Satu perintah menginstalnya; langkah manual setelahnya melakukan hal yang sama secara manual. Keduanya menaruhnya di satu folder milik Anda sendiri, folder yang sama setiap kali, dan tidak satu pun memerlukan hak administrator: ~/.local/bin/aggrega di Linux dan macOS, dan %LOCALAPPDATA%\Programs\aggrega\aggrega.exe di Windows. Di Windows, penginstal Windows dan winget menginstalnya ke folder yang sama, juga tanpa hak administrator, dan mencantumkannya di antara aplikasi terinstal Anda: lihat Menginstal dengan penginstal Windows dan Menginstal dengan winget. Homebrew di macOS dan Linux, serta Scoop di Windows, juga menginstalnya, masing-masing ke folder miliknya sendiri: lihat Menginstal dengan manajer paket.
Menginstal dengan satu perintah
Perintah instalasinya adalah curl -fsSL https://aggrega.ai/install.sh | sh di Linux dan macOS serta irm https://aggrega.ai/install.ps1 | iex di PowerShell pada Windows, dua perintah pertama dari Menginstal binary. Kedua alamat tersebut dialihkan ke skrip instalasi yang dilampirkan rilis terbaru, sehingga perintah yang sama juga berjalan dengan alamat milik rilis itu sendiri:
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 | iexYang dilakukan perintah ini:
- Perintah ini memilih binary default untuk mesin Anda dari rilis terbaru: Linux dan macOS pada x86 64-bit atau ARM 64-bit, Windows pada x86 64-bit. Perintah ini menolak sistem atau prosesor lain dengan pesan yang menyebutkan apa yang ditemukannya atau ke mana harus beralih. Di Mac dengan Apple silicon, perintah ini memilih binary Apple silicon, bahkan dari shell yang berjalan melalui Rosetta 2.
- Perintah ini memeriksa binary terhadap
SHA256SUMSrilis sebelum menginstal apa pun. Unduhan yang digest SHA-256-nya berbeda dari yang tercantum di daftar akan dihapus, tidak ada yang diinstal, dan perintah berhenti dengan pesan yang menyebutkan kedua digest. - Perintah ini menginstal binary hanya untuk Anda, sebagai
~/.local/bin/aggregadi Linux dan macOS dan sebagai%LOCALAPPDATA%\Programs\aggrega\aggrega.exedi Windows, membuat folder jika belum ada dan mengganti salinan sebelumnya di sana dalam satu langkah, sehingga menjalankan perintah lagi akan memperbarui salinan yang Anda miliki. Perintah ini tidak pernah menggunakansudo. Di Windows, perintah ini juga menghapus tanda yang dapat dibawa file yang diunduh dari internet, seperti yang dilakukanUnblock-Filedalam langkah manual. Di macOS, perintah ini mengunduh dengancurl, sehingga binary yang diinstalnya tidak membawa tanda karantina (lihat Binary siap pakai untuk macOS). - Perintah ini membuat perintah dapat dijangkau. Di Linux dan macOS, jika folder tidak ada di
PATHAnda, perintah ini mencetak perintah yang menambahkan folder ke file yang dibaca shell Anda saat dimulai:~/.zshrcuntuk zsh,~/.bashrcuntuk bash (~/.bash_profiledi macOS),~/.config/fish/config.fishuntuk fish, dengan barisfish_add_path, dan~/.profileuntuk shell lainnya. Perintah ini tidak menjalankan perintah itu sendiri: jalankan perintah itu dan buka terminal baru. Di Windows, perintah ini menambahkan folder kePATHpengguna Anda jika belum ada di sana, dan kePATHjendela PowerShell tempat perintah dijalankan, sehinggaaggregadapat dijalankan di jendela itu dan di setiap terminal yang dibuka setelahnya, dan perintah ini memberi tahu bahwa folder telah ditambahkan. - Perintah ini memeriksa bahwa binary yang terinstal dapat berjalan, dan berhenti dengan sebuah pesan sebelum hal lain disiapkan jika binary itu tidak berjalan. Perintah ini menambahkan catatan jika ada
aggregalain yang mendahului yang diinstalnya diPATHAnda. - Perintah ini mencetak versi yang terinstal, dengan menjalankan binary yang diinstalnya melalui path lengkapnya, sehingga versi tampil bahkan sebelum
PATHAnda mencakup folder tersebut. - Perintah ini diakhiri dengan langkah-langkah berikutnya, di bawah
Next:, masing-masing satu baris: perintah yang menjalankan quickstart AI, seperti yang dijelaskan Memulai;aggrega skills install --global, yang menambahkan skill Aggrega ke asisten AI di mesin Anda, seperti yang dijelaskan Menambahkan skill asisten saat instalasi; dan alamat halaman ini, untuk pelengkapan shell dan Menghubungkan klien MCP di atas. Jika sebuah opsi sudah menginstal skill tersebut, barisnya dihilangkan.
Yang dicetaknya singkat: versi dan sistem yang menjadi target instalasi, satu baris setelah unduhan cocok dengan checksum-nya, dan path tempat menginstalnya. Memulai menampilkan satu eksekusi lengkap. --verbose, yang diberikan setelah sh -s -- seperti opsi di bawah, juga mencetak alamat daftar checksum, nama file rilis, dan alamat tempat file itu diunduh; install.ps1 memiliki switch yang sama sebagai -Verbose, untuk eksekusi skrip dengan argumen, yang tidak dapat diberikan oleh irm … | iex. Jika perintah menolak atau sebuah langkah gagal, perintah memberitahukannya dalam satu baris, di standard error dari install.sh dan sebagai galat atau peringatan yang ditampilkan PowerShell dari install.ps1:
aggrega install: error: <what went wrong> - <what to do>install.sh, skrip untuk Linux dan macOS, memerlukan curl atau wget, uname, dan sha256sum atau shasum. install.ps1, skrip untuk Windows, berjalan di Windows PowerShell 5.1 dan di PowerShell 7.
Dua pengaturan mengubah apa yang diinstal, masing-masing dibaca dari lingkungan tempat skrip dijalankan:
AGGREGA_VERSIONmenyebutkan rilis yang akan diinstal, misalnya0.8.7, ditulis dengan atau tanpavdi depannya. Jika tidak ditetapkan, perintah menginstal rilis terbaru — rilis yang ditandai GitHub sebagai latest, yang tidak pernah berupa prarilis, sehingga prarilis hanya diinstal jika disebutkan di sini.AGGREGA_INSTALL_DIRmenyebutkan folder tujuan instalasi sebagai pengganti folder default. Binary di sana bernamaaggrega, atauaggrega.exedi Windows, dan perintah membuat folder itu dapat dijangkau seperti di atas.
Di Linux dan macOS, letakkan pengaturan sebelum sh, bukan sebelum curl, agar skrip menerimanya:
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shDi PowerShell, tetapkan terlebih dahulu di jendela; pengaturan itu tetap berlaku di sana sampai Anda menghapusnya dengan Remove-Item Env:AGGREGA_VERSION:
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexMenyiapkan pelengkapan shell saat instalasi
Dengan --completion, install.sh juga menyiapkan pelengkapan shell, sehingga tombol Tab melengkapi perintah dan flag aggrega. Opsi ditulis setelah sh -s --, yang meneruskannya ke skrip yang dibaca sh dari pipa:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | iex tidak meneruskan opsi apa pun ke skrip. Di PowerShell, siapkan pelengkapan setelah instalasi selesai, dengan skrip yang ditulis oleh aggrega completion powershell, seperti yang dijelaskan Pelengkapan shell. install.ps1 juga menerima -Completion, untuk eksekusi skrip dengan argumen.
Perintah ini menyiapkan pelengkapan hanya untuk Anda, tanpa hak administrator, untuk shell yang disebut oleh pengaturan SHELL Anda, atau di PowerShell untuk PowerShell tempat perintah ini berjalan. Perintah ini memakai skrip yang ditulis oleh aggrega completion milik biner yang terpasang, dan menyebutkan setiap file yang ditulis atau diubahnya:
- bash: skrip ditulis ke
~/.local/share/bash-completion/completions, folder tempat paket bash-completion membaca pelengkapan milik Anda sendiri. Pelengkapan Bash untukaggregamemerlukan paket tersebut. - zsh:
_aggregaditulis ke~/.local/share/zsh/site-functionsdan tiga baris ditambahkan ke~/.zshrcyang menaruh folder itu di jalur fungsi zsh dan memuatnya, dengan menjalankancompinitjika belum ada apa pun di file tersebut yang menjalankannya lebih dulu. - fish:
aggrega.fishditulis ke~/.config/fish/completions, yang dibaca fish dengan sendirinya. - PowerShell: skrip ditulis sebagai
%LOCALAPPDATA%\aggrega\completion.ps1dan dua baris yang memuatnya ditambahkan ke profil Anda untuk setiap host PowerShell tempat perintah ini berjalan,$PROFILE.CurrentUserAllHosts. Windows PowerShell dan PowerShell 7 menyimpan profil terpisah, jadi jalankan dari masing-masing yang Anda gunakan. Profil hanya dijalankan jika kebijakan eksekusi yang dipakai jendela baru adalahRemoteSigned,Unrestricted, atauBypass; di bawah kebijakan lain, sepertiRestricted, perintah ini tidak menulis apa pun dan menyebutkan kebijakan yang ditemukannya. Perintah ini tidak pernah mengubah kebijakan tersebut.
XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR, dan ZDOTDIR memindahkan folder dan file tersebut sesuai cara masing-masing shell membacanya. Terminal atau jendela baru memuat pelengkapan. Menjalankan perintah lagi hanya menulis ulang skrip jika aggrega yang terpasang menulis skrip yang berbeda, dan menambahkan baris-baris ke ~/.zshrc atau profil hanya sekali; itu juga cara menambahkan pelengkapan ke instalasi yang sudah Anda miliki, karena perintah ini memasang ulang biner sekalian.
Menambahkan skill asisten saat menginstal
Dengan --skills (-Skills di PowerShell), perintah instalasi juga menginstal skill Aggrega — instruksi yang mengajari asisten AI cara menginstal dan menggunakan Aggrega — di setiap proyek Anda, untuk asisten AI di mesin Anda. Kedua opsi dapat diberikan bersamaan:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsDi PowerShell, tempat irm … | iex tidak meneruskan opsi apa pun, jalankan aggrega skills install --global setelah instalasi selesai: itulah perintah yang dijalankan oleh -Skills.
Perintah ini menjalankan aggrega skills install --global milik binary yang terinstal, yang mencari asisten di mesin Anda — setiap asisten yang folder konfigurasinya berada di direktori home Anda, atau yang perintahnya ada di PATH Anda — lalu mencetak setiap asisten yang ditemukannya dan apa yang menemukannya. Kemudian:
- Di terminal, perintah ini bertanya terlebih dahulu. Tekan Enter untuk menginstal skill bagi asisten yang ditemukan, atau ketik pengenal asisten lain untuk menambahkannya, dipisahkan dengan spasi atau koma;
aggrega skills listmencetak pengenal tersebut. Dengancurl … | sh, skrip membaca dirinya sendiri dari pipe, sehingga perintah ini bertanya melalui terminal Anda sebagai gantinya. - Jika tidak ada terminal untuk bertanya, seperti di dalam skrip, perintah ini menginstal untuk asisten yang ditemukannya.
- Untuk memilih asisten sendiri, berikan asisten tersebut setelah opsi, dipisahkan dengan koma:
--skills claude-code,cursor, atau--skills=claude-code,cursor, dan di PowerShell-Skills claude-code,cursor. Perintah ini lalu menginstal untuk asisten tersebut dan tidak mencari yang lain.
Perintah ini mencetak setiap folder skill yang ditulisnya, seperti ~/.claude/skills/aggrega untuk Claude Code, semuanya di bawah direktori home Anda. Menjalankan perintah lagi akan mengganti salinan yang ditulis oleh eksekusi sebelumnya; dengan cara inilah skill mengikuti binary ke versi yang lebih baru. aggrega skills menjelaskan perintah tersebut, folder yang dibaca setiap asisten, dan apa yang menemukan masing-masing asisten.
Ketika suatu langkah tidak dapat dilakukan
Ketika completion tidak dapat disiapkan — shell yang tidak disiapkannya, seperti dash, folder yang tidak dapat ditulisinya, atau kebijakan eksekusi PowerShell yang tidak menjalankan profil apa pun — atau skill tidak dapat diinstal — tidak ada asisten yang ditemukan dan tidak ada yang disebutkan, pengenal yang tidak dikenalnya, atau file di folder skill yang tidak ditulis oleh suatu instalasi — binary tetap terinstal dan dapat dijalankan. Perintah ini menyebutkan alasan langkah tersebut gagal, mencetak langkah selanjutnya, dan diakhiri dengan status yang menyebutkan langkah mana yang gagal. Status-statusnya adalah:
| Status | Arti |
|---|---|
0 | aggrega terinstal, dan setiap langkah yang diminta oleh suatu opsi berhasil |
1 | tidak ada yang diinstal, atau aggrega yang terinstal tidak dapat berjalan |
2 | perintah diberi opsi yang tidak diterimanya, atau daftar yang tidak menyebutkan asisten apa pun; perintah tidak melakukan apa pun |
3 | aggrega terinstal dan berjalan, tetapi penyiapan shell completion gagal |
4 | aggrega terinstal dan berjalan, tetapi instalasi skill gagal |
5 | aggrega terinstal dan berjalan, tetapi keduanya gagal |
Skrip PowerShell tidak pernah menutup jendela tempat skrip itu berjalan, sehingga skrip meninggalkan status di $LASTEXITCODE, dan setiap status selain 0 berakhir dengan galat, yang dilaporkan powershell -Command dan pwsh -Command sebagai status keluar 1.
Menginstal dengan penginstal Windows
Setiap rilis menyertakan penginstal Windows, aggrega-<version>-windows-amd64-setup.exe, di halaman rilis di https://github.com/aggrega-ai/aggrega-cli/releases. Unduh dan jalankan. Penginstal ini menginstal aggrega.exe default hanya untuk Anda, tanpa hak administrator dan tanpa memintanya, melalui wizard singkat:
- Halaman sambutan, lalu lisensi, Apache License 2.0 milik Aggrega: tidak ada yang diinstal sampai Anda menekan I Agree. Lalu komponen: Aggrega itu sendiri, selalu diinstal, dan Add to PATH, dalam keadaan terpilih.
- Folder instalasi,
%LOCALAPPDATA%\Programs\aggregakecuali Anda memilih yang lain; ini adalah folder yang digunakan perintah instalasi. - Kemajuan, lalu halaman selesai yang menyebutkan folder dan menyatakan apakah instalasi ini menambahkannya ke
PATHAnda, beserta langkah berikutnya: menginstal skill Aggrega denganaggrega skills install --global, dan menghubungkan klien AI Anda seperti dijelaskan di Menghubungkan klien MCP.
Yang dilakukannya:
- Dengan Add to PATH terpilih, penginstal menambahkan folder instalasi ke
PATHpengguna Anda kecuali sudah ada di sana. Terminal yang dibuka setelah instalasi akan menemukanaggrega; terminal yang sudah terbuka tetap memakaiPATHsaat terminal itu dimulai. Jika pilihan itu dikosongkan, tidak ada yang ditambahkan kePATHAnda, dan terminal menjalankanaggrega.exemelalui path lengkapnya; entri yang ditambahkan instalasi sebelumnya dibiarkan apa adanya. - Penginstal mencantumkan Aggrega di antara aplikasi terinstal Anda, dengan penerbit Cognitio s.r.l., sehingga dapat dicopot dari Settings → Apps seperti aplikasi lainnya. Pencopot instalasi meminta Anda mengonfirmasi, lalu menghapus file yang ditaruh penginstal di folder, entri
PATH, dan entri di daftar itu, serta menghapus folder jika tidak ada lagi yang tersisa di dalamnya. - Jika dijalankan lagi, penginstal menginstal di atas yang sudah ada, dengan menawarkan folder tempat ia terakhir menginstal, sehingga penginstal rilis yang lebih baru memperbarui salinan yang Anda miliki, dengan tetap menyimpan satu entri di
PATHAnda. - Di samping
aggrega.exe, folder berisiuninstall.exe,LICENSEdengan teks lisensi, danEnVar.dll, komponen yang digunakan penginstal dan pencopot instalasi untuk mengeditPATHAnda.
Ketika aggrega.exe sedang berjalan — dijalankan oleh editor atau klien AI — penginstal tidak dapat menggantinya, dan berhenti dengan pesan yang menyatakan hal itu; tutup program yang menjalankannya lalu jalankan penginstal lagi. Pencopot instalasi berhenti dengan cara yang sama, sebelum menghapus apa pun.
Untuk menginstal tanpa jendela, dari skrip atau alat yang menginstal perangkat lunak di banyak mesin, jalankan penginstal dengan /S, ditulis dengan huruf kapital; penginstal lalu menginstal tanpa jendela atau pertanyaan, ke folder yang digunakan instalasi sebelumnya atau, jika tidak ada, ke folder default, dengan Add to PATH, dan melaporkan kegagalan melalui kode keluarnya, yang bukan 0. Pencopot instalasi menerima sakelar yang sama:
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /SPenginstal ditandatangani seperti executable, dengan penerbit Cognitio S.r.l. dan stempel waktu: pemeriksaan di Binary siap pakai untuk Windows berlaku untuknya seperti untuk aggrega.exe, begitu pula penjelasan di sana tentang prompt yang dapat ditampilkan Windows untuk file yang diunduh. SHA256SUMS mencantumkan digest-nya seperti setiap file lain dalam rilis.
Jika penginstal tidak sesuai, perintah instalasi di atas dan langkah manual menginstal aggrega.exe yang sama ke folder yang sama.
Menginstal dengan manajer paket
Setiap rilis juga memperbarui formula Homebrew dan manifes Scoop, sehingga manajer paket yang sudah Anda gunakan dapat menginstal Aggrega dan menjaganya tetap mutakhir. Masing-masing menginstal binary default yang sama dengan yang diinstal perintah instalasi, diperiksa terhadap digest SHA-256 yang diberikan SHA256SUMS rilis untuknya.
Di macOS dan Linux, brew install aggrega-ai/tap/aggrega menginstalnya dengan Homebrew. Homebrew menambahkan tap aggrega-ai/tap pada kali pertama dan menginstal binary untuk sistem dan prosesor Anda: macOS pada Apple silicon atau Intel, Linux pada x86 64-bit atau ARM 64-bit. Setelah rilis baru, brew upgrade memperbaruinya bersama setiap formula lain yang Anda instal.
Di Windows, dengan Scoop, tambahkan bucket Aggrega sekali dengan scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, lalu instal darinya dengan scoop install aggrega. Scoop menginstal binary Windows sebagai aggrega.exe dan membuatnya dapat dijangkau sebagai aggrega melalui folder shim yang disimpannya di PATH Anda. Setelah rilis baru, scoop update menyegarkan bucket dan scoop update aggrega memperbaruinya.
Homebrew dan Scoop masing-masing menginstal ke folder miliknya sendiri, bukan ke ~/.local/bin atau %LOCALAPPDATA%\Programs\aggrega, dan hanya memperbarui salinan yang diinstalnya. Gunakan satu cara instalasi pada satu mesin: salinan yang diinstal dengan perintah instalasi atau secara manual dan salinan lain yang diinstal dengan Homebrew atau Scoop adalah dua salinan, dan folder mana yang lebih dulu di PATH Anda menentukan mana yang dijalankan.
Menginstal dengan winget
Di Windows, winget install Cognitio.Aggrega menginstalnya dengan winget, Windows Package Manager. winget mengunduh penginstal Windows rilis dari halaman rilisnya, memeriksanya terhadap digest SHA-256 yang diberikan manifes paket, lalu menjalankannya tanpa pengawasan. Hasilnya sama dengan hasil penginstal itu sendiri: aggrega.exe di %LOCALAPPDATA%\Programs\aggrega, atau di folder yang digunakan instalasi sebelumnya, folder itu di PATH pengguna Anda, dan Aggrega di daftar aplikasi terinstal Anda, semuanya tanpa hak administrator. winget tidak mengubah PATH terminal tempat winget dijalankan, jadi buka terminal baru sebelum menjalankan aggrega version.
winget upgrade Cognitio.Aggrega menginstal rilis yang lebih baru di atasnya, dan winget uninstall Cognitio.Aggrega menjalankan pencopot instalasinya. winget, penginstal, dan perintah instalasi semuanya menginstal ke folder yang sama kecuali Anda memilih folder lain di penginstal, sehingga yang dijalankan terakhir yang menaruh aggrega.exe di sana.
Menginstal secara manual
Setiap rilis menyertakan binary siap pakai untuk Linux pada x86 64-bit dan ARM 64-bit, untuk Windows pada x86 64-bit, serta untuk macOS pada Apple silicon dan Intel, di halaman rilis di https://github.com/aggrega-ai/aggrega-cli/releases. Unduh executable untuk sistem operasi dan prosesor Anda — Memilih file di bawah menyebutkan masing-masing — dan periksa terhadap SHA256SUMS rilis, seperti dijelaskan di sana. Lalu tandai sebagai dapat dieksekusi dan pindahkan ke ~/.local/bin/aggrega. Di Linux, dari direktori tempat hasil unduhan berada, dengan <version> diganti versi yang Anda unduh, dan amd64 dengan arm64 pada ARM 64-bit:
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaDi Windows, lihat Binary siap pakai untuk Windows di bawah; di macOS, lihat Binary siap pakai untuk macOS.
Jika ~/.local/bin tidak ada di PATH Anda, tambahkan baris ini ke file yang dibaca shell Anda saat dimulai — ~/.zshrc untuk zsh, ~/.bashrc untuk bash (~/.bash_profile di macOS) — lalu buka terminal baru:
export PATH="$HOME/.local/bin:$PATH"Dari kode sumber, dengan toolchain Go terinstal, build perintah aggrega dari pohon kode sumber dan letakkan binary yang dihasilkan di folder yang sama.
Konfirmasikan instalasi dengan aggrega version, seperti di akhir Menginstal binary.
Memilih file
Rilis menamai setiap executable aggrega-<version>-<system>-<processor>, dengan .exe di Windows:
| System | Prosesor | Berkas |
|---|---|---|
| Linux | x86 64-bit (uname -m mencetak x86_64) | aggrega-<version>-linux-amd64 |
| Linux | ARM 64-bit (uname -m mencetak aarch64) | aggrega-<version>-linux-arm64 |
| Windows | x86 64-bit | aggrega-<version>-windows-amd64.exe |
| macOS | Apple silicon | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<version>-darwin-amd64 |
File itulah yang diinstal perintah instalasi, dan yang diunduh secara manual. Dua variannya berada di sampingnya; perintah instalasi tidak menginstal keduanya, dan masing-masing diinstal secara manual dengan cara yang sama:
aggrega-debug-<version>-…adalah program yang sama dengan informasi debug-nya, yang dibaca debugger atau profiler. Program ini berjalan dan melaporkan versinya persis seperti file default, dan ukurannya lebih besar.aggrega-light-<version>-…di-build tanpa plugin tersemat: program ini me-resolve setiap plugin melalui kaskade plugin, sebagaimana dikonfigurasi oleh workspace, alih-alih menemukan plugin inti di dalam dirinya sendiri.
Untuk Windows, rilis juga menyertakan aggrega-<version>-windows-amd64-setup.exe, yaitu penginstal Windows, yang menginstal file default untuk Anda.
Setiap rilis juga menyertakan SHA256SUMS, digest SHA-256 dari setiap file lain yang dilampirkannya, termasuk kedua skrip instalasi, dalam bentuk yang dibaca sha256sum. Perintah instalasi melakukan pemeriksaan ini sendiri. Untuk memeriksa unduhan secara manual di Linux, dengan SHA256SUMS di direktori yang sama:
sha256sum --check --ignore-missing SHA256SUMSFile yang Anda unduh dilaporkan OK; laporan lain apa pun berarti file itu bukan file yang dipublikasikan rilis.
Binary siap pakai untuk Windows
Executable Windows adalah aggrega-<version>-windows-amd64.exe (varian debug dan light di sampingnya dalam rilis diinstal dengan cara yang sama). Ganti namanya menjadi aggrega.exe, pindahkan ke %LOCALAPPDATA%\Programs\aggrega, folder yang digunakan perintah instalasi, dan tambahkan folder itu ke PATH pengguna Anda: Windows menjalankan file berakhiran .exe tanpa perlu menandainya sebagai dapat dieksekusi, dan menemukannya sebagai perintah aggrega dengan nama tersebut. Dari PowerShell, misalnya, dengan <version> diganti versi yang Anda unduh:
$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")Terminal yang dibuka setelah itu menemukan aggrega; terminal yang sudah terbuka tetap memakai PATH saat ia dimulai.
Executable-nya ditandatangani. Masing-masing membawa tanda tangan Authenticode, tanda tangan kode yang diperiksa Windows, dan penerbit yang ditampilkan Windows untuknya adalah Cognitio S.r.l. Setiap tanda tangan juga membawa stempel waktu: sertifikat di balik tanda tangan hanya berlaku selama beberapa hari, dan stempel waktulah yang membuat tanda tangan tetap valid setelah sertifikat itu kedaluwarsa. Untuk memeriksa file yang diunduh sebelum menjalankannya:
-
Di File Explorer, buka Properties file tersebut dan tab Digital Signatures. Daftar tanda tangan menyebutkan Cognitio S.r.l.; pilih entri itu lalu Details, yang melaporkan This digital signature is OK.
-
Di PowerShell, dengan
$dirseperti pada contoh di atas:Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatusmelaporkanValid, dan subjeknya diawaliCN=Cognitio S.r.l..NotSignedatauHashMismatchberarti file tersebut bukan yang dipublikasikan oleh rilis, atau telah diubah setelah ditandatangani.
Tanda tangan menyebutkan penerbit; tanda tangan tidak menghilangkan setiap peringatan. Peringatan mana yang Anda temui bergantung pada cara file tiba dan cara Anda menjalankannya:
- Saat mengunduh, browser dapat memperingatkan bahwa file tersebut jarang diunduh dan menanyakan apakah file akan disimpan. Menyimpannya akan menyimpan file sebagaimana diunduh.
- Saat Anda menjalankannya dari File Explorer atau dari browser, Windows dapat menampilkan Windows protected your PC. Prompt itu berasal dari Microsoft Defender SmartScreen, yang menimbang reputasi yang telah dibangun oleh sebuah file dan penerbitnya, sehingga versi yang baru dirilis masih dapat menemuinya, meskipun ditandatangani, sampai reputasinya sendiri terbangun. Untuk file yang ditandatangani, prompt menyebutkan penerbitnya: pilih More info, periksa bahwa prompt menyebutkan Cognitio S.r.l. dan nama file yang Anda unduh, lalu pilih Run anyway. Jika dijalankan dari PowerShell atau command prompt, file yang sama dapat berjalan tanpa prompt itu; hal ini bergantung pada versi Windows dan pengaturannya.
Unblock-Filemenjawab prompt itu lebih dahulu. File yang diunduh ditandai sebagai berasal dari internet, dan tanda itulah yang ditanggapi oleh pemeriksaan Windows protected your PC.Unblock-Filedi PowerShell, seperti pada contoh di atas, menghapus tanda tersebut; begitu pula kotak centang Unblock pada tab General di Properties file tersebut di File Explorer.- Jika Smart App Control diaktifkan (Windows 11), fitur ini memeriksa program saat Anda menjalankannya. Sebagaimana dijelaskan Microsoft, Smart App Control terlebih dahulu menanyakan kepada layanan keamanan cloud Microsoft apakah program tersebut aman; jika layanan itu tidak dapat membuat prediksi yang meyakinkan, fitur ini memeriksa tanda tangan, mengizinkan program dengan tanda tangan valid berjalan dan memblokir program yang tidak ditandatangani atau tanda tangannya tidak valid. Status aktifnya ditampilkan di bawah App & browser control di Windows Security.
Binary siap pakai untuk macOS
Executable macOS adalah aggrega-<version>-darwin-arm64, untuk Mac dengan Apple silicon, dan aggrega-<version>-darwin-amd64, untuk Mac dengan prosesor Intel; About This Mac di menu Apple menunjukkan mana yang Anda miliki. Varian debug dan light di sampingnya dalam rilis diinstal dengan cara yang sama. Mac dengan Apple silicon juga menjalankan file Intel, melalui Rosetta 2 jika terinstal, tetapi file Apple silicon adalah yang di-build untuknya.
Ganti nama file menjadi aggrega, tandai sebagai dapat dieksekusi, dan pindahkan ke ~/.local/bin, folder yang digunakan perintah instalasi. Dari Terminal, misalnya, di direktori tempat hasil unduhan berada, dengan <version> diganti versi yang Anda unduh, dan arm64 dengan amd64 pada Mac Intel:
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregamkdir membuat folder jika belum ada. ~/.local/bin tidak ada di PATH yang diberikan macOS kepada terminal baru, jadi tambahkan baris dari Menginstal secara manual ke ~/.zshrc, atau ke ~/.bash_profile untuk bash, kecuali sudah ada di sana.
Executable-nya ditandatangani dan dinotarisasi. Masing-masing membawa tanda tangan kode yang dibuat dengan Developer ID milik Cognitio s.r.l. — sertifikat yang diterbitkan Apple kepada developer untuk perangkat lunak yang didistribusikan di luar Mac App Store — dengan hardened runtime dan stempel waktu aman, dan layanan notarisasi Apple telah memeriksa serta menotarisasi masing-masing. Gatekeeper, pemeriksaan macOS terhadap perangkat lunak dari internet, menilai program yang membawa tanda karantina, tanda yang ditambahkan browser web ke file yang diunduhnya, dan menerima program yang telah dinotarisasi Apple, sehingga file yang diunduh dari halaman rilis dapat langsung berjalan. Tiket notarisasi tidak dapat dilampirkan ke satu file executable, sehingga Gatekeeper mencari tiket secara online saat file pertama kali dijalankan; pada Mac yang sedang offline saat itu, Gatekeeper dapat memblokir file sampai Mac dapat menjangkau Apple.
Untuk memeriksa file yang diunduh sebelum menjalankannya, dari Terminal, dengan nama file yang Anda unduh:
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64Perintah pertama melaporkan bahwa file valid on disk dan satisfies its Designated Requirement. Perintah kedua mencantumkan otoritas tanda tangan, yang pertama adalah Developer ID Application: COGNITIO SRL diikuti pengenal tim dalam tanda kurung, serta sebuah Timestamp. File yang gagal pada salah satunya bukan file yang dipublikasikan rilis, atau telah diubah setelah ditandatangani.
File yang diambil dengan curl tidak membawa tanda karantina, sehingga Gatekeeper sama sekali tidak menilainya: curl tidak menambahkan tanda yang ditambahkan browser. Itu juga sebabnya binary yang ditaruh perintah instalasi berjalan tanpa penilaian tersebut.