Documentation

What is OpenCI?

OpenCI is a workflow installer for GitHub Actions. It lets you browse a catalog of production workflows from real repos and install them into your own project with a single command.

Getting started

Install a workflow from any GitHub repository:

This downloads the workflow file into .github/workflows/ and records sidecar metadata in .github/workflows/.openci/ for later updates.

How it works

OpenCI reads workflow files directly from GitHub repositories. When you run openci add, it fetches the specified workflow from the source repo, writes it into your project, and saves metadata so you can update or remove it later.

There are no proprietary templates or hosted registries. Every workflow you install comes from a real .github/workflows/ directory in an actual repository.

The catalog

The homepage lists workflows from the hosted catalog and ranks them by actual usage. Search by what you need, then copy the install command for a workflow that fits.

Managing installed workflows

After installing workflows, use openci list to see what you have, openci status to check for drift, and openci update to pull the latest version from the source repo.