Skip to main content
Project setup is a convenience flow, not a gate. You can skip any step and configure it later in Settings.

​
Setup checklist

1

Developer tools

ADE checks for Git and other useful local tools. Git is the important one because lanes use worktrees.
2

AI providers

Connect or verify at least one provider so chats and workers can run.
3

GitHub

Optional, but recommended if you want PR creation, CI status, review comments, and merge workflows inside ADE.
4

Linear

Optional. Connect Linear if you want issues linked to lanes, PRs, CTO planning, and follow-up notes.
5

Project preferences

Review project name, default branch, lane defaults, and any suggested process or test commands.

​
Where settings live

Most configuration is local to your machine. Provider credentials and secrets stay out of Git. Project-specific defaults can be shared deliberately, but ADE keeps local runtime state under .ade/.

Settings overview

See the main settings sections.

Configuration overview

Understand local project state and shared defaults.