Skip to main content
ADE is a native desktop app, a headless engine, and an iOS companion. The desktop app is available on macOS and Windows 10/11 x64, and the brain runs headless on Linux. The fastest path on every platform is one command.

​
Install from your terminal

This installs the brain — ADE’s always-on engine. The script downloads a self-contained runtime binary, verifies it against the published SHA256SUMS, and stages it under ~/.ade, rolling back if anything fails. There is no Node, npm, or other prerequisite. It then registers the brain as a per-user background service, offers to sign you in with ade connect, and — on macOS and Windows — offers to install the desktop app too. None of them need an administrator or elevated shell.
On macOS and Linux the installer does not edit your shell profile. It installs ade to ~/.ade/bin and prints the line to add — put that directory on your PATH to run ade from a new shell. The Windows installer adds its directory to your user PATH for you (pass -NoPath to skip that).
When no terminal is attached — CI, or a provisioning script — the installer skips its prompts and prints the follow-up commands instead. ADE_INSTALL_NO_PROMPT=1 (or -NoPrompt for install.ps1) opts out explicitly. You can always run ade connect later.

​
Or download the app

Download for Apple Silicon (M1 and later) or Intel, then drag ADE.app into /Applications and launch it. If macOS asks for confirmation, choose Open.The app is signed and notarized, and keeps itself current from then on.
This taps the ADE cask and installs the latest macOS build into /Applications. Update later with:
Download the signed Windows installer for Windows 10/11 x64.It is a per-user NSIS installer: no administrator rights, and it installs the app, the ade CLI and the background ADE brain into your user profile. Read ADE on Windows for the capabilities that differ from macOS.
There is no ADE desktop app for Linux, and none is needed. Install the brain with the one-liner above on any x64 or arm64 box, connect it to your account, and drive it from ADE on your Mac, Windows PC, phone, or the web.See Connect a machine for the full server workflow.
Open TestFlight on your iPhone and install ADE Mobile. Sign in with the same account to see your machines automatically, or pair directly from the desktop Mobile control.Beta iPhone builds go to a separate app, ADE Beta, with an orange icon. Join it from the public TestFlight beta. It installs beside the normal app and keeps its own data and pairings, so a bad beta never replaces the app you rely on. Either app connects to machines on either track. See ADE Beta.
Want the brain binary directly, without piping a script? Download it for darwin-arm64, darwin-x64, linux-arm64, linux-x64, or win32-x64.

​
Requirements

macOS 13+, Windows 10/11, or Linux

macOS on Apple Silicon or Intel, shipped as a signed, notarized app. Windows supports x64 only — see ADE on Windows. Linux runs the brain headless on x64 and arm64.

Git

Required — ADE uses branches and worktrees to run lanes.

One AI provider

Needed to run agents. Connect it after launch — guest mode lets you explore first.
Behind a company proxy, set HTTPS_PROXY (and NO_PROXY for hosts that skip it) before you start ADE; the app and the brain both use it, and local addresses always go direct. ADE also trusts the root certificates your operating system trusts, so a company CA or a TLS-inspecting proxy works without extra setup.

​
Launch and explore

Open ADE and you land on the welcome screen, then the sign-in card. ADE needs a free account: it is what connects your machines, your phone, and the web client to each other.
  • Select Sign in or create account to sign in in the browser of this machine.
  • Select Sign in with your phone or another device to get a QR code and a short code. Scan the QR code with your phone, or enter the code on a different computer. Your password is never typed on this machine, which is what you want on a VM or a shared computer.
After you sign in, add a repository and look around. Without an AI provider ADE starts in guest mode, so connect a provider when you are ready to run agents.
The Brain and the ade CLI work on the machine itself with no account. Run ade connect --no-login to install the background service only.
ADE keeps itself current with a built-in auto-updater: it downloads new releases in the background and applies them on relaunch. Installed via Homebrew? Run brew upgrade --cask ade instead.Want new builds every few hours? Switch this machine to the Beta track with Update track in Settings › General. Beta builds come from main, show an orange icon, and use the same install, data and ade CLI; stable releases promote a beta that has already run. See ADE Beta.Each machine has its own track and is offered the newest build on that track. Settings › General lists an update row for every machine, and one restart dialog shows each machine with its current and target build and whether its chats continue. If an update leaves ADE unable to start, an ADE could not start window offers Try again, Go back to the previous version, the logs folder, and details to copy.
On Windows 10/11 x64 the app, brain, and CLI all run, but native OS computer use and the iOS Simulator drawer are macOS-only. ADE on Windows lists every difference. The iOS companion is available through TestFlight.

​
Next

Connect a machine

Put this machine on your account — or run the brain on a Linux server.

Connect a provider

Add Claude Code, Codex, Cursor, Factory Droid, or OpenCode.

Open a project

Point ADE at the Git repository you want it to manage.