ktim.tngl.sh
this repo has no description
Document bd daemon and sync branch requirements
+19
+19
codex/AGENTS.md
+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.