Proof configuration

Storage, retention, and troubleshooting for proof artifacts.

Storage

Proof files live under the project’s .ade/ directory:

.ade/artifacts/computer-use/
  <artifact-id>.png
  <artifact-id>.mp4
  <artifact-id>.zip

Metadata such as owner links, review state, notes, and file type lives in ADE’s local database.

Retention

ADE keeps proof artifacts until you dismiss or delete them. This preserves review evidence after a PR or task is complete.

Clean up old proof from the UI when artifacts are no longer useful. Avoid deleting files directly from .ade/artifacts/, because that leaves database records pointing at missing files.

Troubleshooting

Screenshots are blank

Grant Screen Recording permission to ADE in macOS System Settings, then quit and relaunch ADE.

Capture is unavailable

Run ade proof status --text and confirm the local capture tools are available.

A proof is not attached to a PR

Open the proof, check its owners, and publish or attach it to the PR again.

Ingest fails

Confirm each input has real content through path, uri, text, or json.