> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-mobile-chat-stability-54bd7ef0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to ADE

> ADE is a local-first desktop app for coordinating AI coding agents across lanes, chats, terminals, PRs, and mobile.

ADE is the control plane for agentic development on your Mac. It does not replace your editor or GitHub. It sits around them so you can run several coding agents at once, keep their work isolated, and review the results with a clear record of what happened.

<CardGroup cols={3}>
  <Card title="Work in lanes" icon="code-branch">
    Put each task in its own git worktree so agents do not collide with your main checkout or each other.
  </Card>

  <Card title="Talk to agents" icon="comments">
    Start lane-scoped chats with Claude, Codex, Cursor, or OpenCode and let agents edit, test, commit, and explain.
  </Card>

  <Card title="Review before merge" icon="code-pull-request">
    Use Files, PRs, Graph, and History to inspect diffs, CI, conflicts, proof, and session transcripts.
  </Card>
</CardGroup>

## 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 for the task">
    A lane is an isolated branch and worktree. Use one lane per feature, fix, experiment, or PR.
  </Step>

  <Step title="Run an agent or a terminal">
    Ask for a targeted change in chat, launch an interactive shell, or hand larger coordination to the CTO and workers.
  </Step>

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

  <Step title="Ship or split the work">
    Commit, push, create a PR, stack follow-up lanes, or ask another agent to continue in a separate lane.
  </Step>
</Steps>

## App map

| Surface      | Use it for                                                            |
| ------------ | --------------------------------------------------------------------- |
| **Run**      | Start dev processes, run tests, and see project health.               |
| **Lanes**    | Create, inspect, stack, archive, and clean up isolated worktrees.     |
| **Work**     | Manage chats, terminals, and CLI sessions across lanes.               |
| **Files**    | Read diffs, edit files, stage changes, and resolve conflicts.         |
| **Graph**    | See lane topology, PR links, stack relationships, and merge risk.     |
| **PRs**      | Create and review GitHub PRs, read CI, and manage stacked work.       |
| **History**  | Search the record of sessions, commits, PR activity, and checkpoints. |
| **CTO**      | Ask project-level questions, delegate work, and manage worker agents. |
| **Settings** | Configure providers, GitHub, Linear, permissions, mobile, and usage.  |

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

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