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

# 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-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="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" icon="apple" href="https://github.com/arul28/ADE/releases/latest" horizontal>
    Free, open source. macOS 13+.
  </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-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="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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/landing/hero/tui.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=aac574b8b7d879aac47bb00ffb21750a" 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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/landing/hero/mobile.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=8534546818a9975ab793c95ba5628348" 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 larger coordination to the CTO and its workers.
  </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">
    Ask project-level questions, delegate to workers, and route Linear issues.
  </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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/logos/competitors/claude-code.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=35d8b0b58496f7266db25b80f4d7ee13" 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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/logos/competitors/codex.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=b3d0866579ce5c6f0dffc99d3d7850ba" 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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/logos/competitors/cursor.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=7656decbf7227049bbda2c5e17b1cebc" 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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/logos/competitors/factory.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=9fa75f5ed3fc2989972ffca67ee5eb39" 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-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/logos/competitors/opencode.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=f292e5e766a76c47a76fb1a656dc80c8" 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>
