CLICommands
spec0 ci generate
Generate a workflow file for <provider> that runs 'spec0 publish' on push.
Auto-generated from
spec0 commands --output=json. Do not edit by hand — changes are overwritten bynpm run sync:cli-docs.
Usage
spec0 ci generate <provider> [options]Arguments
| name | required | description |
|---|---|---|
provider | yes | CI provider (currently supported: github) |
Flags
| flag | description | default |
|---|---|---|
--spec-file <path> | Path to OpenAPI spec file | openapi.yaml |
--api-name <name> | API name to embed in the workflow (default: spec filename) | |
--branch <branch> | Git branch that triggers the workflow | main |
--write | Write the workflow to its suggested path (default: print to stdout) | |
--org <uuid> | Org id override | |
--output <format> | Output format for metadata: text, json, yaml (default: text) |
Exit codes
Stable contract — branch on these from CI and agents.
| code | meaning |
|---|---|
| 0 | success |
| 1 | generic / unclassified failure |
| 2 | usage error (bad flags, missing args) |
| 3 | not authenticated (no token / token expired) |
| 4 | permission denied (403) |
| 5 | resource not found (404) |
| 6 | conflict (409 — e.g. name already taken) |
| 7 | validation failed (422 — e.g. spec below min score) |
| 8 | rate limited (429) |
| 9 | upstream server error (5xx) |
| 10 | network error (unreachable, timeout) |