Repository navigation
v0.9.0
Changes
Aggrega 0.9.0, the first public release. It brings the aggrega.ai/v1beta1 schema.
Documents, schemas, plugins and published artifacts now use aggrega.ai/v1beta1, which changes only additively, and from this release on Aggrega promises compatibility for schemas, commands, flags, assistant tools, error codes and plugin kits, as the Compatibility page states.
Highlights
- The
aggrega.ai/v1beta1schema, stable from here on: a document or plugin still onv1alpha1is refused. aggrega importturns a Langflow, Flowise, n8n, Dify, CrewAI, LangGraph, Agent Framework, Google ADK, MCP or Docker Compose project into a workspace you can build and deploy, in one command.- One command runs a quickstart:
curl -fsSL https://aggrega.ai/quickstart-ai.sh | sh, orirm https://aggrega.ai/quickstart-ai.ps1 | iexon Windows. - Every quickstart, import and example page offers a prompt for your AI assistant and shows the project open in Visual Studio Code.
- The Visual Studio Code extension
aggrega-ai.aggregaspeaks the documentation's languages and asks for the values an import still owes.
Added
aggrega importdrafts a Release and a complete Manifest, asks once for what no source holds (--answers, by defaultimport-answers.yaml), and pulls the drafted Release's dependencies;--offlineskips the pull.- On Docker Compose, imported platforms and agents publish their port on 127.0.0.1 through
published_port, and every walkthrough shows how to test it. - Dify, MCP servers run from an image, and the HTTP-request and retrieval tools deploy on Docker Compose; Dify sends nothing to its vendor unless a Release sets
telemetry_enabledormarketplace_enabled. - The AI quickstart opens a chat page from its first step, and quickstart-web serves a page in the browser.
- The
aggrega-skillsplugin installs in Claude Code, Codex, Cursor, Copilot, Gemini CLI, Antigravity, Kiro and OpenClaw. - A Windows installer installs Aggrega without administrator rights.
- The language server and the assistant's import tool return owed values as
owedand accept answers asanswered. - The documentation has a Visual Studio Code section with screenshots, a Compatibility page and a public roadmap.
Changed
- The plugin kits and ABI codecs follow semantic versioning; Go plugins import
github.com/aggrega-ai/aggrega-pdk/goandgithub.com/aggrega-ai/aggrega-abi/go. - An import references the catalog component a source matches strongly, translates what the source states, and names its drafts after the source.
- Catalog components running your own image deliver their values under default variable names, which an
inject:block can rename. - Builds and first pulls are faster: dependencies are fetched in parallel and signatures are checked once per run.
- Commands show progress while they wait, slow down when a registry is busy, and print only what concerns them.
- A relative
workspace_rooton an assistant tool call is read from the Workspace folder, andscaffoldreturns the folder it wrote.
Fixed
- Imported Langflow flows open in Langflow's editor with all their connections; Dify on Kubernetes starts and answers; LangGraph on Docker Compose waits for its store.
- Kubernetes accepts names holding
/; lockfiles keep same-named entities of different kinds apart;aggrega pullfetches the base a wrapper extends. - Refusals name what is missing and how to fix it, for unmapped Features, inject mistakes and credential Features a Recipe cannot deliver.
helm/k8s-existing-secretrefuses an empty Secret name, and the installers and the build output print correctly on Windows and on terminals.
Install
These commands install this release, 0.9.0.
Linux and macOS:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/download/v0.9.0/install.sh | AGGREGA_VERSION=0.9.0 shWindows (PowerShell):
$env:AGGREGA_VERSION = '0.9.0'; irm https://github.com/aggrega-ai/aggrega-cli/releases/download/v0.9.0/install.ps1 | iexBoth install the default aggrega for the current user and check it against SHA256SUMS.
Windows installer: run aggrega-0.9.0-windows-amd64-setup.exe. No administrator rights; installs into %LOCALAPPDATA%\Programs\aggrega and adds it to your PATH. /S installs silently; uninstall.exe /S in that folder removes it.
Homebrew and Scoop install the newest release: brew install aggrega-ai/tap/aggrega, or scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket then scoop install aggrega.
Files
Binaries for linux/amd64, linux/arm64, darwin/arm64, darwin/amd64 and windows/amd64 (.exe):
| File | What it is |
|---|---|
aggrega-0.9.0-<os>-<arch> |
The default build, with the core plugins embedded |
aggrega-debug-0.9.0-<os>-<arch> |
The same build with debug information, for a debugger or a profiler |
aggrega-light-0.9.0-<os>-<arch> |
No embedded plugins; resolves plugins through the cascade |
aggrega-0.9.0-windows-amd64-setup.exe |
Windows installer |
aggrega-0.9.0.mcpb |
Claude Desktop extension: runs an installed aggrega as a local MCP server; one file for every OS |
install.sh, install.ps1 |
Install scripts |
quickstart-ai.sh, quickstart-ai.ps1, quickstart-web.sh, quickstart-web.ps1 |
Quickstart scripts: each runs one step of an example from the documentation |
SHA256SUMS |
SHA-256 of every other file; check with sha256sum -c SHA256SUMS |
Signing: Windows files carry a timestamped Authenticode signature from Cognitio S.r.l.; macOS files are signed with the Developer ID of COGNITIO SRL and notarized by Apple.