Run local CI/CD workflows over Docker, Podman, or Apple container on macOS.

git clone https://github.com/geoffsee/my-ci.git
cd my-ci
docker compose up

Then open http://127.0.0.1:7878, click Run, and watch the pipeline execute in realtime.

cargo binstall my-ci

my-ci init        # scaffold ./my-ci
my-ci run         # build + run the pipeline

Global:

• -c, --config <PATH> (default my-ci/workflows.toml)
• --runtime <auto|docker|podman|apple-container> (default auto)

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:

my-ci --runtime apple-container run

Apple container requires the container CLI and its system service. Start it with:

container system start

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.

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 my-ci run
RUST_LOG=my_ci=debug,bollard=warn my-ci --runtime docker build

name          = "string"          # project name; used as image prefix (default "my-ci")
env_file      = "path"             # optional; loaded via dotenvy before run, relative to config
artifacts_dir = "path"             # optional; base directory for captured outputs (default "artifacts", relative to config)

[[workflow]]
name           = "string"        # required; unique
context        = "path"          # build context; default "."
instructions   = "string"        # inline Containerfile OR path ending in .Containerfile
image          = "string"        # optional override; default "{name}:{workflow.name}"
depends_on     = ["string"]      # build order; topologically sorted
env            = ["KEY=VALUE"]   # container env at run time
command        = ["argv"]        # required to run; build-only if omitted
artifacts      = ["/out/report.txt"]  # optional; paths inside the container to copy after success (Docker/Podman)
artifact_bind  = "/artifacts"    # optional; bind-mount `{artifacts_dir}/{workflow}` at this path (all runtimes)

After a successful run, each path in artifacts is unpacked under {artifacts_dir}/{workflow}/… (one subdirectory per path, derived from the container path). With artifact_bind, writing files under that mount path lands directly on the host, which also works with Apple container.

Dependencies build in topological order. A workflow without command is build-only and is skipped by run.