-
Notifications
You must be signed in to change notification settings - Fork 274
Open
Description
Summary
bd doctor shows a warning about sync-branch not configured for all users, even those who don't need it. This creates confusion during onboarding.
Current Behavior
⚠ Warning: sync-branch not configured
Fix: Add 'sync-branch: beads-sync' to .beads/config.yaml
This warning appears for everyone, regardless of their workflow.
Expected Behavior
The warning should only appear when the user's workflow actually requires sync-branch:
- They have protected branches AND are trying to auto-commit to them
- They have multiple clones of the same repo that need to sync
My Use Case (No sync-branch needed)
I use Graphite for PR stacking:
- All work happens on feature branches (
gt c -am "message") - Never commit directly to
main/develop .beads/changes flow naturally with PR merges- Single clone, no multi-machine sync needed
For this workflow, sync-branch adds no value - it's just noise in bd doctor.
Suggestion
Either:
- Don't show the warning by default - only warn if the user attempts an operation that requires sync-branch
- Make it informational, not a warning - "ℹ️ sync-branch not configured (only needed for multi-clone or protected branch workflows)"
- Add a config option to suppress it -
bd config set sync.branch-warning false
Environment
- bd version: 0.29.0
- Workflow: Graphite PR stacking, feature branch development
- OS: macOS
hex
Metadata
Metadata
Assignees
Labels
No labels