this repo has no description

Document bd daemon and sync branch requirements

ktim.tngl.sh 46b221ec de703f34

verified
Changed files
+19
codex
+19
codex/AGENTS.md
··· 72 72 - Imports from JSONL when newer (e.g., after `git pull`) 73 73 - No manual export/import needed! 74 74 75 + ### bd Daemon 76 + 77 + Always launch the background service with: 78 + ```bash 79 + bd daemon start --auto-commit --auto-push 80 + ``` 81 + Keep it running for the entire session so bd can commit and push issue updates automatically. Restart the daemon immediately if it stops or after switching branches. 82 + 83 + ### bd Configuration 84 + 85 + Confirm the repository syncs metadata to the dedicated branch: 86 + ```bash 87 + bd config get sync.branch 88 + ``` 89 + This must output `beads-metadata`. If it is unset or different, fix it immediately: 90 + ```bash 91 + bd config set sync.branch beads-metadata --json 92 + ``` 93 + 75 94 ### JSONL Conflict Playbook 76 95 77 96 - Treat `.beads/issues.jsonl` as generated output; when conflicts or manual edits appear, re-export from the database (`bd export -o .beads/issues.jsonl`) instead of hand-editing.