# ADE

## Docs

- [Architecture](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/architecture.md): How the ADE runtime, desktop app, ADE Code, iOS app, and remote machines work together.
- [Execution surfaces](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/automations/executors.md): Pick between an automation-only agent session, a Worker run, or a built-in task for each automation rule.
- [Guardrails & Security](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/automations/guardrails.md): Secure your automations with tool palette restrictions, budget caps, and preflight controls. Covers agent-session, worker run, and built-in-task execution.
- [Automations Overview](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/automations/overview.md): Programmable rules that run background work by time or action. Each automation can launch an agent session, a worker run, or a built-in task from a single surface.
- [Templates and outputs](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/automations/templates.md): Start from a built-in automation template, then configure how results are delivered across lanes, PRs, Linear, and ADE's artifact store.
- [Changelog](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/index.md): Latest ADE release notes and release history.
- [v1.0.0](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.0.md): Release notes for ADE v1.0.0 — March 13, 2026
- [v1.0.1](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.1.md): Release notes for ADE v1.0.1 — March 14, 2026
- [v1.0.10](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.10.md): Release notes for ADE v1.0.10 — March 30, 2026
- [v1.0.11](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.11.md): Release notes for ADE v1.0.11 — April 1, 2026
- [v1.0.12](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.12.md): Release notes for ADE v1.0.12 — April 2, 2026
- [v1.0.13](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.13.md): Release notes for ADE v1.0.13 — April 7, 2026
- [v1.0.14](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.14.md): Release notes for ADE v1.0.14 — April 9, 2026
- [v1.0.15](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.15.md): Release notes for ADE v1.0.15 — April 10, 2026
- [v1.0.16](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.16.md): Release notes for ADE v1.0.16 — April 11, 2026
- [v1.0.17](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.17.md): Release notes for ADE v1.0.17 — April 11, 2026
- [v1.0.18](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.18.md): Release notes for ADE v1.0.18 — April 14, 2026
- [v1.0.19](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.19.md): Release notes for ADE v1.0.19 — April 21, 2026
- [v1.0.2](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.2.md): Release notes for ADE v1.0.2 — March 15, 2026
- [v1.0.3](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.3.md): Release notes for ADE v1.0.3 — March 22, 2026
- [v1.0.4](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.4.md): Release notes for ADE v1.0.4 — March 24, 2026
- [v1.0.6](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.6.md): Release notes for ADE v1.0.6 — March 24, 2026
- [v1.0.7](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.7.md): Release notes for ADE v1.0.7 — March 25, 2026
- [v1.0.8](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.0.8.md): Release notes for ADE v1.0.8 — March 26, 2026
- [v1.1.0](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.0.md): Release notes for ADE v1.1.0 — April 22, 2026
- [v1.1.10](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.10.md): Release notes for ADE v1.1.10 - May 2, 2026
- [v1.1.11](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.11.md): Release notes for ADE v1.1.11 - May 4, 2026
- [v1.1.12](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.12.md): Release notes for ADE v1.1.12 - May 6, 2026
- [v1.1.2](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.2.md): Release notes for ADE v1.1.2 — April 22, 2026
- [v1.1.3](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.3.md): Release notes for ADE v1.1.3 — April 23, 2026
- [v1.1.4](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.4.md): Release notes for ADE v1.1.4 — April 24, 2026
- [v1.1.5](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.5.md): Release notes for ADE v1.1.5 — April 25, 2026
- [v1.1.6](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.6.md): Release notes for ADE v1.1.6 — April 26, 2026
- [v1.1.7](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.7.md): Release notes for ADE v1.1.7 — April 29, 2026
- [v1.1.8](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.8.md): Release notes for ADE v1.1.8 — April 30, 2026
- [v1.1.9](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/changelog/v1.1.9.md): Release notes for ADE v1.1.9 — May 1, 2026
- [Chat Capabilities](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/chat/capabilities.md): What the chat agent can do — file operations, terminal commands, git, PRs, Linear integration, worker run spawning, repo inspection, and ADE action tools.
- [Context & Artifacts](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/chat/context.md): Managing context windows, compaction strategies, working with artifacts, chat history, and troubleshooting common issues.
- [Agent Chat Overview](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/chat/overview.md): Conversational AI with real project access — read files, run commands, create PRs, spawn worker runs, and capture proof artifacts, all from a single chat interface.
- [Configuration](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/computer-use/config.md): Storage layout, retention, and troubleshooting for ADE proof capture.
- [Proof Overview](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/computer-use/overview.md): Proof is ADE's intentional evidence system. Agents capture screenshots, recordings, traces, and logs via the `ade proof` CLI; ADE stores and links them to worker runs, chats, PRs, and Linear issues.
- [Proof Workflow](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/computer-use/proofs.md): How proofs are owned, reviewed, and published. Ownership model, lifecycle states, and review actions.
- [Setup & CLI](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/computer-use/setup.md): Install local capture prerequisites and learn the `ade proof` commands agents use to record intentional evidence.
- [AI Providers](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/configuration/ai-providers.md): Configure Anthropic, OpenAI, OpenRouter, OpenCode, and local models in ADE. Manage API keys, set budget caps, and control which model each agent uses.
- [Configuration Overview](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/configuration/overview.md): ADE stores project configuration in a .ade/ directory at your repository root. Shared team settings, personal overrides, and local secret references stay separated by a SHA-based trust model.
- [Permissions & Security](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/configuration/permissions.md): ADE's layered security model — trust boundaries, SHA-based config approval, per-agent permissions, file path restrictions, command policies, secret protection, and the audit trail.
- [Settings](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/configuration/settings.md): Reference for every section in ADE Settings — General, Appearance, Workspace, AI, Mobile Push, Integrations, Lane Templates, and Usage.
- [Linear Integration](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/cto/linear.md): Connect Linear for bidirectional issue sync — the CTO reads from and writes to Linear, routing issues to workers, updating statuses when PRs merge, and adding analysis comments automatically.
- [CTO Agent Overview](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/cto/overview.md): The CTO is ADE's project-aware AI surface — the top of an intelligent org chart for delegating work, syncing with Linear, and answering questions about your codebase.
- [Setting Up the CTO](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/cto/setup.md): Walk through the CTO onboarding wizard, configure worker heartbeat schedules, and verify the CTO team is active.
- [Workers & Budget](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/cto/workers.md): Hire and manage CTO worker agents, configure token budgets, set up practical workflows like PR review and feature delegation, and troubleshoot common issues.
- [Connect an AI provider](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/getting-started/connect-provider.md): Add a provider credential so ADE can start agents and worker runs.
- [Run your first agent](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/getting-started/first-agent.md): Choose between a direct chat and a structured worker run for your first ADE task — with step-by-step instructions for each approach and guidance on what to try first.
- [Create your first lane](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/getting-started/first-lane.md): Start your first isolated worktree so AI tasks do not run in the primary checkout — step-by-step walkthrough with naming tips, environment setup, and verification.
- [Install ADE](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/getting-started/install.md): Download the macOS beta, move ADE into Applications, and launch it for the first time.
- [Project setup & onboarding](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/getting-started/project-setup.md): Walk through ADE's onboarding wizard step by step — detect tools, connect providers, configure GitHub, and get your project ready for agents.
- [Guide: Setting up automation rules](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/guides/automation-rules.md): Create event-driven automations that trigger AI agents in response to git pushes, PRs, cron schedules, and file changes.
- [Guide: CTO + Linear workflow](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/guides/cto-linear-workflow.md): Connect the CTO agent to Linear for automated issue triage, task delegation, and status syncing.
- [Guide: Running multiple agents](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/guides/multi-agent-setup.md): Run parallel AI agents across lanes, monitor them from the Workspace Graph, and handle conflicts between concurrent work.
- [PR Convergence Workflow](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/guides/pr-convergence.md): End-to-end guide for using ADE's PR convergence loop — from manual issue resolution rounds to fully autonomous auto-converge with auto-merge.
- [Guide: Stacked PRs](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/guides/stacked-prs.md): Use ADE lanes to create, manage, and land stacked pull requests with conflict detection and queue-based landing.
- [Key Concepts](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/key-concepts.md): A comprehensive reference for every core ADE concept: Lanes, Stacks, Packs, Checkpoints, Sessions, the CTO, Workers, Automations, ADE CLI, the Job Engine, Conflicts, and Artifacts.
- [Creating and managing lanes](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/lanes/creating.md): Create a lane from the primary branch, from an existing branch, or as a child of another lane — then rename, archive, or delete it.
- [Lane Environment](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/lanes/environment.md): Port allocation, environment variable overlays, startup commands, preview URLs, runtime isolation, and agent routing for per-lane environments.
- [Lanes Overview](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/lanes/overview.md): Lanes are the fundamental unit of parallel work in ADE — isolated git worktrees, each with its own agent context, terminal sessions, and execution environment.
- [Lane Context](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/lanes/packs.md): How ADE scopes context to a lane — lane and session state plus selected artifacts — while agents inspect the repository directly for product and architecture knowledge.
- [Stacked Lanes](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/lanes/stacks.md): Arrange lanes into stacks — layered branch chains for stacked PR workflows with automatic rebase propagation, drag-to-reparent, and conflict-aware stack management.
- [Quickstart](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/quickstart.md): Install ADE, open your first project, create a Lane, and run your first AI agent in under 10 minutes.
- [Conflicts](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/conflicts.md): ADE continuously simulates merges in the background and surfaces predicted conflicts before they happen — so you resolve disagreements between lanes before a single bad merge touches your codebase.
- [Files & Editor](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/files-editor.md): An IDE-style workbench powered by Monaco — full syntax highlighting, IntelliSense, diff views, conflict resolution, and git operations, all scoped to the selected lane's worktree.
- [History](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/history.md): A complete, searchable operations timeline for your project — every agent action, commit, worker run phase, pack regeneration, and conflict event, with full replay from any checkpoint.
- [Project Home](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/project-home.md): The global process management center for your project — start your entire stack with one button, run test suites, manage environment variables, and launch AI tool CLIs.
- [Pull Requests](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/pull-requests.md): ADE's integrated PR management interface — create, review, and merge GitHub pull requests without leaving the app, with first-class support for stacked PR workflows and pre-merge integration simulations.
- [Terminals & Sessions](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/terminals.md): Real PTY terminal sessions per lane — full xterm.js emulation, session transcripts, checkpoint integration, and agent-spawned sessions with complete audit trails.
- [Workspace Graph](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/tools/workspace-graph.md): An infinite-canvas visualization of your entire project topology — every Lane, PR, branch, and dependency relationship, with live merge simulation.
- [Welcome to ADE](https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/welcome.md): ADE is the Agentic Development Environment — a desktop app that orchestrates parallel AI coding agents from one control plane.

## Optional

- [GitHub](https://github.com/arul28/ADE)