Skip to content

rai release

Release management commands. Run quality gates, bump versions, generate changelogs, and publish releases.

List releases from the knowledge graph. Shows all release nodes with status, target date, and associated epics.

FlagShortDescription
--project-pProject root path. Default: .
Terminal window
rai release list

Run all quality gates before publishing. Runs 10 checks: tests, types, lint, security, coverage, build, package validation, changelog, PEP 440 version, and version sync.

FlagShortDescription
--project-pProject root path. Default: .
Terminal window
rai release check

Exit codes: 0 all pass, 1 any fail.


Orchestrate a full release: check → bump → changelog → commit → tag → push. Either --bump or --version is required.

FlagShortDescription
--bump-bVersion bump type: major, minor, patch, alpha, beta, rc, release
--version-vExplicit version (overrides --bump)
--dry-runShow what would happen without executing
--skip-checkSkip quality gates (dangerous)
--project-pProject root path. Default: .
Terminal window
# Alpha release
rai release publish --bump alpha
# Minor release (dry run)
rai release publish --bump minor --dry-run
# Explicit version
rai release publish --version 2.1.0

See also: rai gate check