Configuration overview

Where ADE stores local project state, shared defaults, credentials, and runtime files.

ADE keeps project state local. Most of what ADE creates belongs under .ade/ in your repository and should not be committed.

.ade/
  ade.db
  worktrees/
  artifacts/
  cache/
  secrets/

What is local

Area	Contains
Database	Lanes, sessions, PR mappings, settings, History metadata.
Worktrees	Managed lane worktrees.
Artifacts	Proof, transcripts, exported evidence, and supporting files.
Secrets	Encrypted or machine-local credentials.
Cache	Derived data ADE can rebuild.

What can be shared

Some teams choose to share project defaults, such as recommended processes, test commands, provider preferences, or lane templates. Keep secrets and machine paths out of shared files.

Never commit provider keys, tokens, local secret files, or the whole .ade/ directory.

Trust model

Commands saved as shared project defaults can run on developer machines. ADE treats those changes as sensitive and may require local approval before using newly changed command definitions.

Settings

Configure the app from the UI.

Permissions

Review security and permission controls.