{"slug": "show-hn-depot-ci-api-programmable-ci", "title": "Show HN: Depot CI API – Programmable CI", "summary": "Depot has launched a general availability release of its CI API and CLI, enabling developers to manage continuous integration workflows entirely from the terminal or editor without needing the web dashboard. The update introduces a `depot ci diagnose` command that analyzes failed runs and provides targeted error summaries, collapsed matrix failures, and actionable next steps. The move aims to close the gap between dashboard-only features and programmable access, allowing developers and AI agents to query CI status and logs programmatically.", "body_md": "We promised full programmability when we launched Depot CI back in March. Today we make it official: the Depot CI API and CLI are generally available. We believe that you and your agents should be able to do everything you can do in the dashboard from the CLI or API. When you're deep at work in your terminal or editor and need answers about your CI, you don't have to go look. You can just ask.\n\n## Why I care about this one\n\nI work at Depot, so feel free to discount my enthusiasm accordingly. But this one's personal.\n\nThe way I work now, I don't sit in dashboards. I sit in my editor with an agent next to me. When CI breaks, I don't want to alt-tab into a browser, hunt down the run, scroll the logs, and rebuild the whole story in my head. I want to ask the thing right in front of me \"what broke?\" and get an answer.\n\nThat only works if the agent can reach the same information I can. Before today, it couldn't. The dashboard knew things the API and CLI didn't, so the agent was stuck, and so was I.\n\nSoftware that only talks through a browser is software your agent can't help you with. That was the gap. This closes it.\n\n## What's new\n\nUnder the hood, our protobuf/Connect API is the source of truth, and we generate an OpenAPI v3 spec straight from it. That spec is the public contract. The CLI reads from it, your scripts read from it, your agent reads from it. One description of reality instead of a doc that goes stale the second someone ships.\n\nOn top of that, the stuff that used to be dashboard-only now lives everywhere you work:\n\n- See your recent runs and workflows, and dig into any run, workflow, job, or attempt.\n- Pull logs by ID, tail them live, or export them in bulk.\n- Kick off a workflow, grab a single run, or cancel an entire run in one call.\n- Get the derived stuff too: AI run summaries, step summaries, run and job metrics, the artifact list.\n- Manage your secrets and variables through the same commands.\n\nSame nouns, same flags, whether you type it or call it.\n\n## My fav: `depot ci diagnose`\n\nMy favorite thing in here is `diagnose`\n\n. It does the part of CI debugging I dislike the most, which is figuring out what even went wrong before I can start fixing it.\n\nPoint it at whatever ID you've got:\n\n```\ndepot ci diagnose --run <run-id>\ndepot ci diagnose --workflow <workflow-id>\ndepot ci diagnose --job <job-id>\ndepot ci diagnose --attempt <attempt-id>\n```\n\nInstead of dumping logs on you, it tells you what it thinks broke. The failed step. The error lines that matter. And a real read on what went wrong and what to do about it. Not \"here's the wreckage, good luck.\" More like \"this is the thing, here's the likely cause, here's your next move.\"\n\nA few things I like about it:\n\nIt collapses big matrix failures. If 7 cells died, you get \"showing 3 of 7 similar attempts\" instead of seven near-identical walls of text.\n\nIt hands you the exact commands to go deeper. Want the logs? It gives you the command. Want the step summary? Same. Want to open it in the browser anyway? There's the URL.\n\nIt doesn't fire-hose you. No dumping thousands of jobs or full logs by default. If there's more to see, it tells you how to narrow.\n\nI love letting the agent run with it. \"CI is red, go figure out why\" used to be something I had to do by hand, because the agent couldn't see the runner. Now `diagnose`\n\ngives it (and me) a straight answer to start from.\n\n## Getting started\n\nIf you've got the Depot CLI, you already have this. Update to the latest version and go:\n\n```\ndepot ci run list\ndepot ci workflow list\ndepot ci diagnose --run <run-id>\n```\n\nIt's all available over the API too, using the OpenAPI v3 spec as the contract, so you can wire it into scripts or hand it to an agent.\n\nFor details, check out the Depot CI [API reference](/docs/api/ci/reference) and [CLI reference](/docs/cli/reference/depot-ci).\n\n## What it costs\n\nNothing new. The API and CLI use the same usage-based [pricing](/pricing) Depot already has, which is all public on our pricing page. If a call spins up compute, like running a workflow, you pay for that compute the same as you always did. Listing your runs, diagnosing a failure, hitting the API itself, none of that adds a separate charge. There's no API tax.\n\n## What's next\n\nWe're shipping new Depot CI stuff fast right now, and the entire point of this project was to stop letting the API and CLI fall behind the dashboard. So as we add things, expect them to land in the API and CLI right next to the dashboard. Anyway, update your CLI, and next time something goes red, try pointing `diagnose`\n\nat it instead of opening the dashboard. Or don't even do that yourself. Ask your agent to.\n\n## Related posts\n\n[Now available: Depot CI](/blog/now-available-depot-ci)[What we need from CI for agentic engineering](/blog/ci-for-agentic-engineering)[Now available: Sherlock can analyze Depot CI workflows and jobs](/blog/now-available-sherlock-depot-ci-analysis)", "url": "https://wpnews.pro/news/show-hn-depot-ci-api-programmable-ci", "canonical_source": "https://depot.dev/blog/now-available-depot-ci-api", "published_at": "2026-06-04 14:32:42+00:00", "updated_at": "2026-06-04 14:50:01.492131+00:00", "lang": "en", "topics": ["ai-tools", "ai-infrastructure", "ai-agents", "ai-products", "mlops"], "entities": ["Depot", "Depot CI", "Depot CI API", "Depot CI CLI"], "alternates": {"html": "https://wpnews.pro/news/show-hn-depot-ci-api-programmable-ci", "markdown": "https://wpnews.pro/news/show-hn-depot-ci-api-programmable-ci.md", "text": "https://wpnews.pro/news/show-hn-depot-ci-api-programmable-ci.txt", "jsonld": "https://wpnews.pro/news/show-hn-depot-ci-api-programmable-ci.jsonld"}}