Commands

CommandDescription
revector initCreate migrations/ and a starter revector.toml.
revector new <name>Scaffold a new migration chained onto the current head.
revector statusShow applied vs pending revisions, checksums, and reversibility.
revector up [--to <rev>] [--dry-run]Apply pending migrations.
revector down [--to <rev>] [--steps N] [--dry-run]Roll back migrations (default: 1 step).
revector to <rev> [--dry-run]Migrate to an exact revision (up or down).
revector validateParse all migrations and resolve the chain offline — no Qdrant connection. Good as a CI / pre-commit check.
revector stamp <rev|head|base> [--dry-run]Mark the DB as being at a revision without running any ops — for adopting an existing collection (Alembic's stamp).
revector diff <collection> --spec <file.yaml>Compare a declared collection spec against the live collection.

--dry-run prints the plan without touching Qdrant.

Global flags

These flags work on every subcommand:

FlagEnvDescription
--config <FILE>Path to a revector.toml (default: ./revector.toml).
--url <URL>REVECTOR_URLQdrant gRPC URL.
--api-key <KEY>REVECTOR_API_KEYQdrant API key.
--migrations-dir <DIR>Migrations directory.
-v, -vvIncrease log verbosity (debug, trace).
-y, --yesSkip confirmation prompts (required in non-interactive shells for rollbacks).
--forceOverride a held or stale migration lock.

Set REVECTOR_LOG=revector=debug for verbose logging (equivalent to -v).