Beads Daemon Management

Overview

The Beads daemon (bd daemon) runs as a background process that watches for issue mutations and automatically syncs changes to/from JSONL files. This skill covers daemon lifecycle, log analysis, troubleshooting, and integration with git workflows.

Key Files:

• .beads/config.yaml — Daemon configuration
• .beads/daemon.log — Runtime logs
• .beads/daemon.pid — Process ID file
• .beads/daemon.sock — Unix socket for IPC
• .beads/issues.jsonl — Serialized issue state

Pattern 1: Daemon Lifecycle — START/STOP/STATUS

When: Managing the background sync process.