nself release-rollback

Undo a release that landed buggy. Reverts the git tag, demotes the GitHub Release from "Latest", and notifies the homebrew tap to pin to the previous version.

Quick start

# Roll back a bad release
nself release-rollback v1.0.14

# Preview what would happen without executing
nself release-rollback v1.0.14 --dry-run

Synopsis

nself release-rollback <VERSION> [FLAGS]

Description

nself release-rollback undoes the effects of a nself release run for the given version. It takes three actions:

1. Reverts the git tag. Deletes the tag locally and from the remote (git tag -d {VERSION} + git push origin :refs/tags/{VERSION}). The underlying commits are not touched.
2. Demotes the GitHub Release from "Latest". Marks the release as a pre-release so it no longer appears as the default install target. The release page and binaries remain accessible for users who installed it and need to file bug reports.
3. Notifies homebrew-nself. Opens a PR on the homebrew tap that pins the formula back to the previous stable version. Does not merge automatically — maintainers review and merge.

Rollback requires ANTHROPIC_RELEASE_KEY for the same reason as nself release — it authorizes write operations on the release infrastructure.

Rollback does not revert commits or force-push to main. Code fixes should land as a new patch release after the rollback is confirmed.

Arguments

Flags

Environment variables

• ANTHROPIC_RELEASE_KEY — Required. Same key used by nself release.
• GITHUB_TOKEN — Used to delete the tag and update the GitHub Release. Falls back to ~/.nself/auth.json.

Examples

Standard rollback

nself release-rollback v1.0.14
# Deletes tag v1.0.14
# Demotes GitHub Release from Latest
# Opens homebrew PR pinning to v1.0.13

Rollback without touching homebrew

nself release-rollback v1.0.14 --no-homebrew

Dry-run to preview impact

nself release-rollback v1.0.14 --dry-run

After rollback

Once the rollback is confirmed via nself release-status, fix the bug on a branch, land the fix on main, and ship a new patch release:

# After the fix lands on main
nself release-check
nself release v1.0.15

Exit codes

• 0 — rollback completed
• 1 — rollback failed mid-way (see output for which step)
• 2 — invalid version argument or tag does not exist
• 3 — ANTHROPIC_RELEASE_KEY not set or invalid

Related

• nself release — ship a new release after fixing the bug
• nself release-status — confirm the rollback took effect
• nself release-check — validate readiness before the next release