beads

Coordinate multi-session, multi-agent tasks with persistent Beads workflows.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/Khoiwall/be_vidify --skill beads-khoiwall
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/Khoiwall/be_vidify/tree/main/.opencode/skill/beads
Command: npx skills add https://github.com/Khoiwall/be_vidify --skill beads-khoiwall

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Beads provides a graph-based task tracker with file locking to coordinate multi-session, multi-agent work, persisting across sessions.

Core Features & Use Cases

  • Beads supports a multi-session workflow using commands like bd_init, bd_claim, bd_reserve, bd_done, bd_show, and bd_add for discovered work.
  • It enables hierarchical epic/child task structures, dependency management, and session protocols. It also offers optional beads-bridge for swarm coordination and visualization.
  • Real-world use: coordinating a cross-team feature that requires backend, frontend, and docs; tasks block/unblock; locks prevent conflicts.

Quick Start

Create an epic and tasks, claim one task, reserve your files, and start work with resumable notes.

Frequently Asked Questions about beads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multi-agent tasks with file locking across sessions?

Multi-agent task coordination with file locking is managed through persistent graph-based workflows, allowing agents to claim tasks, reserve files, and prevent conflicts across sessions. The system tracks dependencies and hierarchical epics to keep work organized.

What's the best way to manage dependencies in a multi-session workflow?

Dependency management in a multi-session workflow is handled using graph-based task tracking where tasks block or unblock each other. You can reserve specific files, add discovered work dynamically, and mark tasks done to automatically resolve dependencies.

Does beads support cross-team collaboration for complex software projects?

Cross-team collaboration for complex software projects is supported through hierarchical epic and child task structures. Teams can coordinate backend, frontend, and documentation tasks while the system manages task dependencies and prevents file conflicts via locking.

How do I start a task and reserve files in a multi-agent environment?

To start a task in a multi-agent environment, initialize the workflow, claim an available task, and reserve the files you need to edit. This file locking prevents other agents from modifying the same files until your task is done.

Can I use swarm-style coordination with task dependencies and locks?

Swarm-style coordination is available through an optional beads-bridge feature that enables visualization and coordination across multiple agents. It works alongside the core dependency management and file locking protocols to manage complex task graphs.

When do I need persistent task tracking for multi-agent work?

Persistent task tracking for multi-agent work is needed when projects span multiple sessions and require strict file locking to prevent conflicts. It ensures that claimed tasks, reserved files, and dependency states survive session restarts without losing progress.