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

# Welcome to ADE

> ADE runs every AI coding agent in one native workspace — macOS, iOS, and the terminal, synced in real time.

ADE runs **Claude Code, Codex, Cursor, Factory Droid, and OpenCode** — every major AI coding agent — inside one native workspace. Every task gets its own git worktree, so agents ship features in parallel without colliding. Review and merge PRs in-app. Approve a diff from your phone while another agent tests on your Mac.

<Frame>
  <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/landing/hero/desktop.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=d469ef9ab3625a41acd3c89a891a6816" alt="ADE desktop — lanes, agent chat, and tools in one window" width="2572" height="1398" data-path="media/landing/hero/desktop.webp" />
</Frame>

<Columns cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart" horizontal>
    Ship your first agent task in five steps.
  </Card>

  <Card title="Key concepts" icon="lightbulb" href="/key-concepts" horizontal>
    The vocabulary, in two minutes.
  </Card>

  <Card title="Download for Mac" icon="apple" href="https://github.com/arul28/ADE/releases/latest" horizontal>
    Free, open source. macOS 13+.
  </Card>

  <Card title="Download for iOS" icon="mobile-screen" href="https://testflight.apple.com/join/ZSdJGKPy" horizontal>
    Install the ADE companion app from TestFlight.
  </Card>
</Columns>

## What you get

<CardGroup cols={2}>
  <Card title="Parallel lanes" icon="code-branch" href="/lanes/overview" img="/media/landing/showcase/worktrees-desktop.webp">
    Every task gets its own git worktree — its own branch, files, and sessions. Agents work side by side, no stashing, no context switch.
  </Card>

  <Card title="Every agent, one chat" icon="comments" href="/chat/overview" img="/media/landing/showcase/agent-chat-desktop.webp">
    Claude Code, Codex, Cursor, Factory Droid, and OpenCode — pick the model per task, all against the same lane with live diffs and approval gates.
  </Card>

  <Card title="Open, review, merge PRs" icon="code-pull-request" href="/tools/pull-requests" img="/media/landing/showcase/pull-requests-desktop.webp">
    Every PR your agents open lands in ADE — diff, CI, comments, merge button. No GitHub tab. Auto-merge when green.
  </Card>

  <Card title="Tools, in context" icon="toolbox" href="/tools/browser" img="/media/landing/showcase/work-tools-browser.webp">
    A built-in browser, Files, Git, and the iOS simulator live right next to your chat, so the agent works against what you see.
  </Card>
</CardGroup>

## One workspace, every surface

The same lanes, chats, and PRs follow you across the desktop app, the terminal, and your phone — backed by the same machine in real time.

<Tabs>
  <Tab title="Desktop">
    <Frame caption="The full control plane on macOS.">
      <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/landing/hero/desktop.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=d469ef9ab3625a41acd3c89a891a6816" alt="ADE on macOS" width="2572" height="1398" data-path="media/landing/hero/desktop.webp" />
    </Frame>
  </Tab>

  <Tab title="Terminal">
    <Frame caption="ade code — the same lanes and chats, terminal-native.">
      <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/landing/hero/tui.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=79d61ab5a3d203ca3e1502de9a86393e" alt="ADE in the terminal" width="2022" height="1113" data-path="media/landing/hero/tui.webp" />
    </Frame>
  </Tab>

  <Tab title="iOS">
    <Frame caption="Review and chat from anywhere.">
      <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/landing/hero/mobile.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=773db78b2b1e49de09928d085a0ec5ca" alt="ADE on iPhone" width="300" data-path="media/landing/hero/mobile.webp" />
    </Frame>
  </Tab>
</Tabs>

## The usual loop

<Steps>
  <Step title="Open a repository">
    ADE creates local project state under `.ade/` and leaves your source tree under Git's control.
  </Step>

  <Step title="Create a lane">
    A **lane** is ADE's name for a git worktree — an isolated branch and working copy for one task.
  </Step>

  <Step title="Run an agent">
    Ask for a change in chat, launch a terminal, or hand project-wide planning to the CTO.
  </Step>

  <Step title="Review the result">
    Inspect diffs, terminal output, tests, PR state, and proof artifacts from one place.
  </Step>

  <Step title="Ship it">
    Commit, push, open a PR, and merge — without leaving ADE.
  </Step>
</Steps>

## App map

<Columns cols={2}>
  <Card title="Work" icon="rectangle-terminal" href="/chat/overview">
    Agent chats, terminals, and CLI sessions across lanes, with Git, Files, Browser, and iOS tools alongside.
  </Card>

  <Card title="Lanes" icon="code-branch" href="/lanes/overview">
    Create, inspect, stack, archive, and clean up isolated worktrees.
  </Card>

  <Card title="Files" icon="file-code" href="/tools/files-editor">
    Read diffs, edit files, stage changes, and resolve conflicts.
  </Card>

  <Card title="PRs" icon="code-pull-request" href="/tools/pull-requests">
    Create and review GitHub PRs, read CI, and manage stacked work.
  </Card>

  <Card title="Graph" icon="diagram-project" href="/tools/workspace-graph">
    Lane topology, PR links, stack relationships, and merge risk.
  </Card>

  <Card title="CTO" icon="crown" href="/cto/overview">
    A persistent project-level operator with durable memory that reasons across every lane.
  </Card>
</Columns>

## Runs the agents you already use

ADE doesn't replace your agent — it runs all of them, against the same worktrees, in one place.

<Frame>
  <div style={{ display: "flex", flexWrap: "wrap", gap: "1rem", alignItems: "center", justifyContent: "center", padding: "1.25rem 0.5rem" }}>
    <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/logos/competitors/claude-code.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=aff0b77e81c816e091d981d3631b20fe" alt="Claude Code" style={{ height: "40px", background: "#fff", borderRadius: "12px", padding: "10px 14px" }} width="640" height="640" data-path="media/logos/competitors/claude-code.webp" />

    <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/logos/competitors/codex.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=1af416609499016d9549c087080bb416" alt="Codex" style={{ height: "40px", background: "#fff", borderRadius: "12px", padding: "10px 14px" }} width="640" height="640" data-path="media/logos/competitors/codex.webp" />

    <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/logos/competitors/cursor.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=7449662d8336a078be888aa4503f0eeb" alt="Cursor" style={{ height: "40px", background: "#fff", borderRadius: "12px", padding: "10px 14px" }} width="640" height="640" data-path="media/logos/competitors/cursor.webp" />

    <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/logos/competitors/factory.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=5555ab7e72f64e536d45ad576b86a39a" alt="Factory Droid" style={{ height: "40px", background: "#fff", borderRadius: "12px", padding: "10px 14px" }} width="1016" height="1016" data-path="media/logos/competitors/factory.webp" />

    <img src="https://mintcdn.com/ade-ac1c6011/lmMpn49wx_3bhn_c/media/logos/competitors/opencode.webp?fit=max&auto=format&n=lmMpn49wx_3bhn_c&q=85&s=787e460ca160fd5195a338e7d45aa467" alt="OpenCode" style={{ height: "40px", background: "#fff", borderRadius: "12px", padding: "10px 14px" }} width="640" height="640" data-path="media/logos/competitors/opencode.webp" />
  </div>
</Frame>

<Note>
  Start small. Your first successful ADE session should be one lane, one agent, one narrow change, and one review pass.
</Note>

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Follow the shortest path to a working agent.
  </Card>

  <Card title="Key concepts" icon="lightbulb" href="/key-concepts">
    Learn the product vocabulary before going deeper.
  </Card>
</CardGroup>
