Skip to main content
ADE is generally available on macOS and runs in beta on Windows. The Windows build is the same app, brain, and CLI — lanes, agent chat, PRs, terminals, the built-in browser, and phone pairing all work. A short list of macOS-native capabilities has no Windows counterpart, and this page names all of them.

​
Requirements

Windows 10 or 11, x64

ARM64 is not supported. There is no emulated fallback.

Git

Git for Windows on PATH — ADE uses branches and worktrees to run lanes.

One AI provider

Claude Code, Codex, Cursor, Factory Droid, or OpenCode. Cursor installs natively; WSL is not required.

​
Install

Download the signed Windows installer, or install from PowerShell:
The installer is a per-user NSIS installer. It does not ask for administrator rights, installs into your user profile, and adds the app, the ade CLI, ade code, and the background ADE brain. The brain runs from a per-user startup entry, so it comes back at your next sign-in without a service install or an elevated shell.
Pull-request preview builds are unsigned and are for internal testing, not general use. Install from the link above or the PowerShell one-liner to get the signed build.

​
What is different from macOS

Computer use is browser-only

Native OS screenshot, video, and GUI automation are unavailable. App Control over CDP, the built-in browser, and attaching proof files with ade proof attach all work.

No iOS Simulator or Xcode Preview

Both need macOS and Xcode. The Simulator drawer is hidden on Windows.

No ADE Notch

The Notch is a macOS window-server feature with no Windows counterpart.

Claude Code turns are slower

Each follow-up prompt respawns the CLI instead of replying into a live background job, so in-flight context is not carried over.

No Claude Code sandbox

Permission modes work; the sandbox does not. Claude Code sandboxing is WSL-2 only.

Credentials use DPAPI

There is no Keychain. Secrets are protected per Windows user account rather than per item.
Two more boundaries worth knowing before you plan around them:
  • Remote machines work both ways. A Windows machine can drive a remote macOS, Linux, or Windows runtime over SSH, provided you installed a released build. Windows can also be the target: ADE bootstraps its runtime onto Windows 10 22H2 and Windows 11 x64 boxes over OpenSSH Server, which needs PowerShell 5.1 or newer and the built-in tar.exe. WSL, ARM64, and Windows Server are not supported targets.
  • Some operations need real symlinks. ADE uses junctions where it can. The rest require Developer Mode or an elevated shell, which Windows requires for symlink creation.
Anything else that looks weaker or missing on Windows is a bug worth reporting, not a known gap.

​
Next

Connect a provider

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

Troubleshooting

Diagnostics for the brain, providers, and sync.