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 ismigradiff
Full changelog: https://github.com/migradiff/migra/blob/main/CHANGELOG.md
Upgrading #
pip install --upgrade migradiff