Skip to main content
Use stage after diff writes a generated migration and before you commit the migration. stage inspects the configured migrations directory, finds changed .sql files containing the -- supaschema: lineage marker, and runs git add on those files only. Hand-authored SQL is left unstaged.

​
Run it

​
Flags

​
path
Migration files directory. Defaults to config.migrationsDir.
​
boolean
Print generated migration files that would be staged without changing the git index.

​
Refusal cases

stage requires a git worktree. It stages generated migration files only; it does not stage schema files, generated TypeScript/Zod outputs, hand-authored SQL, config, docs, or unrelated changes.

Diff

Generate the migration first.

Check

Validate replay safety before apply.
Last modified on June 21, 2026