Skip to main content

​
Storage

All captured proofs live under the project’s .ade/ directory:
The metadata (kind, owner links, review state, workflow state, notes) is stored in ADE’s SQLite database — not in the file itself — so renaming or moving files on disk breaks the link. Use the UI or the ade proof CLI to manage proofs; avoid touching the files directly.

​
Retention

By default, ADE retains all captured proofs until you explicitly dismiss them. There is no automatic expiration. If the .ade/artifacts/computer-use/ directory grows large:
  • Dismissed proofs can be deleted from disk with a confirmation dialog from the Artifacts tab
  • ade proof list --kind <kind> helps you identify old proofs of a specific kind
  • For bulk cleanup, delete the row via the UI; the file is removed with it
Proofs linked to closed PRs and completed Linear issues remain on disk until explicitly cleaned up. This is deliberate — it keeps the audit trail intact long after a worker run ends.

​
Troubleshooting

On macOS, ade proof needs screencapture on PATH. Run which screencapture in a terminal — it should resolve to /usr/sbin/screencapture on a standard install.If you are running ADE on Linux or a non-standard shell environment, ensure screencapture (or a compatible alternative) is available to the shell ade runs inside. The status output tells you which binary it looked for.
This is almost always a macOS Screen Recording permission issue.
  1. Open System Settings → Privacy & Security → Screen Recording.
  2. Ensure ADE is listed and enabled.
  3. Quit and relaunch ADE — macOS requires a restart after granting screen recording permission.
  4. Try ade proof screenshot again.
record uses a built-in macOS capture pipeline with a default cap of 120 seconds. Pass --seconds <n> to control duration. For long captures, consider splitting into multiple segments.
Check that the proof’s workflow state is published (review states of accepted on their own do not publish). In the Worker run Artifacts tab, open the proof, click Publish, and choose the PR as a target.If the PR no longer exists or has been closed, the publish call returns an error in the CLI output. Re-target the proof to a different owner.
ade proof ingest rejects entries that do not have at least one of path, uri, text, or json. Confirm your payload has real content — empty inputs are skipped.Pass --verbose to see the ingestion result line-by-line, including which entries were dropped.