MigraDiff

v1.3.0 Feature

This release adds 3 notable features for engineering teams evaluating rollout.

Published 4d Relational Databases

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Summary

AI summary

Updates What's New, Also in this release, and Anthropic across a mixed release.

Changes in this release

Type	Severity	Summary	CVE
Feature	Medium	Adds AI-powered migration explanation (--explain) using Claude Haiku. Adds AI-powered migration explanation (--explain) using Claude Haiku. Source: llm_adapter@2026-06-02 Confidence: high	—
Feature	Medium	Adds migrations folder input mode (--from-migrations-dir). Adds migrations folder input mode (--from-migrations-dir). Source: llm_adapter@2026-06-02 Confidence: high	—
Bugfix	Low	Clarifies naming in README; CLI remains `migra` for backward compatibility. Clarifies naming in README; CLI remains `migra` for backward compatibility. Source: llm_adapter@2026-06-02 Confidence: high	—

Full changelog

Install

pip install --upgrade migradiff

What's New

AI-Powered Migration Explanation (--explain)

MigraDiff can now explain any migration in plain English — what
each change does, what risks it carries, and safer alternatives
for destructive operations.

pip install migradiff[ai]
migra --setup-ai
migra --explain postgres://db_a postgres://db_b

Powered by Claude Haiku (Anthropic). Bring your own API key —
no data is sent to MigraDiff servers. Works with --output json,
--from-file, --from-migrations-dir, and all existing flags.

Migrations Folder Input Mode (--from-migrations-dir)

Diff a directory of numbered migration files against a base
schema without requiring a live branch database.

migra --from-migrations-dir ./supabase/migrations \
  postgres://db_production

Supports Supabase timestamp format, Flyway versioned format,
and standard numeric prefixes. Files applied in correct numeric
sort order (9 before 10, not lexicographic).

Also in this release

Naming clarification in README — CLI stays migra for backward
compatibility, package is migradiff

Full changelog: https://github.com/migradiff/migra/blob/main/CHANGELOG.md

Upgrading

pip install --upgrade migradiff

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track MigraDiff

Get notified when new releases ship.

About MigraDiff

All releases →

Related context

Related tools

Earlier breaking changes

v1.1.0 Requires uninstalling original migra before installing migradiff