Skip to main content
This page is the shortest useful path. You can tune providers, permissions, Linear, mobile, and worker settings later.
The ADE desktop app
1

Install ADE

Download the latest macOS DMG from GitHub Releases, open it, and drag ADE.app into /Applications. Install the optional iOS companion from TestFlight.
2

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

Open a Git repository

Use Open Repository on the welcome screen or press Cmd+O. 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

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

Key concepts

Understand the product vocabulary without reading a reference manual.

Run your first agent

More detail on choosing a provider, watching tool calls, and reviewing output.

Lanes

How ADE keeps parallel work isolated.

Pull requests

How finished lane work moves into GitHub review.