> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-mobile-chat-stability-54bd7ef0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Install ADE

> Download the macOS app, move it to Applications, and launch it.

## Requirements

<CardGroup cols={3}>
  <Card title="macOS" icon="apple">
    ADE ships as a macOS desktop app for Apple Silicon and Intel Macs.
  </Card>

  <Card title="Git" icon="git-alt">
    Required. ADE uses branches and worktrees for lanes.
  </Card>

  <Card title="One AI provider" icon="key">
    Needed for agent work. You can connect it after launch.
  </Card>
</CardGroup>

## Install

<Steps>
  <Step title="Download the DMG">
    Open [GitHub Releases](https://github.com/arul28/ADE/releases) and download the latest ADE macOS release.
  </Step>

  <Step title="Move ADE into Applications">
    Open the DMG and drag **ADE.app** into `/Applications`.
  </Step>

  <Step title="Launch ADE">
    Open ADE from `/Applications` or Spotlight. If macOS asks for confirmation, choose **Open**.
  </Step>
</Steps>

<Note>
  ADE stores project state inside each repository's `.ade/` directory and app preferences under your user Library. It does not require admin privileges.
</Note>

## First launch

After the app opens, continue with:

<CardGroup cols={2}>
  <Card title="Connect a provider" icon="key" href="/getting-started/connect-provider">
    Verify Claude, Codex, Cursor, OpenCode, or another supported provider.
  </Card>

  <Card title="Open a project" icon="folder-open" href="/getting-started/open-project">
    Choose the Git repository you want ADE to manage.
  </Card>
</CardGroup>