On this page
Release lifecycle commands: bump and publish versions, scaffold release files, retry CI, sync release notes, undo, and yank past releases.
#rlsbl release
Release orchestration commands. Provides 6 subcommands covering the full release lifecycle: run, init, retry, edit, undo, and yank.
#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
Dispatch CI/CD workflows for a completed release via gh workflow run. Reads the dispatch list and ref from .rlsbl/releases/retry.toml, which is auto-scaffolded with sensible defaults if missing. Verifies the GitHub Release exists before dispatching. Each workflow in the dispatch list is triggered against the configured ref (defaults to the release tag).
#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) |