Actio

Quickstart

Scaffold, compile, and drift-check your first .actio.yml source.

Scaffold a starter source file

npx actio-cli init ci.actio.yml

Compile to workflows

Turns *.actio.yml into .github/workflows/*.yml.

npx actio-cli build

Drift-check in CI

Fails if the generated output is stale.

npx actio-cli check

Keep sources in .github/actio/ and compile them into .github/workflows/ — the only directory GitHub reads. Sources can live anywhere and still get picked up, so this is just convention. Treat .github/workflows/ as your dist:

ci.actio.yml
actio.config.ts
ci.yml

actio/ holds your hand-written source; the highlighted workflows/ holds the generated YAML — the only thing GitHub runs. Commit both.

Commit the generated .yml. GitHub runs what's in .github/workflows/, and actio check keeps them in sync with your sources in CI.

Installation

Install the Actio CLI.

Syntax reference

Every .actio.yml macro keyword — scope, type, options, and what it compiles to.

On this page

Scaffold a starter source fileCompile to workflowsDrift-check in CIRecommended layout