Installer Aggrega
Aggrega nécessite deux choses : le binaire aggrega installé et, pour écrire avec un assistant d’IA, le client de votre assistant connecté au serveur MCP que contient le binaire. Les commandes viennent d’abord ; ce que fait chacune, et les autres façons d’installer, viennent ensuite.
Installer le binaire
Sous Linux et macOS, dans un terminal :
curl -fsSL https://aggrega.ai/install.sh | shSous Windows, dans PowerShell :
irm https://aggrega.ai/install.ps1 | iexAvec Homebrew, sous macOS et Linux :
brew install aggrega-ai/tap/aggregaAvec Scoop, sous Windows :
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregaAvec winget, sous Windows :
winget install Cognitio.AggregaVérifiez ensuite qu’il fonctionne :
aggrega versionUne chaîne de version signifie que le binaire est trouvé et exécutable. C’est tout ce dont le serveur MCP a besoin. Chaque façon d’installer, en détail explique ce que fait chaque commande, où elle place le binaire et comment installer avec le programme d’installation Windows ou à la main.
Connecter un client MCP
Le client de votre assistant d’IA démarre le serveur MCP d’Aggrega en exécutant aggrega mcp, et Connecter le serveur MCP donne la commande ou l’entrée qui l’ajoute, client par client. Dans un assistant qui installe des plugins, le plugin Aggrega ajoute le serveur et la skill Aggrega en une seule étape : voir Installer le plugin.
Chaque façon d’installer, en détail
Aggrega est distribué sous la forme d’un exécutable unique. Une seule commande l’installe ; les étapes manuelles qui suivent font la même chose à la main. Toutes deux le placent dans un dossier à vous, le même à chaque fois, et aucune ne nécessite de droits d’administrateur : ~/.local/bin/aggrega sous Linux et macOS, et %LOCALAPPDATA%\Programs\aggrega\aggrega.exe sous Windows. Sous Windows, le programme d’installation Windows et winget l’installent dans ce même dossier, également sans droits d’administrateur, et le listent parmi vos applications installées : voir Installer avec le programme d’installation Windows et Installer avec winget. Homebrew, sous macOS et Linux, et Scoop, sous Windows, l’installent aussi, chacun dans ses propres dossiers : voir Installer avec un gestionnaire de paquets.
Installer en une seule commande
La commande d’installation est curl -fsSL https://aggrega.ai/install.sh | sh sous Linux et macOS et irm https://aggrega.ai/install.ps1 | iex dans PowerShell sous Windows, les deux premières commandes de Installer le binaire. Ces deux adresses redirigent vers les scripts d’installation que joint la dernière release, de sorte que les mêmes commandes fonctionnent aussi avec les adresses propres à la release :
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 | iexCe que fait la commande :
- Elle choisit le binaire par défaut pour votre machine dans la dernière release : Linux et macOS sur x86 64 bits ou ARM 64 bits, Windows sur x86 64 bits. Elle refuse tout autre système ou processeur avec un message indiquant celui qu’elle a trouvé ou vers quoi se tourner à la place. Sur un Mac avec Apple silicon, elle choisit le binaire Apple silicon, même depuis un shell exécuté via Rosetta 2.
- Elle vérifie le binaire par rapport au
SHA256SUMSde la release avant d’installer quoi que ce soit. Un téléchargement dont le digest SHA-256 diffère de celui que donne la liste est supprimé, rien n’est installé, et la commande s’arrête avec un message nommant les deux digests. - Elle installe le binaire pour vous seul, en tant que
~/.local/bin/aggregasous Linux et macOS et en tant que%LOCALAPPDATA%\Programs\aggrega\aggrega.exesous Windows, en créant le dossier s’il manque et en remplaçant en une seule étape une copie antérieure qui s’y trouve, de sorte que relancer la commande met à jour celle que vous avez. Elle n’utilise jamaissudo. Sous Windows, elle supprime aussi la marque que peut porter un fichier téléchargé depuis internet, comme le faitUnblock-Filedans les étapes manuelles. Sous macOS, elle télécharge aveccurl, de sorte que le binaire qu’elle installe ne porte aucune marque de quarantaine (voir Le binaire précompilé pour macOS). - Elle rend la commande accessible. Sous Linux et macOS, lorsque le dossier n’est pas dans votre
PATH, elle affiche une commande qui ajoute le dossier au fichier que votre shell lit au démarrage :~/.zshrcpour zsh,~/.bashrcpour bash (~/.bash_profilesous macOS),~/.config/fish/config.fishpour fish, avec une lignefish_add_path, et~/.profilepour tout autre shell. Elle n’exécute pas cette commande elle-même : exécutez-la et ouvrez un nouveau terminal. Sous Windows, elle ajoute le dossier auPATHde votre utilisateur lorsqu’il n’y figure pas, ainsi qu’auPATHde la fenêtre PowerShell dans laquelle elle s’exécute, de sorte queaggregafonctionne dans cette fenêtre et dans chaque terminal ouvert ensuite, et elle indique qu’elle a ajouté le dossier. - Elle vérifie que le binaire installé s’exécute, et s’arrête avec un message avant que quoi que ce soit d’autre ne soit configuré lorsqu’il ne s’exécute pas. Elle ajoute une note lorsqu’un autre
aggregaprécède dans votrePATHcelui qu’elle a installé. - Elle affiche la version installée, en exécutant le binaire qu’elle a installé par son chemin complet, de sorte que la version s’affiche avant même que votre
PATHn’atteigne le dossier. - Elle se termine par les étapes suivantes, sous
Next:, une ligne pour chacune : la commande qui exécute le quickstart d’IA, comme le décrit Premiers pas ;aggrega skills install --global, qui ajoute la skill Aggrega aux assistants d’IA de votre machine, comme le décrit Ajouter la skill de l’assistant à l’installation ; et l’adresse de cette page, pour la complétion du shell et Connecter un client MCP ci-dessus. Lorsqu’une option a déjà installé la skill, sa ligne est omise.
Ce qu’elle affiche est bref : la version et le système pour lequel elle installe, une ligne une fois que le téléchargement correspond à sa somme de contrôle, et le chemin où elle a installé. Premiers pas montre une exécution complète. --verbose, passée après sh -s -- comme les options ci-dessous, affiche aussi l’adresse de la liste des sommes de contrôle, le nom du fichier de la release et l’adresse depuis laquelle elle le télécharge ; install.ps1 a le même commutateur sous la forme -Verbose, pour une exécution du script avec des arguments, ce que irm … | iex ne peut pas lui fournir. Lorsque la commande refuse ou qu’une étape échoue, elle le dit en une ligne, sur la sortie d’erreur standard pour install.sh et sous la forme de l’erreur ou de l’avertissement que PowerShell affiche pour install.ps1 :
aggrega install: error: <what went wrong> - <what to do>install.sh, le script pour Linux et macOS, nécessite curl ou wget, uname, et sha256sum ou shasum. install.ps1, celui pour Windows, s’exécute dans Windows PowerShell 5.1 et dans PowerShell 7.
Deux paramètres modifient ce qu’elle installe, chacun lu depuis l’environnement dans lequel le script s’exécute :
AGGREGA_VERSIONnomme la release à installer, comme0.8.7, écrite avec ou sans sonvinitial. Non défini, la commande installe la dernière release — celle que GitHub marque comme la plus récente, qui n’est jamais une préversion ; une préversion n’est donc installée qu’en la nommant ici.AGGREGA_INSTALL_DIRnomme le dossier dans lequel installer à la place de celui par défaut. Le binaire y estaggrega,aggrega.exesous Windows, et la commande rend ce dossier accessible comme ci-dessus.
Sous Linux et macOS, placez le paramètre avant sh, et non avant curl, afin que le script le reçoive :
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shDans PowerShell, définissez-le d’abord dans la fenêtre ; il y reste défini jusqu’à ce que vous le supprimiez avec Remove-Item Env:AGGREGA_VERSION :
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexConfigurer la complétion du shell à l’installation
Avec --completion, install.sh configure aussi la complétion du shell, de sorte que la touche Tab complète les commandes et les options de aggrega. Les options se placent après sh -s --, qui les transmet au script que sh lit depuis le pipe :
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | iex ne transmet aucune option à un script. Dans PowerShell, configurez la complétion une fois l’installation terminée, avec le script qu’écrit aggrega completion powershell, comme le décrit Complétion du shell. install.ps1 accepte aussi -Completion, pour une exécution du script avec des arguments.
Elle configure la complétion pour vous seul, sans droits d’administrateur, pour le shell que nomme votre paramètre SHELL, ou dans PowerShell pour le PowerShell dans lequel elle s’exécute. Elle utilise le script qu’écrit aggrega completion du binaire installé lui-même, et nomme chaque fichier qu’elle écrit ou modifie :
- bash : elle écrit le script dans
~/.local/share/bash-completion/completions, le dossier depuis lequel le paquet bash-completion lit vos propres complétions. La complétion bash pouraggreganécessite ce paquet. - zsh : elle écrit
_aggregadans~/.local/share/zsh/site-functionset ajoute à~/.zshrctrois lignes qui placent ce dossier dans le chemin des fonctions de zsh et la chargent, en exécutantcompinitlà où rien dans le fichier ne l’a exécuté auparavant. - fish : elle écrit
aggrega.fishdans~/.config/fish/completions, que fish lit de lui-même. - PowerShell : elle écrit le script sous
%LOCALAPPDATA%\aggrega\completion.ps1et ajoute deux lignes qui le chargent à votre profil pour tous les hôtes du PowerShell dans lequel elle s’exécute,$PROFILE.CurrentUserAllHosts. Windows PowerShell et PowerShell 7 ont des profils distincts ; lancez-la donc depuis chacun de ceux que vous utilisez. Un profil ne s’exécute que là où la stratégie d’exécution que prend une nouvelle fenêtre estRemoteSigned,UnrestrictedouBypass; sous toute autre, commeRestricted, elle n’écrit rien et indique quelle stratégie elle a trouvée. Elle ne modifie jamais la stratégie.
XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR et ZDOTDIR déplacent ces dossiers et fichiers comme chaque shell les lit. Un nouveau terminal ou une nouvelle fenêtre charge la complétion. Relancer la commande ne réécrit un script que lorsque le aggrega installé en écrit un différent, et n’ajoute les lignes à ~/.zshrc ou au profil qu’une seule fois ; c’est aussi la façon d’ajouter la complétion à une installation que vous avez déjà, puisque la commande réinstalle le binaire au passage.
Ajouter la skill de l’assistant à l’installation
Avec --skills (-Skills dans PowerShell), la commande d’installation installe aussi la skill Aggrega — les instructions qui apprennent à un assistant d’IA à installer et à utiliser Aggrega — dans chacun de vos projets, pour les assistants d’IA de votre machine. Les deux options peuvent être données ensemble :
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsDans PowerShell, où irm … | iex ne transmet aucune option, exécutez aggrega skills install --global une fois l’installation terminée : c’est la commande qu’exécute -Skills.
Elle exécute aggrega skills install --global du binaire installé lui-même, qui recherche les assistants sur votre machine — chacun dont le dossier de configuration se trouve dans votre répertoire personnel, ou dont la commande est dans votre PATH — et affiche chacun de ceux qu’il a trouvés et ce qui l’a trouvé. Ensuite :
- Dans un terminal, elle demande d’abord. Appuyez sur Entrée pour installer la skill pour les assistants trouvés, ou tapez les identifiants d’autres assistants pour les ajouter, séparés par des espaces ou des virgules ;
aggrega skills listaffiche les identifiants. Souscurl … | sh, le script se lit lui-même depuis le pipe ; il demande donc plutôt par l’intermédiaire de votre terminal. - Sans terminal par lequel demander, comme dans un script, elle installe pour les assistants trouvés.
- Pour choisir vous-même les assistants, indiquez-les après l’option, séparés par des virgules :
--skills claude-code,cursorou--skills=claude-code,cursor, et dans PowerShell-Skills claude-code,cursor. Elle installe alors pour ceux-ci et n’en recherche pas d’autres.
Elle affiche chaque dossier de skill qu’elle écrit, comme ~/.claude/skills/aggrega pour Claude Code, tous sous votre répertoire personnel. Relancer la commande remplace les copies qu’une exécution précédente a écrites, ce qui permet à la skill de suivre le binaire vers une version plus récente. aggrega skills décrit la commande, le dossier que lit chaque assistant et ce qui trouve chacun d’eux.
Lorsqu’une étape ne peut pas être effectuée
Lorsque la complétion ne peut pas être configurée — un shell qu’elle ne configure pas, comme dash, un dossier dans lequel elle ne peut pas écrire, ou une stratégie d’exécution PowerShell qui n’exécute aucun profil — ou que la skill ne peut pas être installée — aucun assistant trouvé et aucun nommé, un identifiant qu’elle ne connaît pas, ou un fichier dans un dossier de skill qu’aucune installation n’a écrit —, le binaire est tout de même installé et fonctionne. La commande indique pourquoi l’étape a échoué, affiche les étapes suivantes et se termine par un statut indiquant quelle étape a échoué. Les statuts sont :
| Statut | Signification |
|---|---|
0 | aggrega est installé, et chaque étape demandée par une option a réussi |
1 | rien n’a été installé, ou le aggrega installé ne s’est pas exécuté |
2 | la commande a reçu une option qu’elle n’accepte pas, ou une liste ne nommant aucun assistant ; elle n’a rien fait |
3 | aggrega est installé et fonctionne, mais la configuration de la complétion du shell a échoué |
4 | aggrega est installé et fonctionne, mais l’installation de la skill a échoué |
5 | aggrega est installé et fonctionne, mais ces deux étapes ont échoué |
Le script PowerShell ne ferme jamais la fenêtre dans laquelle il s’exécute ; il laisse donc le statut dans $LASTEXITCODE, et tout statut autre que 0 se termine par une erreur, que powershell -Command et pwsh -Command signalent comme code de sortie 1.
Installer avec le programme d’installation Windows
Chaque release fournit un programme d’installation Windows, aggrega-<version>-windows-amd64-setup.exe, sur la page de la release à https://github.com/aggrega-ai/aggrega-cli/releases. Téléchargez-le et exécutez-le. Il installe le aggrega.exe par défaut pour vous seul, sans droits d’administrateur et sans les demander, au moyen d’un court assistant :
- Une page d’accueil, puis la licence, l’Apache License 2.0 d’Aggrega : rien n’est installé tant que vous n’avez pas appuyé sur I Agree. Puis les composants : Aggrega lui-même, toujours installé, et Add to PATH, sélectionné.
- Le dossier d’installation,
%LOCALAPPDATA%\Programs\aggregasauf si vous en choisissez un autre ; c’est le dossier qu’utilise la commande d’installation. - La progression, puis une page de fin qui nomme le dossier et indique si cette installation l’a ajouté à votre
PATH, avec les étapes suivantes : installer le skill Aggrega avecaggrega skills install --global, et connecter votre client d’IA comme le décrit Connecter un client MCP.
Ce qu’il fait :
- Avec Add to PATH sélectionné, il ajoute le dossier d’installation au
PATHde votre utilisateur, sauf s’il y figure déjà. Un terminal ouvert après l’installation trouveaggrega; un terminal déjà ouvert conserve lePATHavec lequel il a démarré. Avec l’option désélectionnée, rien n’est ajouté à votrePATH, et un terminal exécuteaggrega.exepar son chemin complet ; une entrée ajoutée par une installation antérieure est laissée telle quelle. - Il liste Aggrega parmi vos applications installées, avec Cognitio s.r.l. comme éditeur, de sorte qu’il se désinstalle depuis Settings → Apps comme n’importe quelle autre application. Le programme de désinstallation vous demande de confirmer, puis supprime les fichiers que le programme d’installation a placés dans le dossier, l’entrée du
PATHet l’entrée dans cette liste, et supprime le dossier lorsqu’il n’y reste plus rien d’autre. - Relancé, il installe par-dessus ce qui s’y trouve, en proposant le dossier dans lequel il a installé la dernière fois, de sorte que le programme d’installation d’une release ultérieure met à jour la copie que vous avez, en conservant une seule entrée dans votre
PATH. - À côté de
aggrega.exe, le dossier contientuninstall.exe,LICENSEavec le texte de la licence, etEnVar.dll, le composant avec lequel le programme d’installation et le programme de désinstallation modifient votrePATH.
Lorsque aggrega.exe est en cours d’exécution — lancé par un éditeur ou un client IA — le programme d’installation ne peut pas le remplacer et s’arrête avec un message qui le dit ; fermez ce qui l’a lancé et relancez le programme d’installation. Le programme de désinstallation s’arrête de la même façon, avant d’avoir supprimé quoi que ce soit.
Pour installer sans fenêtre, depuis un script ou un outil qui installe des logiciels sur de nombreuses machines, lancez le programme d’installation avec /S, écrit en majuscule ; il installe alors sans fenêtre ni question, dans le dossier qu’a utilisé une installation antérieure ou sinon dans le dossier par défaut, avec Add to PATH, et signale un échec par son code de sortie, qui n’est pas 0. Le programme de désinstallation accepte la même option :
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /SLe programme d’installation est signé comme les exécutables, avec l’éditeur Cognitio S.r.l. et un horodatage : les vérifications de Le binaire précompilé pour Windows s’y appliquent comme à aggrega.exe, de même que ce qui y est dit sur les invites que Windows peut afficher pour un fichier téléchargé. SHA256SUMS liste son digest comme celui de tout autre fichier de la release.
Lorsque le programme d’installation ne convient pas, la commande d’installation ci-dessus et les étapes manuelles installent le même aggrega.exe dans le même dossier.
Installer avec un gestionnaire de paquets
Chaque release met aussi à jour une formule Homebrew et un manifeste Scoop, de sorte que le gestionnaire de paquets que vous utilisez déjà peut installer Aggrega et le tenir à jour. Chacun installe le même binaire par défaut que la commande d’installation, vérifié par rapport au digest SHA-256 que lui attribue le SHA256SUMS de la release.
Sous macOS et Linux, brew install aggrega-ai/tap/aggrega l’installe avec Homebrew. Homebrew ajoute le tap aggrega-ai/tap la première fois et installe le binaire pour votre système et votre processeur : macOS sur Apple silicon ou sur Intel, Linux sur x86 64 bits ou sur ARM 64 bits. Après une nouvelle release, brew upgrade le met à jour, avec toutes les autres formules que vous avez installées.
Sous Windows, avec Scoop, ajoutez une fois le bucket Aggrega, avec scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, et installez depuis celui-ci avec scoop install aggrega. Scoop installe le binaire Windows en tant que aggrega.exe et le rend accessible en tant que aggrega via le dossier de shims qu’il maintient dans votre PATH. Après une nouvelle release, scoop update actualise les buckets et scoop update aggrega le met à jour.
Homebrew et Scoop installent chacun dans leurs propres dossiers plutôt que dans ~/.local/bin ou %LOCALAPPDATA%\Programs\aggrega, et ne mettent à jour que la copie qu’ils ont installée. Utilisez une seule méthode d’installation sur une machine : une copie installée par la commande d’installation ou à la main et une autre installée par Homebrew ou Scoop font deux copies, et le dossier qui vient en premier dans votre PATH décide laquelle s’exécute.
Installer avec winget
Sous Windows, winget install Cognitio.Aggrega l’installe avec winget, le gestionnaire de paquets Windows. winget télécharge le programme d’installation Windows de la release depuis la page de la release, le vérifie par rapport au digest SHA-256 que donne le manifeste du paquet, et l’exécute sans intervention. Le résultat est celui du programme d’installation lui-même : aggrega.exe dans %LOCALAPPDATA%\Programs\aggrega, ou dans le dossier qu’a utilisé une installation antérieure, ce dossier dans le PATH de votre utilisateur, et Aggrega dans votre liste d’applications installées, le tout sans droits d’administrateur. winget ne modifie pas le PATH du terminal dans lequel il s’exécute, ouvrez donc un nouveau terminal avant de lancer aggrega version.
winget upgrade Cognitio.Aggrega installe une release ultérieure par-dessus, et winget uninstall Cognitio.Aggrega exécute son programme de désinstallation. winget, le programme d’installation et la commande d’installation installent tous dans le même dossier, sauf si vous en choisissez un autre dans le programme d’installation, de sorte que celui qui s’exécute en dernier y place son aggrega.exe.
L’installer à la main
Chaque release fournit des binaires précompilés pour Linux sur x86 64 bits et sur ARM 64 bits, pour Windows sur x86 64 bits, et pour macOS sur Apple silicon et sur Intel, sur la page de la release à https://github.com/aggrega-ai/aggrega-cli/releases. Téléchargez l’exécutable pour votre système d’exploitation et votre processeur — Choisir le fichier ci-dessous les nomme tous — et vérifiez-le par rapport au SHA256SUMS de la release, comme décrit à cet endroit. Rendez-le ensuite exécutable et déplacez-le vers ~/.local/bin/aggrega. Sous Linux, depuis le répertoire où se trouve le téléchargement, avec <version> remplacé par la version que vous avez téléchargée, et amd64 par arm64 sur ARM 64 bits :
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaSous Windows, voir Le binaire précompilé pour Windows ci-dessous ; sous macOS, voir Le binaire précompilé pour macOS.
Lorsque ~/.local/bin n’est pas dans votre PATH, ajoutez cette ligne au fichier que votre shell lit au démarrage — ~/.zshrc pour zsh, ~/.bashrc pour bash (~/.bash_profile sous macOS) — et ouvrez un nouveau terminal :
export PATH="$HOME/.local/bin:$PATH"Depuis les sources, avec une chaîne d’outils Go installée, compilez la commande aggrega depuis l’arborescence des sources et placez le binaire obtenu dans le même dossier.
Confirmez l’installation avec aggrega version, comme à la fin de Installer le binaire.
Choisir le fichier
Une release nomme chaque exécutable aggrega-<version>-<system>-<processor>, avec .exe sous Windows :
| Système | Processeur | Fichier |
|---|---|---|
| Linux | x86 64 bits (uname -m affiche x86_64) | aggrega-<version>-linux-amd64 |
| Linux | ARM 64 bits (uname -m affiche aarch64) | aggrega-<version>-linux-arm64 |
| Windows | x86 64 bits | aggrega-<version>-windows-amd64.exe |
| macOS | Apple silicon | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<version>-darwin-amd64 |
Ce fichier est celui qu’installe la commande d’installation, et celui à télécharger à la main. Deux variantes se trouvent à côté de lui ; la commande d’installation n’installe ni l’une ni l’autre, et chacune s’installe à la main de la même façon :
aggrega-debug-<version>-…est le même programme avec ses informations de débogage, que lit un débogueur ou un profileur. Il s’exécute et indique sa version exactement comme le fichier par défaut, et il est plus volumineux.aggrega-light-<version>-…est compilé sans les plugins intégrés : il résout chaque plugin via la cascade de plugins, telle que l’espace de travail la configure, au lieu de trouver les plugins principaux en lui-même.
Pour Windows, la release fournit aussi aggrega-<version>-windows-amd64-setup.exe, le programme d’installation Windows, qui installe le fichier par défaut pour vous.
Chaque release fournit aussi SHA256SUMS, le digest SHA-256 de chaque autre fichier qu’elle joint, y compris les deux scripts d’installation, sous la forme que lit sha256sum. La commande d’installation effectue elle-même cette vérification. Pour vérifier un téléchargement à la main sous Linux, avec SHA256SUMS dans le même répertoire :
sha256sum --check --ignore-missing SHA256SUMSLe fichier que vous avez téléchargé est signalé OK ; tout autre résultat signifie que ce n’est pas le fichier publié par la release.
Le binaire précompilé pour Windows
L’exécutable Windows est aggrega-<version>-windows-amd64.exe (les variantes debug et light à côté de lui dans la release s’installent de la même façon). Renommez-le en aggrega.exe, déplacez-le dans %LOCALAPPDATA%\Programs\aggrega, le dossier qu’utilise la commande d’installation, et ajoutez ce dossier au PATH de votre utilisateur : Windows exécute un fichier se terminant par .exe sans qu’il faille le marquer comme exécutable, et le trouve comme commande aggrega sous ce nom. Depuis PowerShell, par exemple, avec <version> remplacé par la version que vous avez téléchargée :
$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")Un terminal ouvert après cela trouve aggrega ; un terminal déjà ouvert conserve le PATH avec lequel il a démarré.
Les exécutables sont signés. Chacun porte une signature Authenticode, la signature de code que Windows vérifie, et l’éditeur que Windows affiche pour elle est Cognitio S.r.l. Chaque signature porte aussi un horodatage : le certificat derrière une signature n’est valide que quelques jours, et l’horodatage est ce qui maintient la signature valide après l’expiration de ce certificat. Pour vérifier un fichier téléchargé avant de l’exécuter :
-
Dans l’Explorateur de fichiers, ouvrez les Properties du fichier et son onglet Digital Signatures. La liste des signatures indique Cognitio S.r.l. ; sélectionnez-la puis Details, qui indique This digital signature is OK.
-
Dans PowerShell, avec
$dircomme dans l’exemple ci-dessus :Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatusindiqueValid, et le sujet commence parCN=Cognitio S.r.l..NotSignedouHashMismatchsignifie que le fichier n’est pas celui que la release a publié, ou qu’il a été modifié après sa signature.
Une signature nomme l’éditeur ; elle ne fait pas disparaître tous les avertissements. Celui que vous rencontrez dépend de la façon dont le fichier est arrivé et dont vous le lancez :
- Pendant le téléchargement, un navigateur peut avertir que le fichier n’est pas couramment téléchargé et demander s’il faut le conserver. Le conserver enregistre le fichier tel qu’il a été téléchargé.
- Lorsque vous le lancez depuis l’Explorateur de fichiers ou depuis le navigateur, Windows peut afficher Windows protected your PC. Cette invite provient de Microsoft Defender SmartScreen, qui pèse la réputation qu’un fichier et son éditeur ont acquise ; une version nouvellement publiée peut donc encore la rencontrer, toute signée qu’elle soit, jusqu’à ce que sa propre réputation se construise. Pour un fichier signé, l’invite nomme l’éditeur : sélectionnez More info, vérifiez qu’elle nomme Cognitio S.r.l. et le nom du fichier que vous avez téléchargé, puis sélectionnez Run anyway. Lancé plutôt depuis PowerShell ou une invite de commandes, le même fichier peut s’exécuter sans cette invite ; cela dépend de la version de Windows et de ses paramètres.
Unblock-Filerépond à cette invite à l’avance. Un fichier téléchargé est marqué comme provenant d’internet, et c’est à cette marque que répond la vérification Windows protected your PC.Unblock-Filedans PowerShell, comme dans l’exemple ci-dessus, supprime la marque ; la case Unblock de l’onglet General des Properties du fichier dans l’Explorateur de fichiers fait de même.- Là où Smart App Control est activé (Windows 11), il vérifie un programme lorsque vous le lancez. Selon la description de Microsoft, Smart App Control demande d’abord au service de sécurité cloud de Microsoft si le programme est sûr ; lorsque ce service ne peut pas faire de prédiction fiable, il vérifie la signature, laissant s’exécuter un programme dont la signature est valide et bloquant celui qui n’est pas signé ou dont la signature n’est pas valide. App & browser control dans Sécurité Windows indique s’il est activé.
Le binaire précompilé pour macOS
Les exécutables macOS sont aggrega-<version>-darwin-arm64, pour un Mac avec Apple silicon, et aggrega-<version>-darwin-amd64, pour un Mac avec processeur Intel ; About This Mac dans le menu Pomme indique lequel vous avez. Les variantes debug et light à côté d’eux dans la release s’installent de la même façon. Un Mac avec Apple silicon exécute aussi le fichier Intel, via Rosetta 2 là où il est installé, mais le fichier Apple silicon est celui qui est compilé pour lui.
Renommez le fichier en aggrega, rendez-le exécutable et déplacez-le dans ~/.local/bin, le dossier qu’utilise la commande d’installation. Depuis Terminal, par exemple, dans le répertoire où se trouve le téléchargement, avec <version> remplacé par la version que vous avez téléchargée, et arm64 par amd64 sur un Mac Intel :
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregaLe mkdir crée le dossier là où il n’existe pas encore. ~/.local/bin ne fait pas partie du PATH que macOS donne à un nouveau terminal, ajoutez donc la ligne de L’installer à la main à ~/.zshrc, ou à ~/.bash_profile pour bash, sauf si elle y figure déjà.
Les exécutables sont signés et notariés. Chacun porte une signature de code réalisée avec le Developer ID de Cognitio s.r.l. — le certificat qu’Apple délivre à un développeur pour les logiciels distribués en dehors du Mac App Store — avec le runtime renforcé et un horodatage sécurisé, et le service de notarisation d’Apple a vérifié et notarié chacun d’eux. Gatekeeper, la vérification de macOS sur les logiciels provenant d’internet, évalue un programme qui porte la marque de quarantaine, la marque qu’un navigateur web ajoute à un fichier qu’il télécharge, et accepte celui qu’Apple a notarié, de sorte qu’un fichier téléchargé depuis la page de la release s’exécute tel quel. Un ticket de notarisation ne peut pas être attaché à un fichier exécutable isolé, Gatekeeper trouve donc le ticket en ligne la première fois que le fichier s’exécute ; sur un Mac hors ligne à ce moment-là, Gatekeeper peut bloquer le fichier jusqu’à ce que le Mac puisse joindre Apple.
Pour vérifier un fichier téléchargé avant de l’exécuter, depuis Terminal, avec le nom du fichier que vous avez téléchargé :
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64La première indique que le fichier est valid on disk et satisfies its Designated Requirement. La seconde liste les autorités de la signature, la première étant Developer ID Application: COGNITIO SRL suivie de l’identifiant d’équipe entre parenthèses, ainsi qu’un Timestamp. Un fichier qui échoue à l’une ou l’autre n’est pas celui publié par la release, ou a été modifié après avoir été signé.
Un fichier récupéré avec curl ne porte aucune marque de quarantaine, Gatekeeper ne l’évalue donc pas du tout : curl n’ajoute pas la marque qu’ajoute un navigateur. C’est aussi pourquoi le binaire que la commande d’installation met en place s’exécute sans cette évaluation.