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 popular open-source repositories. Browse by category (code review, issue automation, security, etc.) or filter by AI provider (Claude, Codex, Gemini). Each entry links to the source file on GitHub.

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.