# ADE ## Docs - [Claude Code](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/ai-tools/claude-code.md): Claude Code runs inside ADE through the bundled Claude Agent SDK — scoped to a lane, with permission modes and transcripts handled for you. - [Cursor](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/ai-tools/cursor.md): Run Cursor as an agent provider in ADE through the Cursor SDK — one of ADE's five agents, scoped to a lane. - [OpenCode & Windsurf](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/ai-tools/windsurf.md): Run OpenCode as a managed agent provider inside ADE — and keep using Windsurf as your editor on the same worktrees. - [Architecture](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/architecture.md): How the ADE brain, project state, the desktop app, ade code, iOS, and optional remote runtimes over SSH fit together. - [Changelog](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/index.md): Latest ADE release notes and release history. - [v1.0.0](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.0.md): Release notes for ADE v1.0.0 — March 13, 2026 - [v1.0.1](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.1.md): Release notes for ADE v1.0.1 — March 14, 2026 - [v1.0.10](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.10.md): Release notes for ADE v1.0.10 — March 30, 2026 - [v1.0.11](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.11.md): Release notes for ADE v1.0.11 — April 1, 2026 - [v1.0.12](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.12.md): Release notes for ADE v1.0.12 — April 2, 2026 - [v1.0.13](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.13.md): Release notes for ADE v1.0.13 — April 7, 2026 - [v1.0.14](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.14.md): Release notes for ADE v1.0.14 — April 9, 2026 - [v1.0.15](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.15.md): Release notes for ADE v1.0.15 — April 10, 2026 - [v1.0.16](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.16.md): Release notes for ADE v1.0.16 — April 11, 2026 - [v1.0.17](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.17.md): Release notes for ADE v1.0.17 — April 11, 2026 - [v1.0.18](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.18.md): Release notes for ADE v1.0.18 — April 14, 2026 - [v1.0.19](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.19.md): Release notes for ADE v1.0.19 — April 21, 2026 - [v1.0.2](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.2.md): Release notes for ADE v1.0.2 — March 15, 2026 - [v1.0.3](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.3.md): Release notes for ADE v1.0.3 — March 22, 2026 - [v1.0.4](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.4.md): Release notes for ADE v1.0.4 — March 24, 2026 - [v1.0.6](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.6.md): Release notes for ADE v1.0.6 — March 24, 2026 - [v1.0.7](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.7.md): Release notes for ADE v1.0.7 — March 25, 2026 - [v1.0.8](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.0.8.md): Release notes for ADE v1.0.8 — March 26, 2026 - [v1.1.0](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.0.md): Release notes for ADE v1.1.0 — April 22, 2026 - [v1.1.10](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.10.md): Release notes for ADE v1.1.10 - May 2, 2026 - [v1.1.11](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.11.md): Release notes for ADE v1.1.11 - May 4, 2026 - [v1.1.12](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.12.md): Release notes for ADE v1.1.12 - May 6, 2026 - [v1.1.2](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.2.md): Release notes for ADE v1.1.2 — April 22, 2026 - [v1.1.3](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.3.md): Release notes for ADE v1.1.3 — April 23, 2026 - [v1.1.4](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.4.md): Release notes for ADE v1.1.4 — April 24, 2026 - [v1.1.5](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.5.md): Release notes for ADE v1.1.5 — April 25, 2026 - [v1.1.6](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.6.md): Release notes for ADE v1.1.6 — April 26, 2026 - [v1.1.7](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.7.md): Release notes for ADE v1.1.7 — April 29, 2026 - [v1.1.8](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.8.md): Release notes for ADE v1.1.8 — April 30, 2026 - [v1.1.9](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.1.9.md): Release notes for ADE v1.1.9 — May 1, 2026 - [v1.2.0](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.0.md): Release notes for ADE v1.2.0 - June 12, 2026 - [v1.2.1](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.1.md): Release notes for ADE v1.2.1 - June 13, 2026 - [v1.2.2](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.2.md): Release notes for ADE v1.2.2 - June 13, 2026 - [v1.2.3](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.3.md): Release notes for ADE v1.2.3 - June 13, 2026 - [v1.2.4](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.4.md): Release notes for ADE v1.2.4 - June 15, 2026 - [v1.2.5](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.5.md): Release notes for ADE v1.2.5 - June 15, 2026 - [v1.2.6](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.6.md): Release notes for ADE v1.2.6 - June 16, 2026 - [v1.2.7](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.7.md): Release notes for ADE v1.2.7 - June 16, 2026 - [v1.2.8](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.8.md): Release notes for ADE v1.2.8 - June 19, 2026 - [v1.2.9](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/changelog/v1.2.9.md): Release notes for ADE v1.2.9 - June 23, 2026 - [Chat capabilities](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/chat/capabilities.md): The tools a chat agent can use inside a lane — read and edit files, run commands, drive Git, open PRs, and capture proof. - [Context and artifacts](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/chat/context.md): What's in a chat's context — the lane it starts in, attachments, the transcript, and how summaries carry work forward. - [Grid & multi-model](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/chat/grid.md): Run several agents at once and compare their work side by side in grid view. - [Agent chat](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/chat/overview.md): Talk to a coding agent that reads, edits, runs commands, and opens PRs — all scoped to one lane's worktree. - [Proof configuration](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/computer-use/config.md): Where proof artifacts are stored, how long they last, and how to troubleshoot capture. - [Proof](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/computer-use/overview.md): Capture screenshots, recordings, browser traces, console logs, and verification notes as evidence for agent work — linked to the chat, lane, PR, or Linear issue they belong to. - [Review proof](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/computer-use/proofs.md): The capture → review → attach lifecycle: owners, review states, and good habits. - [Capture proof](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/computer-use/setup.md): Capture evidence from the CLI with the real `ade proof` commands — capture, attach, list, and status. - [AI providers](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/configuration/ai-providers.md): Connect Claude Code, Codex, Cursor, Factory Droid, and OpenCode — with your own key or an existing subscription. - [Configuration overview](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/configuration/overview.md): The `.ade/` directory, the shared-vs-local trust model, and what stays out of Git. - [Permissions and security](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/configuration/permissions.md): How ADE keeps agent work scoped to a lane, makes shared config trusted before it runs, and keeps secrets local. - [Settings](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/configuration/settings.md): The real ADE settings tabs, a recommended first pass, and the first-run setup that detects your stack. - [CTO](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/cto/overview.md): The CTO is ADE's persistent, project-level operator — one per project. It keeps context across every lane, plans work, and delegates to workers. - [Set up the CTO](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/cto/setup.md): Give the CTO a persona and model, connect GitHub and Linear, add a worker or two, and start with a planning prompt. - [Workers](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/cto/workers.md): Workers are named agent identities the CTO delegates scoped work to — each with a role, model, budget, and activity history, running in its own lane. - [Connect an AI provider](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/getting-started/connect-provider.md): Add one provider — by API key or your existing subscription — so ADE can run coding agents. - [Run your first agent](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/getting-started/first-agent.md): Start a lane-scoped chat, watch the tool calls, and review the diff. - [Create your first lane](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/getting-started/first-lane.md): Create an isolated branch and worktree for your first agent task. - [Install ADE](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/getting-started/install.md): Download ADE for macOS — DMG or Homebrew — launch it, and run in guest mode with no account. - [Open your first project](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/getting-started/open-project.md): Point ADE at a Git repository — open a local folder or clone from GitHub — and let it create local project state. - [Multi-agent setup](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/guides/multi-agent-setup.md): Run several agents safely by giving each task its own lane, watching for collisions, and choosing the grid when you want to compare attempts. - [Guide: stacked PRs](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/guides/stacked-prs.md): Land a stack of dependent PRs in order using child lanes — small, ordered diffs that build on each other. - [GitHub](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/integrations/github.md): Connect GitHub so ADE can open, review, and merge pull requests for your lanes — without leaving the app. - [Linear](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/integrations/linear.md): Linear is a first-class, two-way integration owned by the CTO — attach issues to lanes and chats, sync status, and run issues end to end with workflow presets. - [Key concepts](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/key-concepts.md): The ADE vocabulary: lanes, Work, chats, agents, CTO, workers, proof, PRs, mobile, and local project state. - [Create and manage lanes](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/lanes/creating.md): Every way to start a lane — new worktree, child lane, imported branch, or attached external worktree — plus rename, archive, and delete. - [Lane runtime](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/lanes/environment.md): Each lane can be a full parallel dev environment — its own port range, .localhost hostname, OAuth callback routing, and optional env init. Advanced, and automatic for most. - [Lanes](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/lanes/overview.md): A lane is ADE's name for a git worktree — one isolated branch and working copy per task, so agents work in parallel without colliding. - [Stacked lanes](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/lanes/stacks.md): Child lanes branch off another lane instead of main, so one big change ships as a stack of small, dependent PRs that merge in order. - [Quickstart](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/quickstart.md): Install ADE, open a project, create a lane, and run your first agent task. - [ade CLI](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/reference/cli.md): The ade command is the typed control plane for ADE from any shell — the same lanes, chats, PRs, and tests, scriptable for humans and agents alike. - [Troubleshooting](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/reference/troubleshooting.md): Fixes for the common snags — the brain not running, providers with no models, mobile sync, stuck lanes, and remote SSH connections. - [ade code (terminal)](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/ade-code.md): ADE, terminal-native. The same lanes, chats, and PRs in a fast TUI you can drive over SSH. - [Automations](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/automations.md): Rule-based background workflows: a trigger fires, an agent session or built-in action runs, and guardrails gate anything that publishes externally. - [Browser](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/browser.md): ADE's built-in browser pane in Work — open pages beside your code, inspect elements, and hand exactly what you see to an agent. - [Conflicts](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/conflicts.md): Predict, simulate, and resolve merge conflicts between lanes before they ever block a merge. - [Files](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/files-editor.md): ADE's review workbench — a lane-scoped file tree, Monaco editor, diffs, conflict resolution, and a Git panel for staging, committing, and pushing. - [History](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/history.md): A per-project timeline with two surfaces: a commit graph for each lane and a unified activity feed. - [iOS companion](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/ios-companion.md): Pair the ADE iOS app with your Mac over a live WebSocket and mirror lanes, chats, and PRs in real time — start chats, review and merge PRs, all from your phone. - [iOS Simulator](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/ios-simulator.md): A macOS-only drawer in Work that builds, launches, mirrors, inspects, and controls a booted iOS Simulator — and turns a tapped SwiftUI view into source-anchored chat context. - [Run](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/project-home.md): ADE's project home and per-lane runtime dashboard — managed processes, stacks, tests, ports, health, and logs in one place. - [Pull requests](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/pull-requests.md): Open, review, and merge GitHub PRs from inside ADE — with stacked PRs, a merge queue, and auto-merge. - [Remote machines](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/remote-machines.md): Point ADE at a repository or dev stack that lives on another box over SSH, while the desktop stays your control plane. - [Review](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/review.md): On-demand AI code review. Pick a scope, run a review, and act on the findings — separate from PR comments. - [Work sessions](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/terminals.md): Agent chats, provider CLIs, plain shells, and managed processes — every Work session is lane-scoped and tracked in one place. - [Workspace graph](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/tools/workspace-graph.md): A visual map of your lanes, stacks, PRs, and merge risk — rendered on a live canvas. - [Welcome to ADE](https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.app/welcome.md): ADE runs every AI coding agent in one native workspace — macOS, iOS, and the terminal, synced in real time. ## Optional - [Download](https://github.com/arul28/ADE/releases/latest) - [GitHub](https://github.com/arul28/ADE)