On this page
Release orchestration command group with 6 subcommands: run, init, retry, edit, undo, and yank for managing the full release lifecycle.
#rlsbl release
Release orchestration commands.
#release run
Bump version, validate the JSONL changelog, run tests and lint, commit, tag, push, and create a GitHub Release. Reads the bump type (patch, minor, or major) and target selection from .rlsbl/releases/unreleased.toml, which can be scaffolded with rlsbl release init. Supports dry-run preview, non-interactive mode with --yes, and --allow-dirty to skip the clean working tree check.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--allow-dirty | bool | Allow releasing with a dirty working tree | |||
--watch | bool | After release, automatically watch CI runs to completion | |||
--no-watch | bool | After release, print the watch command hint without watching |
#release init
Scaffold a .rlsbl/releases/unreleased.toml file by auto-detecting project targets. The generated file contains a default bump type (patch), an include list of all detected targets, and per-target configuration sections for Flutter targets.
#release retry
Re-create a GitHub Release to re-trigger CI/CD workflows. Reads configuration from .rlsbl/releases/retry.toml (auto-scaffolded if missing). Deletes the existing release and re-creates it with the same changelog notes, firing a new release:published event. Re-uploads assets if configured. Falls back to gh workflow run if no CI runs appear.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--watch | bool | After retry, automatically watch CI runs to completion | |||
--no-watch | bool | After retry, print the watch command hint without watching |
#release edit
Sync the GitHub Release notes for a given version with the corresponding CHANGELOG.md entry. Defaults to the current version if none is specified. Use --dry-run to preview changes without updating GitHub.
#Arguments
| Name | Required | Description |
|---|---|---|
version | no | Version to update (defaults to current) |
#release undo
Revert the most recent release by deleting the GitHub Release, removing the git tag from local and remote, and reverting the version bump commit. Requires a manual git push afterward to finalize.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--target | str | Target a specific registry |
#release yank
Mark a past release as deprecated (soft yank) or delete it (hard yank). Soft yank marks the GitHub Release as pre-release and prepends a deprecation notice. Hard yank deletes the release entirely while preserving the git tag.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--reason | str | Why the version is being yanked | |||
--use | str | Replacement version to recommend | |||
--hard | bool | Delete the release instead of marking as pre-release |
#Arguments
| Name | Required | Description |
|---|---|---|
version | yes | Version to yank (e.g. 0.9.1 or v0.9.1) |