Skip to main content
This release rebuilds how ADE is installed, downloaded, and updated. One command now installs the ADE brain on macOS, Windows, or a Linux server and connects it to your account; the desktop download is a fraction of its former size; and the macOS auto-update crash that v1.2.52 could trigger is fixed structurally, with CI gates that keep it fixed.

​
Install ADE with one command

  • curl -fsSL https://ade-app.dev/install.sh | sh (macOS and Linux) or irm https://ade-app.dev/install.ps1 | iex (Windows) installs the ADE brain — the self-contained engine behind every ADE surface. No Node, npm, or any other prerequisite: the installer verifies checksums, stages with rollback, and registers the brain as a per-user background service (launchd, systemd, or a Windows startup entry — never an elevated shell).
  • The installer signs you in and connects the machine. After installing it offers ade connect: sign in (a copy-paste device flow when you’re over SSH), publish the machine to your account, and it’s reachable from ADE desktop, the web client, and iOS. On macOS and Windows it can install the desktop app too.
  • ade connect is idempotent. Run it any time to check or repair the account → service → machine chain; --status reports without changing anything, --no-login keeps a machine local/LAN-only.
  • Linux is now a first-class home for the brain. Run one command on any Linux box (x64 or arm64) and drive it from your Mac, Windows machine, phone, or browser. There is no Linux desktop app — the brain is the whole engine.
  • The website now has an install dialog behind every download button: the one-liner, direct downloads per architecture, and Homebrew, side by side.

​
Downloads are a fraction of the size

  • The macOS download is well under half its previous size, and the Windows installer shrank by more than a gigabyte. Two structural fixes: every build previously shipped every platform’s runtime (the Windows installer carried both macOS runtimes; macOS carried Windows), and the heavyweight agent CLIs were bundled twice per install.
  • Agent CLIs are now fetched, pinned, and shared. Codex, Claude Code, and OpenCode download on first run from the npm registry — exact versions pinned by a manifest with cryptographic integrity checks, stored once in a shared cache (~/.ade/tools) used by the desktop app and the brain alike. Updates stop re-downloading hundreds of megabytes of unchanged vendor binaries when nothing was repinned.
  • Updates can never hit the crash cliff again. v1.2.52’s macOS package crossed 1 GiB and crashed Squirrel.Mac during auto-update. The updater now refuses oversized artifacts outright, and the release pipeline hard-fails any macOS package over 800 MiB before it can publish.

​
Fixes

  • Cross-platform remote provisioning works again: setting up a Linux or Windows machine over SSH from a Mac (or vice versa) downloads the exact-version runtime from the release, checksum-verified, instead of failing.
  • The auto-updater reports a typed, actionable error state instead of dying when an artifact is oversized, and preserves verified downloads across retries.
  • ade tools status | ensure | gc manages the shared agent-tools cache; the brain fetches missing tools in the background and repairs itself without a restart.
  • Dozens of correctness fixes from this release’s review cycle, including Windows file-lock contention handling, per-tool fetch isolation, and a first-run state that says “downloading” instead of “not found” while agent runtimes are still arriving.

​
Under the hood

  • The packaged app dropped ~590 MiB of never-executed code: renderer libraries were shipping twice (bundled and raw), and dead packages are gone entirely.
  • Release CI now gates every build: target-purity checks in seconds before the build, size budgets after packaging, and archive-content assertions derived from one canonical package list.