# Show HN: MigraDiff v1.3.0 – PostgreSQL schema diff with AI migration explanation

> Source: <https://github.com/migradiff/migra/releases/tag/v1.3.0>
> Published: 2026-05-30 16:34:22+00:00

# v1.3.0 — AI-Powered Migration Explanation & Migrations Folder Support

[Latest](/migradiff/migra/releases/latest)

## 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](https://github.com/migradiff/migra/blob/main/CHANGELOG.md)

## Upgrading

```
pip install --upgrade migradiff
```