my-ci
Run local CI/CD workflows over Docker, Podman, or Apple container on macOS.
Demo
Then open http://127.0.0.1:7878, click Run, and watch the pipeline execute in realtime.
Install
Quickstart
Commands
| Command | Args | Description |
|---|---|---|
init |
[PATH] (default my-ci), --force |
Scaffold the embedded template into PATH. Skips existing unless force. |
build |
[WORKFLOW] |
Build one workflow + deps, or all workflows when omitted. |
run |
[WORKFLOW] |
Build deps, then run workflows that have a command. All when omitted. |
list |
— | Print workflow names from config. |
Global:
-c, --config <PATH>(defaultmy-ci/workflows.toml)--runtime <auto|docker|podman|apple-container>(defaultauto)
On macOS, auto uses the container CLI when it is installed and its service is running. Otherwise it falls back to a Docker socket, then a Podman socket. To force Apple's runtime, run:
Apple container requires the container CLI and its system service. Start it with:
The GUI exposes the same runtime choices for build/run requests. The Apple container option is shown only when the browser reports a macOS platform.
Debugging
my-ci emits structured traces to stderr. The default filter enables app-level info traces. Override it with RUST_LOG when you need more or less detail:
RUST_LOG=my_ci=trace
RUST_LOG=my_ci=debug,bollard=warn
workflows.toml schema
= "string" # project name; used as image prefix (default "my-ci")
= "path" # optional; loaded via dotenvy before run, relative to config
[[]]
= "string" # required; unique
= "path" # build context; default "."
= "string" # inline Containerfile OR path ending in .Containerfile
= "string" # optional override; default "{name}:{workflow.name}"
= ["string"] # build order; topologically sorted
= ["KEY=VALUE"] # container env at run time
= ["argv"] # required to run; build-only if omitted
Dependencies build in topological order. A workflow without command is build-only and is skipped by run.