beads-setup

Initializes beads task tracking and persistent agent memory in a darkmatter repository.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/darkmatter/skills --skill beads-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-setup
Source: https://github.com/darkmatter/skills/tree/main/skills/beads-setup
Command: npx skills add https://github.com/darkmatter/skills --skill beads-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill brings a darkmatter repository into compliance with the beads task-tracking convention so work can be captured, recalled, and shared across sessions instead of being lost in ad hoc notes or ephemeral checklists.

Core Features & Use Cases

  • Repository Initialization: Creates the .beads/ workspace, installs hooks, and writes the agent guidance needed for a healthy beads setup.
  • Agent Recipe Wiring: Adds only the recipes relevant to the clients actually used in the repo, such as OpenCode, Claude Code, Codex, Cursor, Gemini, Aider, or Factory.
  • Optional Linear Sync: Configures secure Linear credentials and shared settings, then previews and performs issue synchronization between beads and Linear.
  • Verification Workflow: Confirms the installation with checks like bd doctor, bd ready, and bd remember so the repo is left in a known-good state.

Quick Start

Ask the skill to set up beads for this repository, install only the agent recipes you use, and verify that bd is ready and memory persistence works.

Frequently Asked Questions about beads-setup

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

FAQPage Schema
How do I set up persistent agent memory in a repository?

To set up persistent agent memory, you can initialize a beads task-tracking workspace that creates a `.beads/` directory, installs hooks, and writes agent guidance to capture and recall work across sessions.

How do I configure Linear sync for task tracking?

Configuring Linear sync involves securely setting up Linear credentials and shared settings, then previewing and performing issue synchronization between your local beads workspace and Linear.

Which coding agents are supported for recipe wiring during repository setup?

Recipe wiring supports OpenCode, Claude Code, Codex, Cursor, Gemini, Aider, and Factory, installing only the agent recipes relevant to the clients actually used in your repository.

What is the best way to verify task tracking and agent memory installation?

The best way to verify installation is by running diagnostic checks like `bd doctor`, `bd ready`, and `bd remember` to confirm the repository is left in a known-good state with working memory persistence.

Do I need beads installed before initializing repository memory?

Yes, you need the `bd` tool available in your environment, as the setup process verifies `bd` availability before initializing the repository and configuring optional Linear integration.

Why does repository setup require task tracking initialization?

Repository setup requires task tracking initialization to prevent work from being lost in ephemeral checklists, ensuring tasks and context are durably captured and shared across sessions.