{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/beads",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beads",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/beads",
    "agentPageUrl": "https://openagent3.xyz/skills/beads/agent",
    "manifestUrl": "https://openagent3.xyz/skills/beads/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/beads/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Beads",
        "body": "Distributed, git-backed graph issue tracker for AI agents. Replaces markdown plans with a dependency-aware task graph stored as JSONL in .beads/."
      },
      {
        "title": "Quick Start",
        "body": "# Initialize (non-interactive for agents)\nbd init --quiet\n\n# Check ready work\nbd ready --json\n\n# Create a task\nbd create \"Complete task X\" -p 1 --json\n\n# View task\nbd show bd-a1b2 --json"
      },
      {
        "title": "Core Workflow",
        "body": "bd ready --json — Find unblocked work\nbd update <id> --status in_progress — Claim task\nDo the work\nbd close <id> --reason \"Done\" — Complete task\nbd sync — Force sync before ending session"
      },
      {
        "title": "Agent-Critical Rules",
        "body": "Always use --json for machine-readable output\nNever use bd edit — opens $EDITOR, unusable by agents\nUse bd update instead: bd update <id> --title \"New title\" --description \"New desc\"\nRun bd sync at end of session to flush changes to git"
      },
      {
        "title": "Initialize",
        "body": "bd init --quiet              # Non-interactive, auto-installs hooks\nbd init --prefix myproj      # Custom ID prefix\nbd init --stealth            # Local only, don't commit .beads/\nbd init --contributor        # Fork workflow (separate planning repo)"
      },
      {
        "title": "Create Issues",
        "body": "bd create \"Title\" -p 1 --json                    # Priority 1 (0=critical, 3=low)\nbd create \"Title\" -t epic -p 0 --json            # Create epic\nbd create \"Subtask\" -p 1 --json                  # Under epic: bd-a3f8.1, .2, .3\nbd create \"Found issue\" --deps discovered-from:bd-a1b2 --json\n\nTypes: task, bug, feature, epic\nPriorities: 0 (P0/critical) to 3 (P3/low)"
      },
      {
        "title": "Query Issues",
        "body": "bd ready --json                    # Unblocked tasks (the work queue)\nbd ready --priority 0 --json       # Only P0s\nbd ready --assignee agent-1 --json # Assigned to specific agent\n\nbd list --json                     # All issues\nbd list --status open --json       # Open issues\nbd list --priority 1 --json        # P1 issues\n\nbd show bd-a1b2 --json             # Issue details + audit trail\nbd blocked --json                  # Issues waiting on dependencies\nbd stats --json                    # Statistics"
      },
      {
        "title": "Update Issues",
        "body": "bd update bd-a1b2 --status in_progress --json\nbd update bd-a1b2 --title \"New title\" --json\nbd update bd-a1b2 --description \"Details\" --json\nbd update bd-a1b2 --priority 0 --json\nbd update bd-a1b2 --assignee agent-1 --json\nbd update bd-a1b2 --design \"Design notes\" --json\nbd update bd-a1b2 --notes \"Additional notes\" --json\n\nStatus values: open, in_progress, blocked, closed"
      },
      {
        "title": "Close Issues",
        "body": "bd close bd-a1b2 --reason \"Completed\" --json\nbd close bd-a1b2 bd-b2c3 --reason \"Batch close\" --json"
      },
      {
        "title": "Dependencies",
        "body": "bd dep add bd-child bd-parent      # child blocked by parent\nbd dep add bd-a1b2 bd-b2c3 --type related    # Related link\nbd dep add bd-a1b2 bd-epic --type parent     # Parent-child\n\nbd dep tree bd-a1b2                # Visualize dependency tree\nbd dep remove bd-child bd-parent   # Remove dependency\nbd dep cycles                      # Detect circular deps\n\nDependency types: blocks (default), related, parent, discovered-from"
      },
      {
        "title": "Git Sync",
        "body": "bd sync                    # Export → commit → pull → import → push\nbd hooks install           # Install git hooks for auto-sync\n\nThe daemon auto-syncs with 30s debounce. Use bd sync to force immediate sync."
      },
      {
        "title": "Maintenance",
        "body": "bd admin compact --dry-run --json   # Preview compaction\nbd admin compact --days 90          # Compact issues closed >90 days\nbd doctor                           # Check database health"
      },
      {
        "title": "Hierarchical IDs (Epics)",
        "body": "bd create \"Project Alpha\" -t epic -p 1 --json   # Returns: bd-a3f8\nbd create \"Phase 1\" -p 1 --json                 # Returns: bd-a3f8.1\nbd create \"Research\" -p 1 --json                # Returns: bd-a3f8.2\nbd create \"Review\" -p 1 --json                  # Returns: bd-a3f8.3\n\nUp to 3 levels: bd-a3f8 → bd-a3f8.1 → bd-a3f8.1.1"
      },
      {
        "title": "Multi-Agent Coordination",
        "body": "# Agent claims work\nbd update bd-a1b2 --status in_progress --assignee agent-1 --json\n\n# Query assigned work\nbd ready --assignee agent-1 --json\n\n# Track discovered work\nbd create \"Found issue\" --deps discovered-from:bd-a1b2 --json"
      },
      {
        "title": "Commit Convention (Optional)",
        "body": "For git-tracked projects, include issue ID in commit messages for traceability:\n\ngit commit -m \"Complete research phase (bd-a1b2)\""
      },
      {
        "title": "Session End Checklist",
        "body": "Before ending a session:\n\nbd sync                    # Flush all changes\nbd ready --json            # Show next work for handoff"
      }
    ],
    "body": "Beads\n\nDistributed, git-backed graph issue tracker for AI agents. Replaces markdown plans with a dependency-aware task graph stored as JSONL in .beads/.\n\nQuick Start\n# Initialize (non-interactive for agents)\nbd init --quiet\n\n# Check ready work\nbd ready --json\n\n# Create a task\nbd create \"Complete task X\" -p 1 --json\n\n# View task\nbd show bd-a1b2 --json\n\nCore Workflow\nbd ready --json — Find unblocked work\nbd update <id> --status in_progress — Claim task\nDo the work\nbd close <id> --reason \"Done\" — Complete task\nbd sync — Force sync before ending session\nAgent-Critical Rules\nAlways use --json for machine-readable output\nNever use bd edit — opens $EDITOR, unusable by agents\nUse bd update instead: bd update <id> --title \"New title\" --description \"New desc\"\nRun bd sync at end of session to flush changes to git\nCommands\nInitialize\nbd init --quiet              # Non-interactive, auto-installs hooks\nbd init --prefix myproj      # Custom ID prefix\nbd init --stealth            # Local only, don't commit .beads/\nbd init --contributor        # Fork workflow (separate planning repo)\n\nCreate Issues\nbd create \"Title\" -p 1 --json                    # Priority 1 (0=critical, 3=low)\nbd create \"Title\" -t epic -p 0 --json            # Create epic\nbd create \"Subtask\" -p 1 --json                  # Under epic: bd-a3f8.1, .2, .3\nbd create \"Found issue\" --deps discovered-from:bd-a1b2 --json\n\n\nTypes: task, bug, feature, epic Priorities: 0 (P0/critical) to 3 (P3/low)\n\nQuery Issues\nbd ready --json                    # Unblocked tasks (the work queue)\nbd ready --priority 0 --json       # Only P0s\nbd ready --assignee agent-1 --json # Assigned to specific agent\n\nbd list --json                     # All issues\nbd list --status open --json       # Open issues\nbd list --priority 1 --json        # P1 issues\n\nbd show bd-a1b2 --json             # Issue details + audit trail\nbd blocked --json                  # Issues waiting on dependencies\nbd stats --json                    # Statistics\n\nUpdate Issues\nbd update bd-a1b2 --status in_progress --json\nbd update bd-a1b2 --title \"New title\" --json\nbd update bd-a1b2 --description \"Details\" --json\nbd update bd-a1b2 --priority 0 --json\nbd update bd-a1b2 --assignee agent-1 --json\nbd update bd-a1b2 --design \"Design notes\" --json\nbd update bd-a1b2 --notes \"Additional notes\" --json\n\n\nStatus values: open, in_progress, blocked, closed\n\nClose Issues\nbd close bd-a1b2 --reason \"Completed\" --json\nbd close bd-a1b2 bd-b2c3 --reason \"Batch close\" --json\n\nDependencies\nbd dep add bd-child bd-parent      # child blocked by parent\nbd dep add bd-a1b2 bd-b2c3 --type related    # Related link\nbd dep add bd-a1b2 bd-epic --type parent     # Parent-child\n\nbd dep tree bd-a1b2                # Visualize dependency tree\nbd dep remove bd-child bd-parent   # Remove dependency\nbd dep cycles                      # Detect circular deps\n\n\nDependency types: blocks (default), related, parent, discovered-from\n\nGit Sync\nbd sync                    # Export → commit → pull → import → push\nbd hooks install           # Install git hooks for auto-sync\n\n\nThe daemon auto-syncs with 30s debounce. Use bd sync to force immediate sync.\n\nMaintenance\nbd admin compact --dry-run --json   # Preview compaction\nbd admin compact --days 90          # Compact issues closed >90 days\nbd doctor                           # Check database health\n\nHierarchical IDs (Epics)\nbd create \"Project Alpha\" -t epic -p 1 --json   # Returns: bd-a3f8\nbd create \"Phase 1\" -p 1 --json                 # Returns: bd-a3f8.1\nbd create \"Research\" -p 1 --json                # Returns: bd-a3f8.2\nbd create \"Review\" -p 1 --json                  # Returns: bd-a3f8.3\n\n\nUp to 3 levels: bd-a3f8 → bd-a3f8.1 → bd-a3f8.1.1\n\nMulti-Agent Coordination\n# Agent claims work\nbd update bd-a1b2 --status in_progress --assignee agent-1 --json\n\n# Query assigned work\nbd ready --assignee agent-1 --json\n\n# Track discovered work\nbd create \"Found issue\" --deps discovered-from:bd-a1b2 --json\n\nCommit Convention (Optional)\n\nFor git-tracked projects, include issue ID in commit messages for traceability:\n\ngit commit -m \"Complete research phase (bd-a1b2)\"\n\nSession End Checklist\n\nBefore ending a session:\n\nbd sync                    # Flush all changes\nbd ready --json            # Show next work for handoff"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/rnijhara/beads",
    "publisherUrl": "https://clawhub.ai/rnijhara/beads",
    "owner": "rnijhara",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}