Generate and prove
diff
Generate a replay-safe migration from two schema sources.
stage
Git-stage changed generated migration files.
apply
Apply already-generated pending migrations.
check
Validate migration SQL for replay safety and hazards.
verify
Apply a migration twice in disposable databases.
types
Generate TypeScript and Zod outputs from schema files.
scan
Score RLS, grant, hygiene, and generated-contract usage findings without a
database.
type-contract
Gate breaking generated TypeScript/Zod contract changes.
Operate
migrations
Reconcile files on disk with applied database history.
sync
Run the full diff, check, types, stage, apply, and reconcile workflow.
config validate
Check config paths, sources, and credential references.
contracts
Export and diff cross-repository schema contracts locally.
Inspect
plan
Print the object-level diff plan as JSON.
inspect
Print the extracted schema model as JSON.
fingerprint
Print the canonical equality hash for a source.
audit
Report modeled and unsupported schema coverage.
Utilities
corpus
Run the dirty-real regression oracle.
doctor
Diagnose local setup and database capability.
onboard
Detect incumbent migration tooling and print ordered remediation.
init
Scaffold or repair the project setup bundle.
explain
Decode a
SUPA_* diagnostic code offline.Shell and engine
completion
Print shell completion scripts for bash, zsh, or fish.
selfcheck
Compare live-catalog extraction with engine representation.
Defaults
When you omit flags, supaschema readssupaschema.config.json.
Global flags
path
Use an explicit JSON config file instead of
supaschema.config.json.string
Read the database URL from a named
environments entry in config.boolean
Suppress non-essential diagnostic output.