Sweep 65 markdown files across docs/, website/, claude-plugin/, examples/, integrations/, and root to replace removed `bd daemon` references with current Dolt server mode equivalents. CHANGELOG.md preserved per policy. Key replacements: - `bd daemon start/stop/status` → `bd dolt start/stop` / `bd doctor` - `bd daemons killall/health/logs` → `bd dolt stop` / `bd doctor` - `--no-daemon` flag → removed (embedded mode is default) - `BEADS_NO_DAEMON` / `BEADS_DAEMON_MODE` env vars → removed - `.beads/bd.sock` → removed - "daemon mode" / "direct mode" → "server mode" / "embedded mode" - daemon.pid/daemon.log → .beads/dolt/sql-server.pid/.log Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Executed-By: beads/polecats/topaz Rig: beads Role: polecats
3.8 KiB
3.8 KiB
| id | title | sidebar_position |
|---|---|---|
| sync | Sync & Export | 6 |
Sync & Export Commands
Commands for synchronizing with git.
bd sync
Full sync cycle: export, commit, push.
bd sync [flags]
What it does:
- Exports database to
.beads/issues.jsonl - Stages the JSONL file
- Commits with auto-generated message
- Pushes to remote
Flags:
--json JSON output
--dry-run Preview without changes
Examples:
bd sync
bd sync --json
When to use:
- End of work session
- Before switching branches
- After significant changes
bd export
Export database to JSONL.
bd export [flags]
Flags:
--output, -o Output file (default: .beads/issues.jsonl)
--dry-run Preview without writing
--json JSON output
Examples:
bd export
bd export -o backup.jsonl
bd export --dry-run
bd import
Import from JSONL file.
bd import -i <file> [flags]
Flags:
--input, -i Input file (required)
--dry-run Preview without changes
--orphan-handling How to handle missing parents
--dedupe-after Run duplicate detection after import
--json JSON output
Orphan handling modes:
| Mode | Behavior |
|---|---|
allow |
Import orphans without validation (default) |
resurrect |
Restore deleted parents as tombstones |
skip |
Skip orphaned children with warning |
strict |
Fail if parent missing |
Examples:
bd import -i .beads/issues.jsonl
bd import -i backup.jsonl --dry-run
bd import -i issues.jsonl --orphan-handling resurrect
bd import -i issues.jsonl --dedupe-after --json
bd migrate
Migrate database schema.
bd migrate [flags]
Flags:
--inspect Show migration plan (for agents)
--dry-run Preview without changes
--cleanup Remove old files after migration
--yes Skip confirmation
--json JSON output
Examples:
bd migrate --inspect --json
bd migrate --dry-run
bd migrate
bd migrate --cleanup --yes
bd hooks
Manage git hooks.
bd hooks <subcommand> [flags]
Subcommands:
| Command | Description |
|---|---|
install |
Install git hooks |
uninstall |
Remove git hooks |
status |
Check hook status |
Examples:
bd hooks install
bd hooks status
bd hooks uninstall
Auto-Sync Behavior
With Dolt Server Mode (Default)
When the Dolt server is running, sync is handled automatically:
- Dolt auto-commit tracks changes
- JSONL export happens after changes (5s debounce)
- Imports from JSONL when newer
Start the Dolt server with bd dolt start.
Embedded Mode (No Server)
In CI/CD pipelines and ephemeral environments, no server is needed:
- Changes written directly to the database
- Must manually export/sync
bd create "CI-generated task"
bd export # Manual export needed
Conflict Resolution
Merge Driver (Recommended)
Install the beads merge driver:
bd init # Prompts for merge driver setup
The driver automatically:
- Merges non-conflicting changes
- Preserves both sides for real conflicts
- Uses latest timestamp for same-issue edits
Manual Resolution
# After merge conflict
git checkout --ours .beads/issues.jsonl
bd import -i .beads/issues.jsonl
bd sync
Deletion Tracking
Deletions sync via .beads/deletions.jsonl:
# Delete issue
bd delete bd-42
# View deletions
bd deleted
bd deleted --since=30d
# Deletions propagate via git
git pull # Imports deletions from remote
Best Practices
- Always sync at session end -
bd sync - Install git hooks -
bd hooks install - Use merge driver - Avoids manual conflict resolution
- Check sync status -
bd infoshows sync state