Requirements
macOS
ADE ships as a macOS desktop app for Apple Silicon and Intel Macs.
Git
Required. ADE uses branches and worktrees for lanes.
One AI provider
Needed for agent work. You can connect it after launch.
Install
1
Download the DMG
Open GitHub Releases and download the latest ADE macOS release.
2
Move ADE into Applications
Open the DMG and drag ADE.app into
/Applications.3
Launch ADE
Open ADE from
/Applications or Spotlight. If macOS asks for confirmation, choose Open.ADE stores project state inside each repository’s
.ade/ directory and app preferences under your user Library. It does not require admin privileges.First launch
After the app opens, continue with:Connect a provider
Verify Claude, Codex, Cursor, OpenCode, or another supported provider.
Open a project
Choose the Git repository you want ADE to manage.