> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Storage layout, retention, and troubleshooting for ADE proof capture.

## Storage

All captured proofs live under the project's `.ade/` directory:

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

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

<Note>
  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.
</Note>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="`ade proof status` reports 'no backends available'" icon="circle-question">
    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.
  </Accordion>

  <Accordion title="Screenshots are blank or black" icon="image">
    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.
  </Accordion>

  <Accordion title="`ade proof record` stops after a few seconds" icon="video">
    `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.
  </Accordion>

  <Accordion title="A proof is not showing up on a PR" icon="code-pull-request">
    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.
  </Accordion>

  <Accordion title="Ingesting an external trace fails silently" icon="triangle-exclamation">
    `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.
  </Accordion>
</AccordionGroup>