uvr

Appearance

uvr

Release management for uv workspaces.

Get Started
Go Under the Hood

Scaffold

uvr workflow install
Generate a complete release workflow in one command. Runner matrices, PyPI publishing, and hooks built in.

Version

uvr version
Bump versions without breaking internal dependencies. Downstream pins update automatically.

Release

uvr release
Release with confidence. Catch errors before dispatch, only rebuild what changed, and recover from failures without starting over.

Claude

/release
Ship interactively. Claude handles branching, release notes, dispatch, and failure recovery.

Quick Start ​

You have a uv workspace with three packages. auth is a leaf. api depends on it. cli hasn't changed.

Install uvr as a dev dependency.

bash
uv add --dev uv-release

Scaffold the release workflow.

bash
uvr workflow install

Plan, confirm, and dispatch.

bash
uvr release
Packages
--------
PACKAGE    RELEASE    NEXT
auth       0.2.0      0.2.1.dev0
api        0.1.1      0.1.2.dev0

Pipeline
--------
  validate
  check
  build
  release
  publish
  bump

Proceed? [y/N]

Change detection, topological build ordering, GitHub releases, PyPI publishing, and version bumping. All planned locally before anything touches CI. See the setup guide for the full walkthrough.