uvr

Appearance

uvr

Release management for uv workspaces.

Get Started
Go Under the Hood

🏗️ Scaffold

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

⬆️ Bump

uvr bump
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.

bash
uv add --dev uv-release
uvr workflow init
uvr release
Packages
--------
  STATUS     PACKAGE  VERSION      PREVIOUS  CHANGES  COMMITS
  changed    auth     0.2.0.dev0   0.1.0     3        2
  changed    api      0.1.1.dev0   0.1.0     1        1
  unchanged  cli      1.0.0        1.0.0     -        -

Pipeline
--------
  run   uvr-build
          [ubuntu-latest]
            layer 0
              auth  0.2.0
            layer 1
              api   0.1.1
  run   uvr-release
          auth/v0.2.0
          api/v0.1.1
  run   uvr-publish
          auth → pypi
          api  → pypi
  run   uvr-bump
          auth → 0.2.1.dev0
          api  → 0.1.2.dev0

Dispatch release? [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.