versionx release
Release orchestration subcommands (plan/apply, publish, snapshots)
Subcommands
propose
Compute a release plan without executing it
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
--strategy | <STRATEGY> | conventional | Strategy: conventional (default), pr-title, manual | ||
--pr-title | <PR_TITLE> | Override PR title (otherwise harvested from git) |
show
Show a single plan by id
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
plan_id | <PLAN_ID> | yes |
list
List every plan under .versionx/plans/
approve
Approve a previously-proposed plan by id
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
plan_id | <PLAN_ID> | yes |
apply
Apply an approved release plan (local-only — push is a future flag)
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
plan_id | <PLAN_ID> | yes | Plan id to apply | ||
--allow-dirty | <ALLOW_DIRTY> | Allow applying even when the working tree has unrelated changes. Possible values: true, false. |
snapshot
Cut a snapshot release — uses a CalVer-style version derived from the current timestamp. Useful for nightly/canary cuts
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
--prefix | <PREFIX> | snapshot | Override the snapshot tag prefix (default: snapshot) |
rollback
Roll back a previously-applied release by reverting its commit + deleting its tag(s). Conservative: never force-pushes
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
plan_id | <PLAN_ID> | yes | Plan id whose apply you want to undo |
prerelease
Cut a prerelease (-rc.N, -alpha.N, -beta.N)
Flags
| Flag | Value | Default | Required | Global | Description |
|---|---|---|---|---|---|
plan_id | <PLAN_ID> | yes | Plan id (must be approved) | ||
--channel | <CHANNEL> | rc | Prerelease channel: rc, alpha, beta |