Get started

Continuous integration

Inspect, enable, refresh, or remove optional CI workflows.

6 min readUpdated 3 days agoEdit on GitHub

Continuous integration is opt-in. one create and one add do not generate workflow files. The current build supports GitHub Actions.

Usage

one ci
one ci enable [project]
one ci sync [project]
one ci disable [project]

one ci is read-only and shows each project's current state and the most useful next command.

Commands

CommandBehavior
one ciShow CI status for all projects
one ci enable webGenerate the canonical workflow for web
one ci enableEnable CI for every project
one ci sync webRegenerate web when CI is already enabled
one ci syncRegenerate every workflow that already exists
one ci disable webRemove web's generated workflow after confirmation
one ci disable --yesRemove all generated workflows without prompting

Refusing the disable confirmation or pressing Ctrl-C is a normal cancellation: the command exits successfully and does not modify files.

Files and workspace state

For GitHub Actions, One CLI writes one canonical file per project under .github/workflows/. CI selection is not written to one.manifest.json; the generated file is the state. enable, sync, and disable therefore leave the manifest unchanged.

Automation

one ci -o json
one ci enable web --provider ci/github-actions -o json
one ci sync --project web -o json
one ci disable web --yes -o json

Stable schemas are one-cli/ci-status/v1, one-cli/ci-enable/v1, one-cli/ci-sync/v1, and one-cli/ci-disable/v1. The provider ID and JSON field names remain stable and are not translated. --project is retained for older scripts; everyday help prefers the positional project.

Errors

CodeRecovery
CI_NOT_ENABLEDRun one ci enable <project>, then retry sync
CI_PROVIDER_UNKNOWNUse an ID from error.context.available_providers
CI_RENDER_FAILEDInspect the project and workflow path in the error context

See Error codes for the stable error envelope.