Synchronize Beads task statuses into spec.md with markdown markers and commit SHAs.
npx skills add https://github.com/cofin/flow --skill flow-sync
Please help me install this Agent Skill. Skill: flow-sync Source: https://github.com/cofin/flow/tree/main/templates/codex/skills/flow-sync Command: npx skills add https://github.com/cofin/flow --skill flow-sync
This Skill synchronizes the state of tasks managed in Beads with the on-disk spec.md file, ensuring that your project's documentation accurately reflects the current status of your work.
spec.md based on Beads status.[ ], [~], [x], [!]).flow-sync to automatically update the corresponding checkboxes and add commit references in your project's spec.md, keeping your documentation in sync with development progress.Run the flow-sync skill to synchronize the active flow's Beads state to spec.md.
High-intent search queries and answers about installing and using this skill.
To sync task status from Beads to a spec.md file, run the flow-sync skill. It updates task markers in your project's spec.md based on Beads status and appends commit SHAs from close reasons to keep documentation current.
Yes, you need the br command-line tool to sync Beads state to spec.md. The synchronization process requires br to interact with Beads and operate on flow-specific spec and metadata files.
Flow-sync maps Beads statuses to markdown checkboxes by translating open to [ ], in_progress to [~], closed to [x], and blocked to [!]. It also appends commit SHAs from Beads close reasons where available.
Yes, you can automatically add commit SHAs to spec.md when closing Beads tasks. The sync process extracts commit SHAs from Beads close reasons and appends them directly to the corresponding task entries in spec.md.
Yes, flow-sync updates metadata.json when synchronizing spec.md. It records sync timestamps in the metadata.json file to track when the Beads state was last synchronized with your project documentation.
Limitations of using flow-sync include its dependency on the br command-line tool for Beads interaction and its restriction to operating only on flow-specific spec and metadata files for task synchronization.
vkhangphamManage project tasks, study goals, and recurring weaknesses with the Beads command-line tool.
the-agency-aiMove sandbox files to shared locations with symlink cleanup and version control staging.
em-jonesRender OpenSpec spec.md and tasks.md files from current TD task management state.
NimbalystParse plan documents into markdown task lists and update progress status.