Commands
sync-bd
Sync active beads (bd) tasks into the vault views
The sync-bd command pulls active tasks from the beads (bd) task manager and writes them into views/now.md. This gives your AI agent awareness of external tasks tracked in beads.
Added in v2.2.0
Usage
clawvault sync-bd [options]Options
| Flag | Description | Default |
|---|---|---|
--dry-run | Show what would be synced without writing | false |
-v, --vault <path> | Vault path | Nearest vault |
Requirements
The bd binary must be installed and on your PATH. If it is not found, the command exits silently with no error.
This command is optional and only relevant if you use beads for task management. See the Beads integration guide for setup details.
How It Works
- Checks for the
bdbinary on your system - Queries active tasks via
bd list --json(falls back to plain text output) - Filters out tasks with status
done,completed, orclosed - Upserts an "Active Tasks (from bd)" section in
views/now.md
Examples
# Sync bd tasks into views/now.md
clawvault sync-bd
# Preview the sync
clawvault sync-bd --dry-run