> ## Documentation Index
> Fetch the complete documentation index at: https://ade-app.dev/docs/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.

![The ADE desktop app](https://mintcdn.com/ade-ac1c6011/Mghbi7-G0yTaUGxT/media/current/work-tab.jpg?fit=max\&auto=format\&n=Mghbi7-G0yTaUGxT\&q=85\&s=bdf51618ba63f333ec114a149bf2bb40)

**1. Install ADE**

One command installs the ADE brain, registers it as a background service, and offers to sign you in and add the desktop app.

```bash macOS & Linux theme={null}
curl -fsSL https://ade-app.dev/install.sh | sh
```

```powershell Windows theme={null}
irm https://ade-app.dev/install.ps1 | iex
```

Prefer to click? Download the desktop app for [Apple Silicon](https://ade-app.dev/download/mac-arm64), [Intel](https://ade-app.dev/download/mac-x64), or [Windows x64](https://ade-app.dev/download/windows). On Windows, a few features differ — [what differs](https://ade-app.dev/docs/getting-started/windows.md). On Linux, ADE runs headless as the brain and you drive it from elsewhere — see [Connect a machine](https://ade-app.dev/docs/getting-started/connect-machine.md). Full detail: [Install ADE](https://ade-app.dev/docs/getting-started/install.md). The optional iOS companion is on [TestFlight](https://testflight.apple.com/join/ZSdJGKPy).

**2. Connect one AI provider**

Open **Settings -> AI Providers** and verify at least one provider. Claude Code, Codex, Muse Code, Cursor, Factory Droid, OpenCode, and seven more are the agent paths — see [Agents and models](https://ade-app.dev/docs/concepts/agents-and-models.md).

**3. Open a Git repository**

Use **Open Repository** on the welcome screen or press `Cmd+O` (`Ctrl+O` on Windows). Choose the repository root, not a subfolder.

**4. 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.

**5. Ask for one small change**

Open the lane in **Work** or **Chat** and send a narrow task. Start with something easy to inspect.

**6. 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.

## 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

> [card] [Key concepts](https://ade-app.dev/docs/key-concepts.md)
>
> Understand the product vocabulary without reading a reference manual.

> [card] [Your first task](https://ade-app.dev/docs/getting-started/first-task.md)
>
> More detail on choosing a provider, watching tool calls, and reviewing output.

> [card] [Lanes](https://ade-app.dev/docs/lanes/overview.md)
>
> How ADE keeps parallel work isolated.

> [card] [Pull requests](https://ade-app.dev/docs/tools/pull-requests.md)
>
> How finished lane work moves into GitHub review.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.