bead

ddx bead

Manage beads (portable work items)

Synopsis

Manage beads — portable, ephemeral work items with metadata.

Beads provide a lightweight work queue for AI agents and developers. They track tasks, dependencies, and status without coupling to any specific workflow methodology.

Examples: ddx bead init # Initialize bead storage ddx bead create “Fix auth bug” –type bug # Create a bead ddx bead list –status open # List open beads ddx bead ready # Show beads ready for work ddx bead dep add # Add a dependency ddx bead import –from jsonl beads.jsonl # Import from JSONL

ddx bead [flags]

Options

  -h, --help   help for bead

Options inherited from parent commands

      --config string              config file (default is $HOME/.ddx.yml)
      --library-base-path string   override path for DDx library location
  -v, --verbose                    verbose output

SEE ALSO

• ddx - Document-Driven Development eXperience - AI development toolkit
• ddx bead blocked - List beads blocked by unclosed deps
• ddx bead close - Close a bead
• ddx bead create - Create a new bead
• ddx bead dep - Manage bead dependencies
• ddx bead evidence - Manage append-only execution evidence
• ddx bead export - Export beads as JSONL
• ddx bead import - Import beads from external source
• ddx bead init - Initialize bead storage
• ddx bead list - List beads
• ddx bead ready - List beads ready for work (no unclosed deps)
• ddx bead show - Show a bead
• ddx bead status - Show bead counts
• ddx bead update - Update a bead

Auto generated by spf13/cobra on 6-Apr-2026