django-sync-migrations 0.3.0

Sync Django migrations to match the dev branch, then checkout dev.

django-sync-migrations

From a feature branch, sync Django migrations to match the dev branch, then checkout dev. Use when on a feature branch with migrations you want to discard before switching back to dev.

A time saver when you are doing a lot of reviews of Django code and find yourself undoing feature branch migrations to match the base branch before you switch back to it.

Install

From your Django project:

pip install django-sync-migrations

Or without installing (requires uv):

uvx django-sync-migrations

Run

From your Django project directory (the one with manage.py):

django-sync-migrations              # reset migrations to dev, then checkout dev
django-sync-migrations --dry-run   # show what would be done
django-sync-migrations --branch develop
django-sync-migrations --skip-checkout   # only reset migrations, don’t checkout

Resequence after rebase (-r)

When you rebase your feature branch onto dev, migrations from dev can leave your feature's migrations with conflicting or "behind" numbering, which would require a merge migration later. Use -r to detect migrations that exist only on your branch (not on dev), then optionally delete them and run makemigrations so new migrations get numbers that follow dev.

Default is dry-run (no files changed). Use --apply to delete and run makemigrations; you'll be prompted to confirm unless you pass --yes.

django-sync-migrations -r                    # dry-run: list feature-only migrations
django-sync-migrations -r --apply            # delete them and run makemigrations (prompt)
django-sync-migrations -r --apply --yes      # apply without confirmation
django-sync-migrations -r -b main            # compare against main instead of dev

Requires a Django project (with manage.py), git, and a reachable database. The tool runs manage.py migrate using your project’s Python.