Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Instalar Aggrega

Aggrega necesita dos cosas: el binario aggrega instalado y, para escribir con un asistente de IA, el cliente de tu asistente conectado al servidor MCP que incluye el binario. Primero vienen los comandos; después, lo que hace cada uno y las demás formas de instalar.

Instalar el binario

En Linux y macOS, en un terminal:

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

En Windows, en PowerShell:

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

Con Homebrew, en macOS y Linux:

Terminal window
brew install aggrega-ai/tap/aggrega

Con Scoop, en Windows:

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

Con winget, en Windows:

Terminal window
winget install Cognitio.Aggrega

Luego comprueba que se ejecuta:

Terminal window
aggrega version

Una cadena de versión significa que el binario se encuentra y es ejecutable. Eso es todo lo que necesita el servidor MCP. Cada forma de instalar, en detalle explica qué hace cada comando, dónde coloca el binario y cómo instalar con el instalador de Windows o a mano.

Conectar un cliente MCP

El cliente de tu asistente de IA inicia el servidor MCP de Aggrega ejecutando aggrega mcp, y Conectar el servidor MCP da el comando o la entrada que lo añade, cliente por cliente. En un asistente que instala plugins, el plugin de Aggrega añade el servidor y la skill de Aggrega en un solo paso: consulta Instalar el plugin.

Cada forma de instalar, en detalle

Aggrega se distribuye como un único ejecutable. Un solo comando lo instala; los pasos manuales que siguen hacen lo mismo a mano. Ambos lo colocan en una carpeta tuya, siempre la misma, y ninguno necesita derechos de administrador: ~/.local/bin/aggrega en Linux y macOS, y %LOCALAPPDATA%\Programs\aggrega\aggrega.exe en Windows. En Windows, el instalador de Windows y winget lo instalan en esa misma carpeta, también sin derechos de administrador, y lo incluyen entre tus aplicaciones instaladas: consulta Instalar con el instalador de Windows e Instalar con winget. Homebrew, en macOS y Linux, y Scoop, en Windows, también lo instalan, cada uno en sus propias carpetas: consulta Instalar con un gestor de paquetes.

Instalar con un solo comando

El comando de instalación es curl -fsSL https://aggrega.ai/install.sh | sh en Linux y macOS y irm https://aggrega.ai/install.ps1 | iex en PowerShell en Windows, los dos primeros comandos de Instalar el binario. Esas dos direcciones redirigen a los scripts de instalación que adjunta la última release, por lo que los mismos comandos también funcionan con las direcciones propias de la 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

Qué hace el comando:

  • Elige el binario predeterminado para tu máquina de la última release: Linux y macOS en x86 de 64 bits o ARM de 64 bits, Windows en x86 de 64 bits. Rechaza cualquier otro sistema o procesador con un mensaje que dice cuál encontró o a qué recurrir en su lugar. En un Mac con Apple silicon elige el binario de Apple silicon, incluso desde un shell que se ejecuta mediante Rosetta 2.
  • Comprueba el binario con el SHA256SUMS de la release antes de instalar nada. Una descarga cuyo digest SHA-256 difiere del que da la lista se elimina, no se instala nada y el comando se detiene con un mensaje que nombra ambos digests.
  • Instala el binario solo para ti, como ~/.local/bin/aggrega en Linux y macOS y como %LOCALAPPDATA%\Programs\aggrega\aggrega.exe en Windows, creando la carpeta si falta y sustituyendo en un solo paso una copia anterior que haya allí, de modo que volver a ejecutar el comando actualiza la que tienes. Nunca usa sudo. En Windows también elimina la marca que puede llevar un archivo descargado de internet, como hace Unblock-File en los pasos manuales. En macOS descarga con curl, así que el binario que instala no lleva ninguna marca de cuarentena (consulta El binario precompilado para macOS).
  • Hace que el comando sea accesible. En Linux y macOS, cuando la carpeta no está en tu PATH, imprime un comando que añade la carpeta al archivo que tu shell lee al iniciarse: ~/.zshrc para zsh, ~/.bashrc para bash (~/.bash_profile en macOS), ~/.config/fish/config.fish para fish, con una línea fish_add_path, y ~/.profile para cualquier otro shell. No ejecuta ese comando por sí mismo: ejecútalo y abre un terminal nuevo. En Windows añade la carpeta al PATH de tu usuario cuando no está, y al PATH de la ventana de PowerShell en la que se ejecuta, de modo que aggrega funciona en esa ventana y en cada terminal que se abra después, e indica que ha añadido la carpeta.
  • Comprueba que el binario instalado se ejecuta, y se detiene con un mensaje antes de configurar nada más cuando no lo hace. Añade una nota cuando otro aggrega va antes en tu PATH que el que instaló.
  • Imprime la versión instalada, ejecutando el binario que instaló por su ruta completa, de modo que la versión se muestra antes de que tu PATH alcance la carpeta.
  • Termina con los pasos siguientes, bajo Next:, una línea por cada uno: el comando que ejecuta el quickstart de IA, como describe Primeros pasos; aggrega skills install --global, que añade la skill de Aggrega a los asistentes de IA de tu máquina, como describe Añadir la skill del asistente al instalar; y la dirección de esta página, para el autocompletado del shell y Conectar un cliente MCP, más arriba. Cuando una opción ya ha instalado la skill, su línea se omite.

Lo que imprime es breve: la versión y el sistema para el que instala, una línea cuando la descarga coincide con su suma de comprobación, y la ruta en la que instaló. Primeros pasos muestra una ejecución completa. --verbose, pasado después de sh -s -- como las opciones de abajo, imprime también la dirección de la lista de sumas de comprobación, el nombre del archivo del lanzamiento y la dirección desde la que lo descarga; install.ps1 tiene el mismo modificador como -Verbose, para una ejecución del script con argumentos, que irm … | iex no puede darle. Cuando el comando se niega o un paso falla, lo dice en una línea, en la salida de error estándar desde install.sh y como el error o la advertencia que PowerShell muestra desde install.ps1:

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

install.sh, el script para Linux y macOS, necesita curl o wget, uname, y sha256sum o shasum. install.ps1, el de Windows, se ejecuta en Windows PowerShell 5.1 y en PowerShell 7.

Dos ajustes cambian lo que instala, cada uno leído del entorno en el que se ejecuta el script:

  • AGGREGA_VERSION nombra la release que se instala, como 0.8.7, escrita con o sin su v inicial. Si no está definido, el comando instala la última release — la que GitHub marca como más reciente, que nunca es una versión preliminar, así que una versión preliminar solo se instala nombrándola aquí.
  • AGGREGA_INSTALL_DIR nombra la carpeta en la que instalar en lugar de la predeterminada. El binario allí es aggrega, aggrega.exe en Windows, y el comando hace accesible esa carpeta como se indica arriba.

En Linux y macOS, pon el ajuste antes de sh, no antes de curl, para que el script lo reciba:

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

En PowerShell, defínelo primero en la ventana; permanece definido allí hasta que lo elimines con Remove-Item Env:AGGREGA_VERSION:

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

Configurar el autocompletado del shell al instalar

Con --completion, install.sh también configura el autocompletado del shell, de modo que la tecla Tab completa los comandos y las opciones de aggrega. Las opciones van después de sh -s --, que se las pasa al script que sh lee de la tubería:

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

irm … | iex no pasa ninguna opción a un script. En PowerShell, configura el autocompletado una vez terminada la instalación, con el script que escribe aggrega completion powershell, como describe Autocompletado del shell. install.ps1 también acepta -Completion, para una ejecución del script con argumentos.

Configura el autocompletado solo para ti, sin derechos de administrador, para el shell que nombra tu variable SHELL, o en PowerShell para el PowerShell en el que se ejecuta. Usa el script que escribe el propio aggrega completion del binario instalado, y nombra cada archivo que escribe o modifica:

  • bash: escribe el script en ~/.local/share/bash-completion/completions, la carpeta desde la que el paquete bash-completion lee tus propios autocompletados. El autocompletado de bash para aggrega necesita ese paquete.
  • zsh: escribe _aggrega en ~/.local/share/zsh/site-functions y añade a ~/.zshrc tres líneas que ponen esa carpeta en la ruta de funciones de zsh y lo cargan, ejecutando compinit donde nada en el archivo lo ejecutó antes.
  • fish: escribe aggrega.fish en ~/.config/fish/completions, que fish lee por sí solo.
  • PowerShell: escribe el script como %LOCALAPPDATA%\aggrega\completion.ps1 y añade dos líneas que lo cargan a tu perfil para todos los hosts del PowerShell en el que se ejecuta, $PROFILE.CurrentUserAllHosts. Windows PowerShell y PowerShell 7 mantienen perfiles separados, así que ejecútalo desde cada uno que uses. Un perfil solo se ejecuta donde la directiva de ejecución que toma una ventana nueva es RemoteSigned, Unrestricted o Bypass; con cualquier otra, como Restricted, no escribe nada e indica qué directiva encontró. Nunca cambia la directiva.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR y ZDOTDIR mueven esas carpetas y archivos tal como los lee cada shell. Un terminal o una ventana nuevos cargan el autocompletado. Volver a ejecutar el comando reescribe un script solo cuando el aggrega instalado escribe uno distinto, y añade las líneas a ~/.zshrc o al perfil una sola vez; esa es también la forma de añadir el autocompletado a una instalación que ya tienes, ya que el comando vuelve a instalar el binario por el camino.

Añadir la skill del asistente al instalar

Con --skills (-Skills en PowerShell), el comando de instalación también instala la skill de Aggrega — las instrucciones que enseñan a un asistente de IA a instalar y usar Aggrega — en cada uno de tus proyectos, para los asistentes de IA de tu máquina. Ambas opciones pueden darse juntas:

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

En PowerShell, donde irm … | iex no pasa ninguna opción, ejecuta aggrega skills install --global una vez terminada la instalación: es el comando que ejecuta -Skills.

Ejecuta el propio aggrega skills install --global del binario instalado, que busca los asistentes en tu máquina — cada uno cuya carpeta de configuración está en tu directorio personal, o cuyo comando está en tu PATH — e imprime cada uno que encontró y qué lo encontró. Después:

  • En un terminal, pregunta primero. Pulsa Intro para instalar la skill para los asistentes que encontró, o escribe los identificadores de otros para añadirlos, separados por espacios o comas; aggrega skills list imprime los identificadores. Con curl … | sh el script se lee a sí mismo de la tubería, así que pregunta a través de tu terminal.
  • Sin un terminal por el que preguntar, como en un script, instala para los asistentes que encontró.
  • Para elegir tú los asistentes, indícalos después de la opción, separados por comas: --skills claude-code,cursor, o --skills=claude-code,cursor, y en PowerShell -Skills claude-code,cursor. Entonces instala para esos y no busca otros.

Imprime cada carpeta de skill que escribe, como ~/.claude/skills/aggrega para Claude Code, todas dentro de tu directorio personal. Volver a ejecutar el comando sustituye las copias que escribió una ejecución anterior, y así es como la skill sigue al binario a una versión más reciente. aggrega skills describe el comando, la carpeta que lee cada asistente y qué encuentra a cada uno.

Cuando un paso no se puede realizar

Cuando no se puede configurar el autocompletado — un shell que no configura, como dash, una carpeta en la que no puede escribir, o una directiva de ejecución de PowerShell que no ejecuta ningún perfil — o no se puede instalar la skill — ningún asistente encontrado y ninguno nombrado, un identificador que no conoce, o un archivo en una carpeta de skill que no escribió ninguna instalación —, el binario queda instalado igualmente y se ejecuta. El comando indica por qué falló el paso, imprime los pasos siguientes y termina con un estado que indica qué paso falló. Los estados son:

EstadoSignificado
0aggrega está instalado, y todos los pasos que pidió una opción se completaron correctamente
1no se instaló nada, o el aggrega instalado no se ejecutó
2se le dio al comando una opción que no acepta, o una lista que no nombra ningún asistente; no hizo nada
3aggrega está instalado y se ejecuta, pero falló la configuración del autocompletado del shell
4aggrega está instalado y se ejecuta, pero falló la instalación de la skill
5aggrega está instalado y se ejecuta, pero fallaron ambas cosas

El script de PowerShell nunca cierra la ventana en la que se ejecuta, así que deja el estado en $LASTEXITCODE, y todo estado distinto de 0 termina en un error, que powershell -Command y pwsh -Command notifican como código de salida 1.

Instalar con el instalador de Windows

Cada release incluye un instalador de Windows, aggrega-<version>-windows-amd64-setup.exe, en la página de la release en https://github.com/aggrega-ai/aggrega-cli/releases. Descárgalo y ejecútalo. Instala el aggrega.exe predeterminado solo para ti, sin derechos de administrador y sin pedirlos, mediante un breve asistente:

  • Una página de bienvenida, luego la licencia, la Apache License 2.0 de Aggrega: no se instala nada hasta que pulses I Agree. Luego los componentes: Aggrega en sí, siempre instalado, y Add to PATH, seleccionado.
  • La carpeta de instalación, %LOCALAPPDATA%\Programs\aggrega salvo que elijas otra; es la carpeta que usa el comando de instalación.
  • El progreso, luego una página final que nombra la carpeta e indica si esta instalación la añadió a tu PATH, con los pasos siguientes: instalar la skill de Aggrega con aggrega skills install --global y conectar tu cliente de IA como describe Conectar un cliente MCP.

Qué hace:

  • Con Add to PATH seleccionado, añade la carpeta de instalación al PATH de tu usuario salvo que ya esté allí. Un terminal abierto después de la instalación encuentra aggrega; uno ya abierto conserva el PATH con el que se inició. Con la opción desmarcada, no se añade nada a tu PATH y un terminal ejecuta aggrega.exe por su ruta completa; una entrada que añadió una instalación anterior se deja como está.
  • Incluye Aggrega entre tus aplicaciones instaladas, con Cognitio s.r.l. como editor, de modo que se desinstala desde Settings → Apps como cualquier otra aplicación. El desinstalador te pide confirmación y luego elimina los archivos que el instalador puso en la carpeta, la entrada del PATH y la entrada de esa lista, y elimina la carpeta cuando no queda nada más en ella.
  • Si se vuelve a ejecutar, instala sobre lo que hay, ofreciendo la carpeta en la que instaló la última vez, de modo que el instalador de una release posterior actualiza la copia que tienes, conservando una sola entrada en tu PATH.
  • Junto a aggrega.exe, la carpeta contiene uninstall.exe, LICENSE con el texto de la licencia y EnVar.dll, el componente con el que el instalador y el desinstalador editan tu PATH.

Cuando aggrega.exe se está ejecutando — iniciado por un editor o un cliente de IA — el instalador no puede sustituirlo y se detiene con un mensaje que lo indica; cierra lo que lo inició y vuelve a ejecutar el instalador. El desinstalador se detiene del mismo modo, antes de haber eliminado nada.

Para instalar sin ventanas, desde un script o una herramienta que instala software en muchas máquinas, ejecuta el instalador con /S, escrito en mayúscula; entonces instala sin ventana ni preguntas, en la carpeta que usó una instalación anterior o, si no, en la predeterminada, con Add to PATH, e informa de un fallo mediante su código de salida, que no es 0. El desinstalador admite la misma opción:

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

El instalador está firmado igual que los ejecutables, con el editor Cognitio S.r.l. y una marca de tiempo: las comprobaciones de El binario precompilado para Windows se le aplican como a aggrega.exe, y también lo que allí se dice sobre los avisos que Windows puede mostrar para un archivo descargado. SHA256SUMS incluye su digest como el de cualquier otro archivo de la release.

Donde el instalador no convenga, el comando de instalación de arriba y los pasos manuales instalan el mismo aggrega.exe en la misma carpeta.

Instalar con un gestor de paquetes

Cada release también actualiza una fórmula de Homebrew y un manifiesto de Scoop, de modo que el gestor de paquetes que ya usas puede instalar Aggrega y mantenerlo al día. Cada uno instala el mismo binario predeterminado que el comando de instalación, comprobado con el digest SHA-256 que le asigna el SHA256SUMS de la release.

En macOS y Linux, brew install aggrega-ai/tap/aggrega lo instala con Homebrew. Homebrew añade el tap aggrega-ai/tap la primera vez e instala el binario para tu sistema y procesador: macOS en Apple silicon o en Intel, Linux en x86 de 64 bits o en ARM de 64 bits. Tras una nueva release, brew upgrade lo actualiza, junto con todas las demás fórmulas que hayas instalado.

En Windows, con Scoop, añade una vez el bucket de Aggrega, con scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, e instala desde él con scoop install aggrega. Scoop instala el binario de Windows como aggrega.exe y lo hace accesible como aggrega mediante la carpeta de shims que mantiene en tu PATH. Tras una nueva release, scoop update actualiza los buckets y scoop update aggrega lo actualiza.

Homebrew y Scoop instalan cada uno en sus propias carpetas en lugar de en ~/.local/bin o %LOCALAPPDATA%\Programs\aggrega, y actualizan solo la copia que instalaron. Usa una sola forma de instalación en una máquina: una copia instalada con el comando de instalación o a mano y otra instalada con Homebrew o Scoop son dos copias, y la carpeta que va primero en tu PATH decide cuál se ejecuta.

Instalar con winget

En Windows, winget install Cognitio.Aggrega lo instala con winget, el Administrador de paquetes de Windows. winget descarga el instalador de Windows de la release desde su página de la release, lo comprueba con el digest SHA-256 que da el manifiesto del paquete y lo ejecuta de forma desatendida. El resultado es el del propio instalador: aggrega.exe en %LOCALAPPDATA%\Programs\aggrega, o en la carpeta que usó una instalación anterior, esa carpeta en el PATH de tu usuario y Aggrega en tu lista de aplicaciones instaladas, todo sin derechos de administrador. winget no cambia el PATH del terminal en el que se ejecuta, así que abre un terminal nuevo antes de ejecutar aggrega version.

winget upgrade Cognitio.Aggrega instala encima una release posterior, y winget uninstall Cognitio.Aggrega ejecuta su desinstalador. winget, el instalador y el comando de instalación instalan todos en la misma carpeta, salvo que elijas otra en el instalador, así que el que se ejecute en último lugar pone allí su aggrega.exe.

Instalarlo a mano

Cada release incluye binarios precompilados para Linux en x86 de 64 bits y en ARM de 64 bits, para Windows en x86 de 64 bits y para macOS en Apple silicon y en Intel, en la página de la release en https://github.com/aggrega-ai/aggrega-cli/releases. Descarga el ejecutable para tu sistema operativo y procesador — Elegir el archivo, más abajo, nombra cada uno — y compruébalo con el SHA256SUMS de la release, como se describe allí. Luego márcalo como ejecutable y muévelo a ~/.local/bin/aggrega. En Linux, desde el directorio en el que está la descarga, con <version> sustituido por la versión que descargaste, y amd64 por arm64 en ARM de 64 bits:

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

En Windows, consulta El binario precompilado para Windows más abajo; en macOS, consulta El binario precompilado para macOS.

Cuando ~/.local/bin no está en tu PATH, añade esta línea al archivo que tu shell lee al iniciarse — ~/.zshrc para zsh, ~/.bashrc para bash (~/.bash_profile en macOS) — y abre un terminal nuevo:

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

Desde el código fuente, con una cadena de herramientas de Go instalada, compila el comando aggrega desde el árbol de fuentes y coloca el binario resultante en la misma carpeta.

Confirma la instalación con aggrega version, como al final de Instalar el binario.

Elegir el archivo

Una release nombra cada ejecutable aggrega-<version>-<system>-<processor>, con .exe en Windows:

SistemaProcesadorArchivo
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

Ese archivo es el que instala el comando de instalación, y el que se descarga a mano. Junto a él hay dos variantes; el comando de instalación no instala ninguna de las dos, y cada una se instala a mano del mismo modo:

  • aggrega-debug-<version>-… es el mismo programa con su información de depuración, que lee un depurador o un perfilador. Se ejecuta e informa de su versión exactamente como el archivo predeterminado, y es más grande.
  • aggrega-light-<version>-… está compilado sin los plugins integrados: resuelve cada plugin a través de la cascada de plugins, tal como la configura el espacio de trabajo, en lugar de encontrar los principales dentro de sí mismo.

Para Windows, la release incluye también aggrega-<version>-windows-amd64-setup.exe, el instalador de Windows, que instala el archivo predeterminado por ti.

Cada release incluye también SHA256SUMS, el digest SHA-256 de cada uno de los demás archivos que adjunta, incluidos los dos scripts de instalación, en la forma que lee sha256sum. El comando de instalación hace esta comprobación por sí mismo. Para comprobar una descarga a mano en Linux, con SHA256SUMS en el mismo directorio:

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

El archivo que descargaste se indica como OK; cualquier otro resultado significa que no es el archivo que publicó la release.

El binario precompilado para Windows

El ejecutable de Windows es aggrega-<version>-windows-amd64.exe (las variantes debug y light que lo acompañan en la release se instalan del mismo modo). Cámbiale el nombre a aggrega.exe, muévelo a %LOCALAPPDATA%\Programs\aggrega, la carpeta que usa el comando de instalación, y añade esa carpeta al PATH de tu usuario: Windows ejecuta un archivo que termina en .exe sin necesidad de marcarlo como ejecutable, y lo encuentra como el comando aggrega con ese nombre. Desde PowerShell, por ejemplo, con <version> sustituido por la versión que descargaste:

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")

Un terminal abierto después de eso encuentra aggrega; uno que ya estaba abierto conserva el PATH con el que se inició.

Los ejecutables están firmados. Cada uno lleva una firma Authenticode, la firma de código que comprueba Windows, y el editor que Windows muestra para ella es Cognitio S.r.l. Cada firma lleva además una marca de tiempo: el certificado que respalda una firma solo es válido durante unos pocos días, y la marca de tiempo es lo que mantiene válida la firma después de que ese certificado caduque. Para comprobar un archivo descargado antes de ejecutarlo:

  • En el Explorador de archivos, abre las Properties del archivo y su pestaña Digital Signatures. La lista de firmas muestra Cognitio S.r.l.; selecciónala y después Details, que indica This digital signature is OK.

  • En PowerShell, con $dir como en el ejemplo anterior:

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

    Status indica Valid, y el sujeto comienza por CN=Cognitio S.r.l.. NotSigned o HashMismatch significa que el archivo no es el que publicó la release, o que se modificó después de firmarse.

Una firma identifica al editor; no hace desaparecer todas las advertencias. La que encuentres depende de cómo llegó el archivo y de cómo lo inicies:

  • Durante la descarga, un navegador puede advertir de que el archivo no se descarga con frecuencia y preguntar si quieres conservarlo. Conservarlo guarda el archivo tal como se descargó.
  • Cuando lo inicias desde el Explorador de archivos o desde el navegador, Windows puede mostrar Windows protected your PC. Ese aviso procede de Microsoft Defender SmartScreen, que sopesa la reputación que han acumulado un archivo y su editor, por lo que una versión recién publicada puede encontrarlo aun estando firmada, hasta que acumule su propia reputación. Para un archivo firmado, el aviso nombra al editor: selecciona More info, comprueba que nombra a Cognitio S.r.l. y el nombre del archivo que descargaste, y después selecciona Run anyway. Si en cambio se inicia desde PowerShell o un símbolo del sistema, el mismo archivo puede ejecutarse sin ese aviso; que así sea depende de la versión de Windows y de su configuración.
  • Unblock-File responde a ese aviso por adelantado. Un archivo descargado está marcado como procedente de internet, y es a esa marca a lo que responde la comprobación Windows protected your PC. Unblock-File en PowerShell, como en el ejemplo anterior, elimina la marca; también lo hace la casilla Unblock de la pestaña General de las Properties del archivo en el Explorador de archivos.
  • Donde Smart App Control está activado (Windows 11), comprueba un programa cuando lo inicias. Según lo describe Microsoft, Smart App Control pregunta primero al servicio de seguridad en la nube de Microsoft si el programa es seguro; cuando ese servicio no puede hacer una predicción fiable, comprueba la firma, permitiendo ejecutar un programa con una firma válida y bloqueando uno sin firmar o cuya firma no es válida. Si está activado se muestra en App & browser control de Seguridad de Windows.

El binario precompilado para macOS

Los ejecutables de macOS son aggrega-<version>-darwin-arm64, para un Mac con Apple silicon, y aggrega-<version>-darwin-amd64, para un Mac con procesador Intel; About This Mac en el menú Apple muestra cuál tienes. Las variantes debug y light que los acompañan en la release se instalan del mismo modo. Un Mac con Apple silicon también ejecuta el archivo de Intel, mediante Rosetta 2 donde está instalado, pero el archivo de Apple silicon es el compilado para él.

Cámbiale el nombre al archivo a aggrega, márcalo como ejecutable y muévelo a ~/.local/bin, la carpeta que usa el comando de instalación. Desde Terminal, por ejemplo, en el directorio donde está la descarga, con <version> sustituido por la versión que descargaste, y arm64 por amd64 en un Mac con Intel:

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

El mkdir crea la carpeta donde aún no existe. ~/.local/bin no está en el PATH que macOS asigna a un terminal nuevo, así que añade la línea de Instalarlo a mano a ~/.zshrc, o a ~/.bash_profile para bash, salvo que ya esté allí.

Los ejecutables están firmados y notarizados. Cada uno lleva una firma de código hecha con el Developer ID de Cognitio s.r.l. — el certificado que Apple emite a un desarrollador para el software distribuido fuera de la Mac App Store — con el entorno de ejecución reforzado y una marca de tiempo segura, y el servicio de notarización de Apple ha comprobado y notarizado cada uno. Gatekeeper, la comprobación de macOS sobre el software procedente de internet, evalúa un programa que lleva la marca de cuarentena, la marca que un navegador web añade a un archivo que descarga, y acepta uno que Apple ha notarizado, de modo que un archivo descargado de la página de la release se ejecuta tal cual. Un ticket de notarización no se puede adjuntar a un único archivo ejecutable, así que Gatekeeper encuentra el ticket en línea la primera vez que se ejecuta el archivo; en un Mac que en ese momento no tiene conexión, Gatekeeper puede bloquear el archivo hasta que el Mac pueda conectar con Apple.

Para comprobar un archivo descargado antes de ejecutarlo, desde Terminal, con el nombre del archivo que descargaste:

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

El primero indica que el archivo es valid on disk y satisfies its Designated Requirement. El segundo enumera las autoridades de la firma, la primera de ellas Developer ID Application: COGNITIO SRL seguida del identificador del equipo entre paréntesis, y un Timestamp. Un archivo que no supera cualquiera de los dos no es el que publicó la release, o se modificó después de firmarse.

Un archivo obtenido con curl no lleva marca de cuarentena, así que Gatekeeper no lo evalúa en absoluto: curl no añade la marca que añade un navegador. Por eso también el binario que coloca el comando de instalación se ejecuta sin esa evaluación.