> ## Documentation Index > Fetch the complete documentation index at: https://ade-app.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Install ADE > Install ADE with one command on macOS, Linux, or Windows, or download the desktop app. Add the iOS companion from TestFlight, then sign in on the machine or from your phone. 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 ```bash macOS & Linux theme={null} curl -fsSL https://ade-app.dev/install.sh | sh ``` ```powershell Windows theme={null} irm https://ade-app.dev/install.ps1 | iex ``` 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`](https://ade-app.dev/docs/getting-started/connect-machine), and — on macOS and Windows — offers to install the desktop app too. | Platform | Background service | | - | - | | macOS | launchd login service | | Linux | systemd user service | | Windows | Per-user startup entry | None of them need an administrator or elevated shell. > [!WARNING] > > 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). > [!NOTE] > > 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 > [accordion] macOS — download > > Download for [**Apple Silicon**](https://ade-app.dev/download/mac-arm64) (M1 and later) or [**Intel**](https://ade-app.dev/download/mac-x64), 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. > [accordion] macOS — Homebrew > > ```bash theme={null} > brew install --cask arul28/ade/ade > ``` > > This taps the ADE cask and installs the latest macOS build into `/Applications`. Update later with: > > ```bash theme={null} > brew upgrade --cask ade > ``` > [accordion] Windows > > Download the [**signed Windows installer**](https://ade-app.dev/download/windows) 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](https://ade-app.dev/docs/getting-started/windows.md) for the capabilities that differ from macOS. > [accordion] Linux — the brain only > > 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](https://ade-app.dev/docs/getting-started/connect-machine.md) for the full server workflow. > [accordion] Install the iOS companion > > Open [TestFlight](https://testflight.apple.com/join/ZSdJGKPy) 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](https://testflight.apple.com/join/SsxDjqbF). 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](https://ade-app.dev/docs/getting-started/ade-beta.md). > [!TIP] > > Want the brain binary directly, without piping a script? Download it for [`darwin-arm64`](https://ade-app.dev/download/brain/darwin-arm64), [`darwin-x64`](https://ade-app.dev/download/brain/darwin-x64), [`linux-arm64`](https://ade-app.dev/download/brain/linux-arm64), [`linux-x64`](https://ade-app.dev/download/brain/linux-x64), or [`win32-x64`](https://ade-app.dev/download/brain/win32-x64). ## Requirements > [card] 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](https://ade-app.dev/docs/getting-started/windows.md). Linux runs the brain headless on x64 and arm64. > [card] Git > > Required — ADE uses branches and worktrees to run lanes. > [card] One AI provider > > Needed to run agents. Connect it after launch — guest mode lets you explore first. > [!NOTE] > > 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. > [!NOTE] > > 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. > [!NOTE] > > 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](https://ade-app.dev/docs/getting-started/ade-beta.md). > > 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. > [!NOTE] > > 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](https://ade-app.dev/docs/getting-started/windows.md) lists every difference. The iOS companion is available through TestFlight. ## Next > [card] [Connect a machine](https://ade-app.dev/docs/getting-started/connect-machine.md) > > Put this machine on your account — or run the brain on a Linux server. > [card] [Connect a provider](https://ade-app.dev/docs/getting-started/connect-provider.md) > > Add Claude Code, Codex, Cursor, Factory Droid, or OpenCode. > [card] [Open a project](https://ade-app.dev/docs/getting-started/open-project.md) > > Point ADE at the Git repository you want it to manage. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.