Skip to main content

​
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.