bjorn.now
Björn Andersson
1 min read

Beads with dolt store data in git refs, not branches, and won’t share it anywhere until you manually configure a remote.

After bd init, your dolt data only exists locally. You can check with bd dolt remote list which will show “No remotes configured.”

Point it at your existing git repo:

bd dolt remote add origin git+ssh://[email protected]/you/repo.git

Then push and verify:

bd dolt push
git ls-remote origin 'refs/dolt/*'
# 52689c0ae7...  refs/dolt/data

I’ve seen refs/ used for GitHub PRs before (refs/pr/<num>/head) but I haven’t looked into how any of it actually works. For now, seeing refs/dolt/data show up in git ls-remote is enough to make me comfortable that my data exists somewhere.

To avoid doing this manually on every machine, add the remote to .beads/config.yaml:

sync:
  git-remote: git+ssh://[email protected]/you/repo.git

Anyone cloning the repo can then run bd bootstrap and bd dolt push / pull will just work.