Skip to main content
Generated from bd help --doc migrate. Database migration and data transformation commands. Without subcommand, checks and updates database metadata to current version. Subcommands: hooks Plan git hook migration to marker-managed format issues Move issues between repositories schema Apply pending schema migrations (idempotent) sync Set up sync.branch workflow for multi-clone setups
Flags:

bd migrate hooks

Analyze git hook files and sidecar artifacts for migration to marker-managed format. Modes: —dry-run Preview migration operations without changing files —apply Apply migration operations Examples: bd migrate hooks —dry-run bd migrate hooks —apply bd migrate hooks —apply —yes bd migrate hooks —dry-run —json
Flags:

bd migrate issues

Move issues from one source repository to another with filtering and dependency preservation. This command updates the source_repo field for selected issues, allowing you to:
  • Move contributor planning issues to upstream repository
  • Reorganize issues across multi-phase repositories
  • Consolidate issues from multiple repos
Examples:

Preview migration from planning repo to current repo

bd migrate-issues —from ~/.beads-planning —to . —dry-run

Move all open P1 bugs

bd migrate-issues —from ~/repo1 —to ~/repo2 —priority 1 —type bug —status open

Move specific issues with their dependencies

bd migrate-issues —from . —to ~/archive —id bd-abc —id bd-xyz —include closure

Move issues with label filter

bd migrate-issues —from . —to ~/feature-work —label frontend —label urgent
Flags:

bd migrate schema

Apply pending schema migrations idempotently. Schema migrations also run automatically on store open, so this subcommand is typically a no-op. It exists to make migration explicit and observable in CI, release gates, and recovery scenarios. Example: bd migrate schema bd migrate schema —json
Flags:

bd migrate sync

Configure separate branch workflow for multi-clone setups. This sets the sync.branch config value so that issue data is committed to a dedicated branch, keeping your main branch clean. Example: bd migrate sync beads-sync
Flags: