# Send Beads Task Tracker to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "beads", "name": "Beads Task Tracker", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/rnijhara/beads", "canonicalUrl": "https://clawhub.ai/rnijhara/beads", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/beads", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beads", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "beads", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T10:54:35.780Z", "expiresAt": "2026-05-07T10:54:35.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beads", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beads", "contentDisposition": "attachment; filename=\"beads-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "beads" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/beads" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/beads", "downloadUrl": "https://openagent3.xyz/downloads/beads", "agentUrl": "https://openagent3.xyz/skills/beads/agent", "manifestUrl": "https://openagent3.xyz/skills/beads/agent.json", "briefUrl": "https://openagent3.xyz/skills/beads/agent.md" } } ``` ## Documentation ### Beads Distributed, git-backed graph issue tracker for AI agents. Replaces markdown plans with a dependency-aware task graph stored as JSONL in .beads/. ### Quick Start # Initialize (non-interactive for agents) bd init --quiet # Check ready work bd ready --json # Create a task bd create "Complete task X" -p 1 --json # View task bd show bd-a1b2 --json ### Core Workflow bd ready --json — Find unblocked work bd update --status in_progress — Claim task Do the work bd close --reason "Done" — Complete task bd sync — Force sync before ending session ### Agent-Critical Rules Always use --json for machine-readable output Never use bd edit — opens $EDITOR, unusable by agents Use bd update instead: bd update --title "New title" --description "New desc" Run bd sync at end of session to flush changes to git ### Initialize bd init --quiet # Non-interactive, auto-installs hooks bd init --prefix myproj # Custom ID prefix bd init --stealth # Local only, don't commit .beads/ bd init --contributor # Fork workflow (separate planning repo) ### Create Issues bd create "Title" -p 1 --json # Priority 1 (0=critical, 3=low) bd create "Title" -t epic -p 0 --json # Create epic bd create "Subtask" -p 1 --json # Under epic: bd-a3f8.1, .2, .3 bd create "Found issue" --deps discovered-from:bd-a1b2 --json Types: task, bug, feature, epic Priorities: 0 (P0/critical) to 3 (P3/low) ### Query Issues bd ready --json # Unblocked tasks (the work queue) bd ready --priority 0 --json # Only P0s bd ready --assignee agent-1 --json # Assigned to specific agent bd list --json # All issues bd list --status open --json # Open issues bd list --priority 1 --json # P1 issues bd show bd-a1b2 --json # Issue details + audit trail bd blocked --json # Issues waiting on dependencies bd stats --json # Statistics ### Update Issues bd update bd-a1b2 --status in_progress --json bd update bd-a1b2 --title "New title" --json bd update bd-a1b2 --description "Details" --json bd update bd-a1b2 --priority 0 --json bd update bd-a1b2 --assignee agent-1 --json bd update bd-a1b2 --design "Design notes" --json bd update bd-a1b2 --notes "Additional notes" --json Status values: open, in_progress, blocked, closed ### Close Issues bd close bd-a1b2 --reason "Completed" --json bd close bd-a1b2 bd-b2c3 --reason "Batch close" --json ### Dependencies bd dep add bd-child bd-parent # child blocked by parent bd dep add bd-a1b2 bd-b2c3 --type related # Related link bd dep add bd-a1b2 bd-epic --type parent # Parent-child bd dep tree bd-a1b2 # Visualize dependency tree bd dep remove bd-child bd-parent # Remove dependency bd dep cycles # Detect circular deps Dependency types: blocks (default), related, parent, discovered-from ### Git Sync bd sync # Export → commit → pull → import → push bd hooks install # Install git hooks for auto-sync The daemon auto-syncs with 30s debounce. Use bd sync to force immediate sync. ### Maintenance bd admin compact --dry-run --json # Preview compaction bd admin compact --days 90 # Compact issues closed >90 days bd doctor # Check database health ### Hierarchical IDs (Epics) bd create "Project Alpha" -t epic -p 1 --json # Returns: bd-a3f8 bd create "Phase 1" -p 1 --json # Returns: bd-a3f8.1 bd create "Research" -p 1 --json # Returns: bd-a3f8.2 bd create "Review" -p 1 --json # Returns: bd-a3f8.3 Up to 3 levels: bd-a3f8 → bd-a3f8.1 → bd-a3f8.1.1 ### Multi-Agent Coordination # Agent claims work bd update bd-a1b2 --status in_progress --assignee agent-1 --json # Query assigned work bd ready --assignee agent-1 --json # Track discovered work bd create "Found issue" --deps discovered-from:bd-a1b2 --json ### Commit Convention (Optional) For git-tracked projects, include issue ID in commit messages for traceability: git commit -m "Complete research phase (bd-a1b2)" ### Session End Checklist Before ending a session: bd sync # Flush all changes bd ready --json # Show next work for handoff ## Trust - Source: tencent - Verification: Indexed source record - Publisher: rnijhara - Version: 1.0.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T10:54:35.780Z - Expires at: 2026-05-07T10:54:35.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/beads) - [Send to Agent page](https://openagent3.xyz/skills/beads/agent) - [JSON manifest](https://openagent3.xyz/skills/beads/agent.json) - [Markdown brief](https://openagent3.xyz/skills/beads/agent.md) - [Download page](https://openagent3.xyz/downloads/beads)