> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install ADE, open a project, create a lane, and run your first agent task.

This page is the shortest useful path. You can tune providers, permissions, Linear, mobile, and worker settings later.

<Frame>
  <img src="https://mintcdn.com/ade-ac1c6011-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/landing/hero/desktop.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=636ce66a4ba700018ad45e9b9303af34" alt="The ADE desktop app" width="2572" height="1398" data-path="media/landing/hero/desktop.webp" />
</Frame>

<Steps>
  <Step title="Install ADE">
    Download the latest macOS DMG from [GitHub Releases](https://github.com/arul28/ADE/releases), open it, and drag **ADE.app** into `/Applications`.
  </Step>

  <Step title="Connect one AI provider">
    Open **Settings -> AI Providers** and verify at least one provider. Claude Code, Codex, Cursor, Factory Droid, and OpenCode are the agent paths.
  </Step>

  <Step title="Open a Git repository">
    Use **Open Repository** on the welcome screen or press `Cmd+O`. Choose the repository root, not a subfolder.
  </Step>

  <Step title="Create a lane">
    In **Lanes**, create a new lane from your default branch. A lane is ADE's name for a git worktree — it gets its own branch and working copy under `.ade/worktrees/`, isolated from your main checkout.
  </Step>

  <Step title="Ask for one small change">
    Open the lane in **Work** or **Chat** and send a narrow task. Start with something easy to inspect.
  </Step>

  <Step title="Review and commit">
    Use **Files** to inspect the diff, run tests from **Run** or the terminal, then commit and create a PR when it looks right.
  </Step>
</Steps>

## A good first prompt

```text theme={null}
Add a GET /health endpoint that returns { "status": "ok" } and add one test for it.
```

Pick a version of that prompt that fits your project. The goal is to exercise the loop: lane, chat, edit, test, review, commit.

## What to read next

<CardGroup cols={2}>
  <Card title="Key concepts" icon="lightbulb" href="/key-concepts">
    Understand the product vocabulary without reading a reference manual.
  </Card>

  <Card title="Run your first agent" icon="robot" href="/getting-started/first-agent">
    More detail on choosing a provider, watching tool calls, and reviewing output.
  </Card>

  <Card title="Lanes" icon="code-branch" href="/lanes/overview">
    How ADE keeps parallel work isolated.
  </Card>

  <Card title="Pull requests" icon="code-pull-request" href="/tools/pull-requests">
    How finished lane work moves into GitHub review.
  </Card>
</CardGroup>