# ADE

## Docs

- [Execution surfaces](https://ade-app.dev/docs/automations/executors.md): Pick between an automation-only agent session, a Mission, or a built-in task for each automation rule.
- [Guardrails & Security](https://ade-app.dev/docs/automations/guardrails.md): Secure your automations with tool palette restrictions, memory modes, budget caps, and preflight controls. Covers agent-session, mission, and built-in-task execution.
- [Automations Overview](https://ade-app.dev/docs/automations/overview.md): Programmable rules that run background work by time or action. Each automation can launch an agent session, a mission, or a built-in task from a single surface.
- [Templates and outputs](https://ade-app.dev/docs/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.
- [v1.0.0](https://ade-app.dev/docs/changelog/v1.0.0.md): Release notes for ADE v1.0.0 — March 13, 2026
- [v1.0.1](https://ade-app.dev/docs/changelog/v1.0.1.md): Release notes for ADE v1.0.1 — March 14, 2026
- [v1.0.10](https://ade-app.dev/docs/changelog/v1.0.10.md): Release notes for ADE v1.0.10 — March 30, 2026
- [v1.0.11](https://ade-app.dev/docs/changelog/v1.0.11.md): Release notes for ADE v1.0.11 — April 1, 2026
- [v1.0.12](https://ade-app.dev/docs/changelog/v1.0.12.md): Release notes for ADE v1.0.12 — April 2, 2026
- [v1.0.13](https://ade-app.dev/docs/changelog/v1.0.13.md): Release notes for ADE v1.0.13 — April 7, 2026
- [v1.0.14](https://ade-app.dev/docs/changelog/v1.0.14.md): Release notes for ADE v1.0.14 — April 9, 2026
- [v1.0.15](https://ade-app.dev/docs/changelog/v1.0.15.md): Release notes for ADE v1.0.15 — April 10, 2026
- [v1.0.16](https://ade-app.dev/docs/changelog/v1.0.16.md): Release notes for ADE v1.0.16 — April 11, 2026
- [v1.0.17](https://ade-app.dev/docs/changelog/v1.0.17.md): Release notes for ADE v1.0.17 — April 11, 2026
- [v1.0.18](https://ade-app.dev/docs/changelog/v1.0.18.md): Release notes for ADE v1.0.18 — April 14, 2026
- [v1.0.19](https://ade-app.dev/docs/changelog/v1.0.19.md): Release notes for ADE v1.0.19 — April 21, 2026
- [v1.0.2](https://ade-app.dev/docs/changelog/v1.0.2.md): Release notes for ADE v1.0.2 — March 15, 2026
- [v1.0.3](https://ade-app.dev/docs/changelog/v1.0.3.md): Release notes for ADE v1.0.3 — March 22, 2026
- [v1.0.4](https://ade-app.dev/docs/changelog/v1.0.4.md): Release notes for ADE v1.0.4 — March 24, 2026
- [v1.0.6](https://ade-app.dev/docs/changelog/v1.0.6.md): Release notes for ADE v1.0.6 — March 24, 2026
- [v1.0.7](https://ade-app.dev/docs/changelog/v1.0.7.md): Release notes for ADE v1.0.7 — March 25, 2026
- [v1.0.8](https://ade-app.dev/docs/changelog/v1.0.8.md): Release notes for ADE v1.0.8 — March 26, 2026
- [v1.1.0](https://ade-app.dev/docs/changelog/v1.1.0.md): Release notes for ADE v1.1.0 — April 22, 2026
- [v1.1.2](https://ade-app.dev/docs/changelog/v1.1.2.md): Release notes for ADE v1.1.2 — April 22, 2026
- [v1.1.3](https://ade-app.dev/docs/changelog/v1.1.3.md): Release notes for ADE v1.1.3 — April 23, 2026
- [v1.1.4](https://ade-app.dev/docs/changelog/v1.1.4.md): Release notes for ADE v1.1.4 — April 24, 2026
- [v1.1.5](https://ade-app.dev/docs/changelog/v1.1.5.md): Release notes for ADE v1.1.5 — April 25, 2026
- [v1.1.6](https://ade-app.dev/docs/changelog/v1.1.6.md): Release notes for ADE v1.1.6 — April 26, 2026
- [v1.1.7](https://ade-app.dev/docs/changelog/v1.1.7.md): Release notes for ADE v1.1.7 — April 29, 2026
- [Chat Capabilities](https://ade-app.dev/docs/chat/capabilities.md): What the chat agent can do — file operations, terminal commands, git, PRs, Linear integration, mission spawning, repo inspection, and ADE action tools.
- [Context & Artifacts](https://ade-app.dev/docs/chat/context.md): Managing context windows, compaction strategies, working with artifacts, chat history, and troubleshooting common issues.
- [Agent Chat Overview](https://ade-app.dev/docs/chat/overview.md): Conversational AI with real project access — read files, run commands, create PRs, spawn missions, and capture proof artifacts, all from a single chat interface.
- [Configuration](https://ade-app.dev/docs/computer-use/config.md): Proof requirement profiles and troubleshooting common computer use issues in ADE.
- [Computer Use Overview](https://ade-app.dev/docs/computer-use/overview.md): ADE is the control plane for computer use — it discovers backends, injects guidance, ingests proof artifacts, and links them to missions, chats, PRs, and Linear issues.
- [Proofs & Artifacts](https://ade-app.dev/docs/computer-use/proofs.md): Proof artifact types, how computer use integrates with missions and chat sessions, and the artifact ownership model.
- [Connecting Backends](https://ade-app.dev/docs/computer-use/setup.md): Step-by-step setup guides for connecting Ghost OS and agent-browser backends to ADE, plus computer use policy reference.
- [AI Providers](https://ade-app.dev/docs/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-app.dev/docs/configuration/overview.md): ADE stores all project configuration in a .ade/ directory at your repository root. Three layered config files give you shared team settings, personal overrides, and secret management — all with a SHA-based trust model.
- [Permissions & Security](https://ade-app.dev/docs/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-app.dev/docs/configuration/settings.md): Complete reference for every setting in ADE — from AI provider management and budget caps to notifications, permissions, and developer tooling.
- [Linear Integration](https://ade-app.dev/docs/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 Memory](https://ade-app.dev/docs/cto/memory.md): Understand the CTO's multi-scope memory architecture — persistent, layered knowledge of your project that accumulates over time across runtime, run, project, identity, and daily-log scopes.
- [CTO Agent Overview](https://ade-app.dev/docs/cto/overview.md): The CTO is ADE's always-on, project-aware AI agent — the top of an intelligent org chart that watches your project, delegates work, syncs with Linear, and answers questions about your codebase.
- [Setting Up the CTO](https://ade-app.dev/docs/cto/setup.md): Walk through the CTO onboarding wizard, configure heartbeat schedules, and verify the CTO is active and monitoring your project.
- [Workers & Budget](https://ade-app.dev/docs/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-app.dev/docs/getting-started/connect-provider.md): Add a provider credential so ADE can start agents and missions.
- [Run your first agent](https://ade-app.dev/docs/getting-started/first-agent.md): Choose between a direct chat and a structured mission 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-app.dev/docs/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-app.dev/docs/getting-started/install.md): Download the macOS beta, move ADE into Applications, and launch it for the first time.
- [Project setup & onboarding](https://ade-app.dev/docs/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-app.dev/docs/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-app.dev/docs/guides/cto-linear-workflow.md): Connect the CTO agent to Linear for automated issue triage, task delegation, and status syncing.
- [Guide: Your first mission](https://ade-app.dev/docs/guides/first-mission.md): A step-by-step walkthrough of creating and running a multi-step mission in ADE.
- [Guide: Running multiple agents](https://ade-app.dev/docs/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-app.dev/docs/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-app.dev/docs/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-app.dev/docs/key-concepts.md): A comprehensive reference for every core ADE concept: Lanes, Stacks, Packs, Checkpoints, Sessions, the CTO, Missions, Automations, Workers, ADE CLI, the Job Engine, Conflicts, and Artifacts.
- [Creating and managing lanes](https://ade-app.dev/docs/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-app.dev/docs/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-app.dev/docs/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 Packs](https://ade-app.dev/docs/lanes/packs.md): Lane Packs are auto-generated, versioned context bundles that travel with each lane — giving every agent session instant orientation on the lane's intent, touched files, and current state.
- [Stacked Lanes](https://ade-app.dev/docs/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.
- [Budget and permissions](https://ade-app.dev/docs/missions/budget.md): Configure budget caps, per-provider permission modes, proof capture, mission persistence, and resolve common mission problems.
- [Creating Missions](https://ade-app.dev/docs/missions/creating.md): Start a mission from the Missions tab, a lane, the CTO chat, or an existing chat session, then navigate the detail view while it runs.
- [Missions Overview](https://ade-app.dev/docs/missions/overview.md): Multi-step orchestration for work that is bigger than one chat thread: planning, lane orchestration, human checkpoints, and closeout captured as one run.
- [Workers and interventions](https://ade-app.dev/docs/missions/workers.md): How mission workers run, when a mission pauses for human input, and how ADE classifies failures.
- [Quickstart](https://ade-app.dev/docs/quickstart.md): Install ADE, open your first project, create a Lane, and run your first AI agent in under 10 minutes.
- [Conflicts](https://ade-app.dev/docs/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-app.dev/docs/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-app.dev/docs/tools/history.md): A complete, searchable operations timeline for your project — every agent action, commit, mission phase, pack regeneration, and conflict event, with full replay from any checkpoint.
- [Project Home](https://ade-app.dev/docs/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-app.dev/docs/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-app.dev/docs/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-app.dev/docs/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-app.dev/docs/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)