CommandsMigrate
migrate from-sqlitevss
Convert sqlite-vss export data into the canonical zvec layout
What It Does
migrate from-sqlitevss reads exported sqlite-vss records and converts them into the canonical document, chunk, and snapshot layout used by current RAGit.
When To Use / When Not To Use
When to use it
- You have one of the supported sqlite-vss export files in the repository.
- You are upgrading from an older vector-storage experiment to the current layout.
When not to use it
- Your legacy source is the JSON store instead. Use
migrate from-json-store. - The repository already uses the current canonical store.
Syntax
pnpm ragit migrate from-sqlitevss [--dry-run] [--cwd <path>]
Arguments And Options
--dry-run: Count convertible docs and chunks without writing.--cwd <path>: Run against another repository.
Input And Output Contract
- Input is flag-based only.
- Output is a raw JSON object with
mode,docs,chunks, and optionalsnapshotSha. --dry-runis the right default for agent automation.
Examples
Human terminal flow:
pnpm ragit migrate from-sqlitevss --dry-run
Agent-oriented flow:
pnpm ragit migrate from-sqlitevss --dry-run
Failures And Cautions
- The command fails if no supported sqlite-vss export file can be found.
- Like the JSON-store migration, this is a mutating command even though its output is raw JSON.