Summary
The CLAUDE.md template and bd prime output both include bd dolt push in the mandatory session completion workflow. This causes agent errors when no Dolt remote is configured — regardless of whether the project uses embedded or server mode.
Both modes support push/pull; the problem is purely that agents follow the session close protocol literally and hit the error when no remote exists.
Affected Templates
All three template files hardcode bd dolt push in mandatory session completion:
internal/templates/agents/defaults/beads-section-minimal.md:32
internal/templates/agents/defaults/beads-section.md:108
internal/templates/agents/defaults/agents.md.tmpl:136
bd prime output also lists bd dolt push in the Sync & Collaboration section (cmd/bd/prime.go:362,379,396) regardless of whether remotes exist.
Reproduction
bd init a new project (no Dolt remotes configured — the default)
bd setup claude to inject the CLAUDE.md session completion section
- Have an agent work a session and follow the session close protocol
- Agent runs
bd dolt push and gets: Error 1105: fatal: remote 'origin' not found. No remote is configured for this database.
This affects both embedded and server mode equally — neither will succeed without a configured remote.
Note on Embedded vs Server Mode
bd dolt push IS supported in embedded mode (see dolt_embedded_test.go:119). The issue is not mode-specific — it is purely about missing remote configuration. Agents have no way to know whether a remote is configured before attempting the push.
Expected Behavior
Agents should not error out mid-session-close because of an unconfigured Dolt remote.
Suggested Fix
The simplest fix: make bd dolt push exit 0 with an informational message when no remotes are configured, rather than returning an error. This makes the session close protocol safe to follow regardless of whether the user has set up Dolt replication.
Alternatively, bd setup claude and bd prime could detect whether any remotes are configured and omit the push instruction when none exist.
Summary
The CLAUDE.md template and
bd primeoutput both includebd dolt pushin the mandatory session completion workflow. This causes agent errors when no Dolt remote is configured — regardless of whether the project uses embedded or server mode.Both modes support push/pull; the problem is purely that agents follow the session close protocol literally and hit the error when no remote exists.
Affected Templates
All three template files hardcode
bd dolt pushin mandatory session completion:internal/templates/agents/defaults/beads-section-minimal.md:32internal/templates/agents/defaults/beads-section.md:108internal/templates/agents/defaults/agents.md.tmpl:136bd primeoutput also listsbd dolt pushin the Sync & Collaboration section (cmd/bd/prime.go:362,379,396) regardless of whether remotes exist.Reproduction
bd inita new project (no Dolt remotes configured — the default)bd setup claudeto inject the CLAUDE.md session completion sectionbd dolt pushand gets:Error 1105: fatal: remote 'origin' not found. No remote is configured for this database.This affects both embedded and server mode equally — neither will succeed without a configured remote.
Note on Embedded vs Server Mode
bd dolt pushIS supported in embedded mode (seedolt_embedded_test.go:119). The issue is not mode-specific — it is purely about missing remote configuration. Agents have no way to know whether a remote is configured before attempting the push.Expected Behavior
Agents should not error out mid-session-close because of an unconfigured Dolt remote.
Suggested Fix
The simplest fix: make
bd dolt pushexit 0 with an informational message when no remotes are configured, rather than returning an error. This makes the session close protocol safe to follow regardless of whether the user has set up Dolt replication.Alternatively,
bd setup claudeandbd primecould detect whether any remotes are configured and omit the push instruction when none exist.