Depot CI

Depot CI is a programmable CI system for engineers and agents. Workflows in Depot CI run entirely on Depot compute with built-in job visibility, debuggability, and control. GitHub Actions is the first syntax Depot CI supports: migrate your existing GitHub Actions workflows, and get fast, reliable runs on optimized infrastructure.

This SKILL.md covers the core workflow plus the most common commands. Detailed flag tables, JSON output shapes, and less-common commands live in three reference files under references/, pointed to from the relevant sections below. Load a reference file only when you need detail it points to.

Architecture

Three subsystems: compute (provisions and executes work), orchestrator (schedules multi-step workflows, handles dependencies), GitHub Actions parser (translates Actions YAML into orchestrator workflows). The system is fully programmable.

Common flags

Nearly every depot ci command (and depot tests) accepts:

• --org <id>: organization ID, required when the user belongs to multiple organizations (see Org Context Check below).
• --token <token>: Depot API token.
• -o, --output json: machine-readable output, useful for agents and scripting.

Per-command tables in the reference files omit these to cut noise; assume they're available.