Claim this agent
Agent DossierGITHUB OPENCLEWSafety 94/100

Xpersona Agent

beads

Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker. --- name: beads description: "Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker." version: "1.0.0" metadata: openclaw: emoji: "๐Ÿงต" requires: bins: ["bd", "gh"] install: - id: beads kind: binary label: "Install bd CLI from github.com/steveyegge/beads" --- Beads โ€” Distributed Task Coordination Beads is a g

OpenClaw ยท self-declared
2 GitHub starsTrust evidence available
git clone https://github.com/brenner-axiom/beads-skill.git

Overall rank

#33

Adoption

2 GitHub stars

Trust

Unknown

Freshness

Apr 15, 2026

Freshness

Last checked Apr 15, 2026

Best For

beads is best for coordinate, i, make workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, GITHUB OPENCLEW, runtime-metrics, public facts pack

Overview

Key links, install path, reliability highlights, and the shortest practical read before diving into the crawl record.

Verifiededitorial-content

Overview

Executive Summary

Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker. --- name: beads description: "Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker." version: "1.0.0" metadata: openclaw: emoji: "๐Ÿงต" requires: bins: ["bd", "gh"] install: - id: beads kind: binary label: "Install bd CLI from github.com/steveyegge/beads" --- Beads โ€” Distributed Task Coordination Beads is a g Capability contract not published. No trust telemetry is available yet. 2 GitHub stars reported by the source. Last updated 4/15/2026.

No verified compatibility signals2 GitHub stars

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Apr 15, 2026

Vendor

Brenner Axiom

Artifacts

0

Benchmarks

0

Last release

Unpublished

Install & run

Setup Snapshot

git clone https://github.com/brenner-axiom/beads-skill.git
  1. 1

    Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.

  2. 2

    Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence & Timeline

Public facts grouped by evidence type, plus release and crawl events with provenance and freshness.

Verifiededitorial-content

Public facts

Evidence Ledger

Vendor (1)

Vendor

Brenner Axiom

profilemedium
Observed Apr 15, 2026Source linkProvenance
Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium
Observed Apr 15, 2026Source linkProvenance
Adoption (1)

Adoption signal

2 GitHub stars

profilemedium
Observed Apr 15, 2026Source linkProvenance
Security (1)

Handshake status

UNKNOWN

trustmedium
Observed unknownSource linkProvenance
Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium
Observed Apr 15, 2026Source linkProvenance

Artifacts & Docs

Parameters, dependencies, examples, extracted files, editorial overview, and the complete README when available.

Self-declaredGITHUB OPENCLEW

Captured outputs

Artifacts Archive

Extracted files

0

Examples

6

Snippets

0

Languages

typescript

Parameters

Executable Examples

bash

# Initialize beads in any git repo
cd my-project && bd init

# Or use a shared hub repo for cross-project coordination
git clone https://github.com/your-org/beads-hub
cd beads-hub && bd init

bash

bd list --json                    # All beads
bd ready --json                   # Open beads ready for work
bd show <id> --json               # Single bead details

bash

bd create "Title" -p <0-4> --json
bd create "Title" -p 1 --description "Details..." --json
bd create "Sub-task" --parent <epic-id> -p 2 --json

bash

bd update <id> --status in_progress --json
bd update <id> --claim --json               # Atomic claim (prevents conflicts)
bd update <id> --notes "Progress update"
bd update <id> -p 0                          # Re-prioritize

bash

bd close <id> --reason "Completed: summary" --json

bash

bd dep add <child-id> <parent-id>   # child blocked until parent closes

Editorial read

Docs & README

Docs source

GITHUB OPENCLEW

Editorial quality

ready

Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker. --- name: beads description: "Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker." version: "1.0.0" metadata: openclaw: emoji: "๐Ÿงต" requires: bins: ["bd", "gh"] install: - id: beads kind: binary label: "Install bd CLI from github.com/steveyegge/beads" --- Beads โ€” Distributed Task Coordination Beads is a g

Full README

name: beads description: "Cross-agent task coordination using Beads (bd CLI). Create, claim, track, and sync distributed tasks across agents and sessions via a git-backed graph issue tracker." version: "1.0.0" metadata: openclaw: emoji: "๐Ÿงต" requires: bins: ["bd", "gh"] install: - id: beads kind: binary label: "Install bd CLI from github.com/steveyegge/beads"

Beads โ€” Distributed Task Coordination

Beads is a git-backed, distributed issue tracker designed for multi-agent workflows. Every task (a "bead") lives in a git repo and syncs automatically โ€” no central server, no database, just git.

Why Beads?

  • Tasks survive session restarts โ€” they're files in a repo
  • Multiple agents can coordinate without shared memory
  • Full audit trail via git history
  • Works offline, syncs when connected

Prerequisites

  • bd โ€” the Beads CLI (github.com/steveyegge/beads)
  • gh โ€” GitHub CLI (for linked issue management)
  • A git repo initialized with bd init

Quick Start

# Initialize beads in any git repo
cd my-project && bd init

# Or use a shared hub repo for cross-project coordination
git clone https://github.com/your-org/beads-hub
cd beads-hub && bd init

Core Commands

List & Query

bd list --json                    # All beads
bd ready --json                   # Open beads ready for work
bd show <id> --json               # Single bead details

Create

bd create "Title" -p <0-4> --json
bd create "Title" -p 1 --description "Details..." --json
bd create "Sub-task" --parent <epic-id> -p 2 --json

Update

bd update <id> --status in_progress --json
bd update <id> --claim --json               # Atomic claim (prevents conflicts)
bd update <id> --notes "Progress update"
bd update <id> -p 0                          # Re-prioritize

Close

bd close <id> --reason "Completed: summary" --json

Dependencies

bd dep add <child-id> <parent-id>   # child blocked until parent closes

Sync (CRITICAL โ€” always do after changes)

bd sync && git push

Never skip git push! Beads are git-backed. Unpushed changes are invisible to other agents and sessions.

Closing Beads with Linked GitHub Issues

When a bead title contains GH#<number> or notes contain a GitHub issue URL, closing the bead should also close the linked issue:

# Using the helper script
bash skills/beads/close-bead.sh <bead-id> "Completed: summary"

# Or manually
bd close <id> --reason "summary" --json
gh issue comment <number> --repo <owner/repo> \
  --body "โœ… Closed via bead <id>. Summary: <reason>"
gh issue close <number> --repo <owner/repo> --reason completed
bd sync && git push

The close-bead.sh script automates this: it extracts the issue number, comments, closes, syncs, and pushes.

Priority Guide

| Priority | Label | When to use | |----------|-------|-------------| | P0 | ๐Ÿ”ด Critical | Production down, blocking everything | | P1 | ๐ŸŸ  High | Important, do today | | P2 | ๐ŸŸก Normal | Standard work items | | P3 | ๐Ÿ”ต Low | Nice to have, backlog | | P4 | โšช Someday | Ideas, maybe later |

Multi-Agent Patterns

Hub & Spoke

Use a shared "beads-hub" repo for cross-project coordination. Each agent pulls from the hub, claims work, and pushes results.

# Agent session start
cd ~/beads-hub && git pull -q && bd sync
bd ready --json   # What can I work on?

Delegating Work

Create a bead assigned to a specific agent:

bd create "Refactor auth module" -p 2 --assign codemonkey --json

The assigned agent picks it up on its next session or heartbeat.

Epics with Sub-tasks

Break large work into trackable pieces:

bd create "Deploy new service" -p 1 --json
# Returns id: hub-abc
bd create "Write Dockerfile" --parent hub-abc -p 2 --json
bd create "Set up CI pipeline" --parent hub-abc -p 2 --json
bd create "Configure DNS" --parent hub-abc -p 2 --json

Linking to OKRs

Add OKR references in bead notes for traceability:

bd update <id> --notes "OKR: KR 2.3 (integrate additional data source)"

Session Workflow

Every session start:

  1. cd ~/beads-hub && git pull -q && bd sync
  2. bd ready --json โ€” check what's available
  3. Pick highest-priority bead you can make progress on

While working: 4. bd update <id> --status in_progress 5. Do the work 6. If blocked, ask for input โ€” don't skip forever

When done: 7. Close the bead (use close-bead.sh if GitHub-linked) 8. bd sync && git push โ€” always! 9. Pick next bead โ€” never stop

Conventions

  • Always --json for machine-readable output
  • Always bd sync && git push after changes
  • Claim before working โ€” prevents duplicate effort
  • Include bead ID in git commits: git commit -m "Fix auth bug (hub-abc)"
  • One bead per work order โ€” every task goern assigns gets a bead
  • Close what you finish โ€” including linked GitHub issues

API & Reliability

Machine endpoints, contract coverage, trust signals, runtime metrics, benchmarks, and guardrails for agent-to-agent use.

MissingGITHUB OPENCLEW

Machine interfaces

Contract & API

Contract coverage

Status

missing

Auth

None

Streaming

No

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.
Invocation examples
curl -s "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/snapshot"
curl -s "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/contract"
curl -s "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/trust"

Operational fit

Reliability & Benchmarks

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.
No benchmark suites or observed failure patterns are available.

Machine Appendix

Raw contract, invocation, trust, capability, facts, and change-event payloads for machine-side inspection.

MissingGITHUB OPENCLEW

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_OPENCLEW",
      "generatedAt": "2026-04-17T04:49:37.695Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    },
    {
      "key": "coordinate",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "i",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "make",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile capability:coordinate|supported|profile capability:i|supported|profile capability:make|supported|profile"
}

Facts JSON

[
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Brenner Axiom",
    "href": "https://github.com/brenner-axiom/beads-skill",
    "sourceUrl": "https://github.com/brenner-axiom/beads-skill",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:21:22.124Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:21:22.124Z",
    "isPublic": true
  },
  {
    "factKey": "traction",
    "category": "adoption",
    "label": "Adoption signal",
    "value": "2 GitHub stars",
    "href": "https://github.com/brenner-axiom/beads-skill",
    "sourceUrl": "https://github.com/brenner-axiom/beads-skill",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:21:22.124Z",
    "isPublic": true
  },
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/brenner-axiom-beads-skill/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub ยท GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Sponsored

Ads related to beads and adjacent AI workflows.