> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Install ADE

> Download the macOS beta, move ADE into Applications, and launch it for the first time.

## Requirements

<CardGroup cols={3}>
  <Card title="macOS" icon="apple" color="#7C3AED">
    ADE ships a macOS beta installer for Apple Silicon and Intel Macs. macOS 13+ recommended.
  </Card>

  <Card title="Git 2.20+" icon="git-alt" color="#F97316">
    ADE manages worktrees and branches under the hood. Git must be installed and in your PATH.
  </Card>

  <Card title="Node.js" icon="node-js" color="#059669">
    Recommended for projects that depend on local tooling and ADE's bundled ADE CLI workflows.
  </Card>
</CardGroup>

***

## Install the beta

<Steps>
  <Step title="Download the DMG" icon="download">
    Go to [GitHub Releases](https://github.com/arul28/ADE/releases) and download the latest macOS installer for your chip (Apple Silicon or Intel).
  </Step>

  <Step title="Drag ADE into Applications" icon="folder-open">
    Open the DMG and drag **ADE.app** into `/Applications`. This is the standard macOS install flow.
  </Step>

  <Step title="Launch ADE" icon="rocket">
    Open ADE from `/Applications` or Spotlight (`Cmd+Space`, type "ADE"). If macOS warns that the app was downloaded from the internet, click **Open** to confirm.
  </Step>
</Steps>

<Check>
  **You're installed.** ADE opens to a welcome screen where you can open your first project. Continue to the next step to connect an AI provider.
</Check>

***

## Optional permissions

Computer Use workflows may ask for **Accessibility** or **Automation** permissions. You can grant those later in macOS **System Settings → Privacy & Security** if you're not using browser or desktop automation yet.

<Note>
  ADE does not require admin privileges to install or run. It stores all project data in a `.ade/` directory inside your repository, and app preferences in `~/Library/Application Support/ADE/`.
</Note>