# Diagnose failed CI runs with depot ci diagnose (https://depot.dev/changelog/2026-05-08-depot-ci-diagnose)

> Published 2026-05-08

The new `depot ci diagnose` command points at any run, workflow, job, or attempt ID and tells you what broke, including the failed step, the error lines that matter, and the exact commands to dig deeper:

```bash
depot ci diagnose --run <run-id>
depot ci diagnose --workflow <workflow-id>
depot ci diagnose --job <job-id>
depot ci diagnose --attempt <attempt-id>
```

The diagnosis is built from bounded stored failure context, so you get the relevant signal without paging through full logs. Add `--output json` to pipe the result into scripts or hand it to an agent. For details, see the [Depot CI CLI reference](/docs/cli/reference/depot-ci).

## For AI Agents

The full site index is at [llms.txt](https://depot.dev/llms.txt). Append `.md` to any documentation, blog, changelog, or customer URL to fetch its markdown source directly.