Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Instalar o Aggrega

O Aggrega precisa de duas coisas: o binário aggrega instalado e, para escrever com um assistente de IA, o cliente do seu assistente conectado ao servidor MCP que o binário traz. Os comandos vêm primeiro; o que cada um faz, e as outras formas de instalar, vêm depois.

Instalar o binário

No Linux e no macOS, em um terminal:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

No Windows, no PowerShell:

Terminal window
irm https://aggrega.ai/install.ps1 | iex

Com o Homebrew, no macOS e no Linux:

Terminal window
brew install aggrega-ai/tap/aggrega

Com o Scoop, no Windows:

Terminal window
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket
scoop install aggrega

Com o winget, no Windows:

Terminal window
winget install Cognitio.Aggrega

Depois verifique se ele é executado:

Terminal window
aggrega version

Uma string de versão significa que o binário é encontrado e pode ser executado. Isso é tudo de que o servidor MCP precisa. Cada forma de instalar, em detalhes explica o que cada comando faz, onde ele coloca o binário e como instalar com o instalador do Windows ou manualmente.

Conectar um cliente MCP

O cliente do seu assistente de IA inicia o servidor MCP do Aggrega executando aggrega mcp, e Conectar o servidor MCP indica o comando ou a entrada que o adiciona, cliente por cliente. Em um assistente que instala plugins, o plugin do Aggrega adiciona o servidor e a skill do Aggrega em uma única etapa: veja Instalar o plugin.

Cada forma de instalar, em detalhes

O Aggrega é distribuído como um único executável. Um único comando o instala; as etapas manuais que vêm depois fazem o mesmo à mão. Ambos o colocam em uma pasta sua, sempre a mesma, e nenhum precisa de direitos de administrador: ~/.local/bin/aggrega no Linux e no macOS, e %LOCALAPPDATA%\Programs\aggrega\aggrega.exe no Windows. No Windows, o instalador do Windows e o winget o instalam nessa mesma pasta, também sem direitos de administrador, e o listam entre seus aplicativos instalados: consulte Instalar com o instalador do Windows e Instalar com o winget. O Homebrew, no macOS e no Linux, e o Scoop, no Windows, também o instalam, cada um em suas próprias pastas: consulte Instalar com um gerenciador de pacotes.

Instalar com um único comando

O comando de instalação é curl -fsSL https://aggrega.ai/install.sh | sh no Linux e no macOS e irm https://aggrega.ai/install.ps1 | iex no PowerShell no Windows, os dois primeiros comandos de Instalar o binário. Esses dois endereços redirecionam para os scripts de instalação que a release mais recente anexa, então os mesmos comandos também funcionam com os endereços da própria release:

Terminal window
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | sh
Terminal window
irm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iex

O que o comando faz:

  • Ele escolhe o binário padrão para a sua máquina a partir da release mais recente: Linux e macOS em x86 de 64 bits ou ARM de 64 bits, Windows em x86 de 64 bits. Ele recusa qualquer outro sistema ou processador com uma mensagem dizendo qual encontrou ou a que recorrer em vez disso. Em um Mac com Apple silicon, ele escolhe o binário Apple silicon, mesmo a partir de um shell executado via Rosetta 2.
  • Ele verifica o binário em relação ao SHA256SUMS da release antes de instalar qualquer coisa. Um download cujo digest SHA-256 difere do indicado na lista é excluído, nada é instalado e o comando para com uma mensagem que nomeia os dois digests.
  • Ele instala o binário só para você, como ~/.local/bin/aggrega no Linux e no macOS e como %LOCALAPPDATA%\Programs\aggrega\aggrega.exe no Windows, criando a pasta quando ela não existe e substituindo em uma única etapa uma cópia anterior que esteja ali, de modo que executar o comando novamente atualiza a que você tem. Ele nunca usa sudo. No Windows, ele também remove a marca que um arquivo baixado da internet pode carregar, como faz Unblock-File nas etapas manuais. No macOS, ele baixa com curl, então o binário que instala não tem marca de quarentena (consulte O binário pré-compilado para macOS).
  • Ele torna o comando acessível. No Linux e no macOS, quando a pasta não está no seu PATH, ele imprime um comando que adiciona a pasta ao arquivo que seu shell lê ao iniciar: ~/.zshrc para zsh, ~/.bashrc para bash (~/.bash_profile no macOS), ~/.config/fish/config.fish para fish, com uma linha fish_add_path, e ~/.profile para qualquer outro shell. Ele não executa esse comando por conta própria: execute-o e abra um novo terminal. No Windows, ele adiciona a pasta ao PATH do seu usuário quando ela não está lá, e ao PATH da janela do PowerShell em que é executado, de modo que aggrega funciona nessa janela e em todo terminal aberto depois, e informa que adicionou a pasta.
  • Ele verifica se o binário instalado executa, e para com uma mensagem antes de configurar qualquer outra coisa quando ele não executa. Ele acrescenta uma observação quando outro aggrega vem antes, no seu PATH, daquele que ele instalou.
  • Ele imprime a versão instalada, executando o binário que instalou pelo caminho completo, para que a versão apareça antes mesmo de o seu PATH incluir a pasta.
  • Ele termina com os próximos passos, sob Next:, uma linha para cada um: o comando que executa o quickstart de IA, como descreve Primeiros passos; aggrega skills install --global, que adiciona a skill do Aggrega aos assistentes de IA na sua máquina, como descreve Adicionar a skill do assistente ao instalar; e o endereço desta página, para o autocompletar do shell e Conectar um cliente MCP acima. Quando uma opção já instalou a skill, a linha dela é omitida.

O que ele imprime é curto: a versão e o sistema para o qual instala, uma linha assim que o download confere com seu checksum, e o caminho em que instalou. Primeiros passos mostra uma execução completa. --verbose, passado depois de sh -s -- como as opções abaixo, também imprime o endereço da lista de checksums, o nome do arquivo da release e o endereço de onde o baixa; install.ps1 tem a mesma opção como -Verbose, para uma execução do script com argumentos, que irm … | iex não consegue lhe dar. Quando o comando se recusa ou um passo falha, ele informa isso em uma linha, na saída de erro padrão a partir de install.sh e como o erro ou aviso que o PowerShell exibe a partir de install.ps1:

aggrega install: error: <what went wrong> - <what to do>

install.sh, o script para Linux e macOS, precisa de curl ou wget, uname, e sha256sum ou shasum. install.ps1, o do Windows, é executado no Windows PowerShell 5.1 e no PowerShell 7.

Duas configurações mudam o que ele instala, cada uma lida do ambiente em que o script é executado:

  • AGGREGA_VERSION nomeia a release a instalar, como 0.8.7, escrita com ou sem o v inicial. Se não estiver definida, o comando instala a release mais recente — a que o GitHub marca como mais recente, que nunca é uma pré-release, então uma pré-release só é instalada nomeando-a aqui.
  • AGGREGA_INSTALL_DIR nomeia a pasta em que instalar no lugar da padrão. O binário ali é aggrega, aggrega.exe no Windows, e o comando torna essa pasta acessível como acima.

No Linux e no macOS, coloque a configuração antes de sh, não antes de curl, para que o script a receba:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> sh

No PowerShell, defina-a primeiro na janela; ela permanece definida ali até você removê-la com Remove-Item Env:AGGREGA_VERSION:

Terminal window
$env:AGGREGA_VERSION = "<version>"
irm https://aggrega.ai/install.ps1 | iex

Configurar o autocompletar do shell ao instalar

Com --completion, o install.sh também configura o autocompletar do shell, para que a tecla Tab complete os comandos e as flags do aggrega. As opções vão depois de sh -s --, que as repassa ao script que o sh lê do pipe:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion

irm … | iex não passa nenhuma opção a um script. No PowerShell, configure o autocompletar depois que a instalação terminar, com o script que aggrega completion powershell escreve, como descreve Autocompletar do shell. install.ps1 também aceita -Completion, para uma execução do script com argumentos.

Ele configura o autocompletar só para você, sem direitos de administrador, para o shell que a sua variável SHELL indica, ou no PowerShell para o PowerShell em que é executado. Ele usa o script que o próprio aggrega completion do binário instalado escreve, e nomeia cada arquivo que escreve ou altera:

  • bash: ele escreve o script em ~/.local/share/bash-completion/completions, a pasta da qual o pacote bash-completion lê os seus próprios autocompletares. O autocompletar do bash para aggrega precisa desse pacote.
  • zsh: ele escreve _aggrega em ~/.local/share/zsh/site-functions e adiciona ao ~/.zshrc três linhas que colocam essa pasta no caminho de funções do zsh e o carregam, executando compinit onde nada no arquivo o executou antes.
  • fish: ele escreve aggrega.fish em ~/.config/fish/completions, que o fish lê por conta própria.
  • PowerShell: ele escreve o script como %LOCALAPPDATA%\aggrega\completion.ps1 e adiciona ao seu perfil, para todos os hosts do PowerShell em que é executado, $PROFILE.CurrentUserAllHosts, duas linhas que o carregam. O Windows PowerShell e o PowerShell 7 mantêm perfis separados, então execute-o a partir de cada um que você usa. Um perfil só é executado onde a política de execução que uma nova janela assume é RemoteSigned, Unrestricted ou Bypass; com qualquer outra, como Restricted, ele não escreve nada e diz qual política encontrou. Ele nunca altera a política.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR e ZDOTDIR movem essas pastas e arquivos conforme cada shell os lê. Um novo terminal ou janela carrega o autocompletar. Executar o comando de novo só reescreve um script quando o aggrega instalado escreve um diferente, e adiciona as linhas ao ~/.zshrc ou ao perfil uma única vez; essa também é a forma de adicionar o autocompletar a uma instalação que você já tem, já que o comando instala o binário de novo no caminho.

Adicionar a skill do assistente ao instalar

Com --skills (-Skills no PowerShell), o comando de instalação também instala a skill do Aggrega — as instruções que ensinam um assistente de IA a instalar e usar o Aggrega — em todos os seus projetos, para os assistentes de IA na sua máquina. As duas opções podem ser dadas juntas:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skills

No PowerShell, onde irm … | iex não passa nenhuma opção, execute aggrega skills install --global depois que a instalação terminar: é o comando que -Skills executa.

Ele executa o próprio aggrega skills install --global do binário instalado, que procura os assistentes na sua máquina — cada um cuja pasta de configuração está no seu diretório home, ou cujo comando está no seu PATH — e imprime cada um que encontrou e o que o encontrou. Depois:

  • Em um terminal, ele pergunta primeiro. Pressione Enter para instalar a skill para os assistentes encontrados, ou digite os identificadores de outros para adicioná-los, separados por espaços ou vírgulas; aggrega skills list imprime os identificadores. Com curl … | sh o script lê a si mesmo do pipe, então ele pergunta pelo seu terminal.
  • Sem um terminal pelo qual perguntar, como em um script, ele instala para os assistentes que encontrou.
  • Para escolher você mesmo os assistentes, informe-os depois da opção, separados por vírgulas: --skills claude-code,cursor, ou --skills=claude-code,cursor, e no PowerShell -Skills claude-code,cursor. Ele então instala para esses e não procura outros.

Ele imprime cada pasta de skill que escreve, como ~/.claude/skills/aggrega para o Claude Code, todas dentro do seu diretório home. Executar o comando de novo substitui as cópias que uma execução anterior escreveu, e é assim que a skill acompanha o binário até uma versão mais nova. aggrega skills descreve o comando, a pasta que cada assistente lê e o que encontra cada um.

Quando um passo não pode ser realizado

Quando o autocompletar não pode ser configurado — um shell que ele não configura, como dash, uma pasta em que ele não consegue escrever, ou uma política de execução do PowerShell que não executa nenhum perfil — ou a skill não pode ser instalada — nenhum assistente encontrado e nenhum informado, um identificador que ele não conhece, ou um arquivo em uma pasta de skill que nenhuma instalação escreveu —, o binário continua instalado e é executado. O comando diz por que o passo falhou, imprime os próximos passos e termina com um status que diz qual passo falhou. Os status são:

StatusSignificado
0aggrega está instalado, e todo passo que uma opção pediu foi bem-sucedido
1nada foi instalado, ou o aggrega instalado não foi executado
2o comando recebeu uma opção que não aceita, ou uma lista que não nomeia nenhum assistente; ele não fez nada
3aggrega está instalado e é executado, mas a configuração do autocompletar do shell falhou
4aggrega está instalado e é executado, mas a instalação da skill falhou
5aggrega está instalado e é executado, mas as duas coisas falharam

O script do PowerShell nunca fecha a janela em que é executado, então ele deixa o status em $LASTEXITCODE, e todo status diferente de 0 termina em um erro, que powershell -Command e pwsh -Command informam como status de saída 1.

Instalar com o instalador do Windows

Cada release traz um instalador do Windows, aggrega-<version>-windows-amd64-setup.exe, na página da release em https://github.com/aggrega-ai/aggrega-cli/releases. Baixe-o e execute-o. Ele instala o aggrega.exe padrão só para você, sem direitos de administrador e sem pedi-los, por meio de um breve assistente:

  • Uma página de boas-vindas, depois a licença, a Apache License 2.0 do Aggrega: nada é instalado até você pressionar I Agree. Depois os componentes: o próprio Aggrega, sempre instalado, e Add to PATH, selecionado.
  • A pasta de instalação, %LOCALAPPDATA%\Programs\aggrega, a menos que você escolha outra; é a pasta que o comando de instalação usa.
  • O progresso, depois uma página final que nomeia a pasta e diz se esta instalação a adicionou ao seu PATH, com os próximos passos: instalar a skill do Aggrega com aggrega skills install --global e conectar seu cliente de IA como descreve Conectar um cliente MCP.

O que ele faz:

  • Com Add to PATH selecionado, ele adiciona a pasta de instalação ao PATH do seu usuário, a menos que ela já esteja lá. Um terminal aberto depois da instalação encontra aggrega; um já aberto mantém o PATH com que foi iniciado. Com a opção desmarcada, nada é adicionado ao seu PATH, e um terminal executa aggrega.exe pelo caminho completo; uma entrada que uma instalação anterior adicionou é deixada como está.
  • Ele lista o Aggrega entre seus aplicativos instalados, com a Cognitio s.r.l. como editora, então ele é desinstalado em Settings → Apps como qualquer outro aplicativo. O desinstalador pede que você confirme e então remove os arquivos que o instalador colocou na pasta, a entrada do PATH e a entrada nessa lista, e remove a pasta quando não sobra mais nada nela.
  • Executado novamente, ele instala por cima do que existe, oferecendo a pasta em que instalou da última vez, então o instalador de uma release posterior atualiza a cópia que você tem, mantendo uma única entrada no seu PATH.
  • Ao lado de aggrega.exe, a pasta contém uninstall.exe, LICENSE com o texto da licença e EnVar.dll, o componente com que o instalador e o desinstalador editam seu PATH.

Quando aggrega.exe está em execução — iniciado por um editor ou por um cliente de IA — o instalador não consegue substituí-lo e para com uma mensagem dizendo isso; feche o que o iniciou e execute o instalador novamente. O desinstalador para da mesma forma, antes de ter removido qualquer coisa.

Para instalar sem janelas, a partir de um script ou de uma ferramenta que instala software em muitas máquinas, execute o instalador com /S, escrito em maiúscula; ele então instala sem janela nem perguntas, na pasta que uma instalação anterior usou ou, caso contrário, na padrão, com Add to PATH, e informa uma falha pelo código de saída, que não é 0. O desinstalador aceita a mesma opção:

Terminal window
.\aggrega-<version>-windows-amd64-setup.exe /S
& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /S

O instalador é assinado como os executáveis, com a editora Cognitio S.r.l. e um carimbo de data/hora: as verificações em O binário pré-compilado para Windows se aplicam a ele como a aggrega.exe, assim como o que ali se diz sobre os avisos que o Windows pode mostrar para um arquivo baixado. SHA256SUMS lista o digest dele como faz com todos os outros arquivos da release.

Onde o instalador não for adequado, o comando de instalação acima e as etapas manuais instalam o mesmo aggrega.exe na mesma pasta.

Instalar com um gerenciador de pacotes

Cada release também atualiza uma fórmula do Homebrew e um manifesto do Scoop, para que o gerenciador de pacotes que você já usa possa instalar o Aggrega e mantê-lo atualizado. Cada um instala o mesmo binário padrão que o comando de instalação, verificado em relação ao digest SHA-256 que o SHA256SUMS da release atribui a ele.

No macOS e no Linux, brew install aggrega-ai/tap/aggrega o instala com o Homebrew. O Homebrew adiciona o tap aggrega-ai/tap na primeira vez e instala o binário para o seu sistema e processador: macOS em Apple silicon ou em Intel, Linux em x86 de 64 bits ou em ARM de 64 bits. Depois de uma nova release, brew upgrade o atualiza, junto com todas as outras fórmulas que você instalou.

No Windows, com o Scoop, adicione uma vez o bucket do Aggrega, com scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, e instale a partir dele com scoop install aggrega. O Scoop instala o binário do Windows como aggrega.exe e o torna acessível como aggrega por meio da pasta de shims que mantém no seu PATH. Depois de uma nova release, scoop update atualiza os buckets e scoop update aggrega o atualiza.

O Homebrew e o Scoop instalam cada um em suas próprias pastas em vez de em ~/.local/bin ou %LOCALAPPDATA%\Programs\aggrega, e atualizam apenas a cópia que instalaram. Use uma única forma de instalação em uma máquina: uma cópia instalada pelo comando de instalação ou à mão e outra instalada pelo Homebrew ou pelo Scoop são duas cópias, e a pasta que vem primeiro no seu PATH decide qual é executada.

Instalar com o winget

No Windows, winget install Cognitio.Aggrega o instala com o winget, o Gerenciador de Pacotes do Windows. O winget baixa o instalador do Windows da release a partir da página da release, verifica-o em relação ao digest SHA-256 indicado no manifesto do pacote e o executa sem intervenção. O resultado é o do próprio instalador: aggrega.exe em %LOCALAPPDATA%\Programs\aggrega, ou na pasta que uma instalação anterior usou, essa pasta no PATH do seu usuário e o Aggrega na sua lista de aplicativos instalados, tudo sem direitos de administrador. O winget não altera o PATH do terminal em que é executado, então abra um novo terminal antes de executar aggrega version.

winget upgrade Cognitio.Aggrega instala uma release posterior por cima dele, e winget uninstall Cognitio.Aggrega executa seu desinstalador. O winget, o instalador e o comando de instalação instalam todos na mesma pasta, a menos que você escolha outra no instalador, então o que for executado por último coloca ali o seu aggrega.exe.

Instalar à mão

Cada release traz binários pré-compilados para Linux em x86 de 64 bits e em ARM de 64 bits, para Windows em x86 de 64 bits e para macOS em Apple silicon e em Intel, na página da release em https://github.com/aggrega-ai/aggrega-cli/releases. Baixe o executável para o seu sistema operacional e processador — Escolher o arquivo, abaixo, nomeia cada um — e verifique-o em relação ao SHA256SUMS da release, como descrito ali. Depois marque-o como executável e mova-o para ~/.local/bin/aggrega. No Linux, a partir do diretório em que está o download, com <version> substituído pela versão que você baixou, e amd64 por arm64 em ARM de 64 bits:

Terminal window
chmod +x aggrega-<version>-linux-amd64
mkdir -p ~/.local/bin
mv aggrega-<version>-linux-amd64 ~/.local/bin/aggrega

No Windows, consulte O binário pré-compilado para Windows abaixo; no macOS, consulte O binário pré-compilado para macOS.

Quando ~/.local/bin não estiver no seu PATH, adicione esta linha ao arquivo que seu shell lê ao iniciar — ~/.zshrc para zsh, ~/.bashrc para bash (~/.bash_profile no macOS) — e abra um novo terminal:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

A partir do código-fonte, com um toolchain Go instalado, compile o comando aggrega a partir da árvore de código-fonte e coloque o binário resultante na mesma pasta.

Confirme a instalação com aggrega version, como no final de Instalar o binário.

Escolher o arquivo

Uma release nomeia cada executável aggrega-<version>-<system>-<processor>, com .exe no Windows:

SistemaProcessadorArquivo
Linuxx86 de 64 bits (uname -m imprime x86_64)aggrega-<version>-linux-amd64
LinuxARM de 64 bits (uname -m imprime aarch64)aggrega-<version>-linux-arm64
Windowsx86 de 64 bitsaggrega-<version>-windows-amd64.exe
macOSApple siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

Esse arquivo é o que o comando de instalação instala, e o que se baixa à mão. Duas variantes dele ficam ao lado; o comando de instalação não instala nenhuma delas, e cada uma é instalada à mão da mesma forma:

  • aggrega-debug-<version>-… é o mesmo programa com suas informações de depuração, que um depurador ou um profiler lê. Ele é executado e informa sua versão exatamente como o arquivo padrão, e é maior.
  • aggrega-light-<version>-… é compilado sem os plugins embutidos: ele resolve cada plugin pela cascata de plugins, como o workspace a configura, em vez de encontrar os principais dentro de si mesmo.

Para Windows, a release também traz aggrega-<version>-windows-amd64-setup.exe, o instalador do Windows, que instala o arquivo padrão para você.

Cada release também traz SHA256SUMS, o digest SHA-256 de todos os outros arquivos que anexa, incluindo os dois scripts de instalação, na forma que sha256sum lê. O comando de instalação faz essa verificação por conta própria. Para verificar um download à mão no Linux, com SHA256SUMS no mesmo diretório:

Terminal window
sha256sum --check --ignore-missing SHA256SUMS

O arquivo que você baixou é informado como OK; qualquer outro resultado significa que não é o arquivo que a release publicou.

O binário pré-compilado para Windows

O executável para Windows é aggrega-<version>-windows-amd64.exe (as variantes debug e light ao lado dele na release são instaladas da mesma forma). Renomeie-o para aggrega.exe, mova-o para %LOCALAPPDATA%\Programs\aggrega, a pasta que o comando de instalação usa, e adicione essa pasta ao PATH do seu usuário: o Windows executa um arquivo terminado em .exe sem que seja preciso marcá-lo como executável, e o encontra como o comando aggrega com esse nome. No PowerShell, por exemplo, com <version> substituído pela versão que você baixou:

Terminal window
$dir = "$env:LOCALAPPDATA\Programs\aggrega"
New-Item -ItemType Directory -Force $dir | Out-Null
Move-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"
Unblock-File "$dir\aggrega.exe"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

Um terminal aberto depois disso encontra aggrega; um que já estava aberto mantém o PATH com o qual foi iniciado.

Os executáveis são assinados. Cada um traz uma assinatura Authenticode, a assinatura de código que o Windows verifica, e o editor que o Windows mostra para ela é Cognitio S.r.l. Cada assinatura também traz um carimbo de data/hora: o certificado por trás de uma assinatura é válido por apenas alguns dias, e o carimbo de data/hora é o que mantém a assinatura válida depois que esse certificado expira. Para verificar um arquivo baixado antes de executá-lo:

  • No Explorador de Arquivos, abra as Properties do arquivo e a guia Digital Signatures. A lista de assinaturas mostra Cognitio S.r.l.; selecione-a e depois Details, que informa This digital signature is OK.

  • No PowerShell, com $dir como no exemplo acima:

    Terminal window
    $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"
    $signature.Status
    $signature.SignerCertificate.Subject

    Status informa Valid, e o requerente começa com CN=Cognitio S.r.l.. NotSigned ou HashMismatch significa que o arquivo não é o que a release publicou, ou que foi alterado depois de assinado.

Uma assinatura identifica o editor; ela não faz todos os avisos desaparecerem. Qual deles você encontra depende de como o arquivo chegou e de como você o inicia:

  • Durante o download, um navegador pode avisar que o arquivo não é baixado com frequência e perguntar se deve mantê-lo. Mantê-lo salva o arquivo como foi baixado.
  • Quando você o inicia pelo Explorador de Arquivos ou pelo navegador, o Windows pode mostrar Windows protected your PC. Esse aviso vem do Microsoft Defender SmartScreen, que pondera a reputação que um arquivo e seu editor construíram, de modo que uma versão recém-lançada ainda pode encontrá-lo, mesmo assinada, até que sua própria reputação se construa. Para um arquivo assinado, o aviso identifica o editor: selecione More info, verifique se ele mostra Cognitio S.r.l. e o nome do arquivo que você baixou e depois selecione Run anyway. Se for iniciado pelo PowerShell ou por um prompt de comando, o mesmo arquivo pode ser executado sem esse aviso; isso depende da versão do Windows e de suas configurações.
  • Unblock-File responde a esse aviso antecipadamente. Um arquivo baixado é marcado como vindo da internet, e é a essa marca que a verificação Windows protected your PC responde. Unblock-File no PowerShell, como no exemplo acima, remove a marca; o mesmo faz a caixa de seleção Unblock na guia General das Properties do arquivo no Explorador de Arquivos.
  • Onde o Smart App Control está ativado (Windows 11), ele verifica um programa quando você o inicia. Conforme a descrição da Microsoft, o Smart App Control primeiro pergunta ao serviço de segurança em nuvem da Microsoft se o programa é seguro; quando esse serviço não consegue fazer uma previsão confiável, ele verifica a assinatura, permitindo a execução de um programa com assinatura válida e bloqueando um que não está assinado ou cuja assinatura é inválida. Se ele está ativado é mostrado em App & browser control na Segurança do Windows.

O binário pré-compilado para macOS

Os executáveis para macOS são aggrega-<version>-darwin-arm64, para um Mac com Apple silicon, e aggrega-<version>-darwin-amd64, para um Mac com processador Intel; About This Mac no menu Apple mostra qual você tem. As variantes debug e light ao lado deles na release são instaladas da mesma forma. Um Mac com Apple silicon também executa o arquivo Intel, por meio do Rosetta 2 onde ele estiver instalado, mas o arquivo Apple silicon é o compilado para ele.

Renomeie o arquivo para aggrega, marque-o como executável e mova-o para ~/.local/bin, a pasta que o comando de instalação usa. No Terminal, por exemplo, no diretório em que está o download, com <version> substituído pela versão que você baixou e arm64 por amd64 em um Mac Intel:

Terminal window
chmod +x aggrega-<version>-darwin-arm64
mkdir -p ~/.local/bin
mv aggrega-<version>-darwin-arm64 ~/.local/bin/aggrega

O mkdir cria a pasta onde ela ainda não existe. ~/.local/bin não está no PATH que o macOS atribui a um novo terminal, então adicione a linha de Instalar à mão a ~/.zshrc, ou a ~/.bash_profile para bash, a menos que ela já esteja lá.

Os executáveis são assinados e notarizados. Cada um traz uma assinatura de código feita com o Developer ID da Cognitio s.r.l. — o certificado que a Apple emite a um desenvolvedor para software distribuído fora da Mac App Store — com o runtime reforçado e um carimbo de data/hora seguro, e o serviço de notarização da Apple verificou e notarizou cada um. O Gatekeeper, a verificação do macOS sobre software vindo da internet, avalia um programa que tem a marca de quarentena, a marca que um navegador web adiciona a um arquivo que baixa, e aceita um que a Apple notarizou, de modo que um arquivo baixado da página da release é executado como está. Um tíquete de notarização não pode ser anexado a um único arquivo executável, então o Gatekeeper encontra o tíquete online na primeira vez que o arquivo é executado; em um Mac que esteja offline nesse momento, o Gatekeeper pode bloquear o arquivo até que o Mac consiga acessar a Apple.

Para verificar um arquivo baixado antes de executá-lo, no Terminal, com o nome do arquivo que você baixou:

Terminal window
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64
codesign --display --verbose=2 aggrega-<version>-darwin-arm64

O primeiro informa que o arquivo é valid on disk e satisfies its Designated Requirement. O segundo lista as autoridades da assinatura, a primeira delas Developer ID Application: COGNITIO SRL seguida do identificador da equipe entre parênteses, e um Timestamp. Um arquivo que falha em qualquer um dos dois não é o que a release publicou, ou foi alterado depois de assinado.

Um arquivo obtido com curl não tem marca de quarentena, então o Gatekeeper não o avalia de forma alguma: curl não adiciona a marca que um navegador adiciona. É também por isso que o binário que o comando de instalação coloca no lugar é executado sem essa avaliação.