beads

🥇Gold

Beads is a distributed, git-backed graph issue tracker for AI agents. It enhances coding agents' memory and task management, benefiting developers and operations teams. Integrates with Claude and supports cross-platform use.

20,2108150Updated 1w ago

Intermediate30min to implementautomation

Saves ~90 min per use

Quick InstallView Source

git clone https://github.com/steveyegge/beads.git

Works with:

Claude

Overview

About This Skill

https://github.com/steveyegge/beads

How to Use

["1. Install Beads by following the installation guide on the official website. Ensure you have Git and a compatible AI agent platform like Claude installed.","2. Initialize a new Beads project using the prompt template provided. Specify the project name, list of initial tasks, and agent assignments.","3. Review the generated project structure and task assignments. Make any necessary adjustments to ensure tasks are correctly prioritized and dependencies are clearly defined.","4. Monitor the progress of tasks through the Beads dashboard. Use the integrated Git repository to track changes and updates made by AI agents.","5. Regularly update task statuses and reassign tasks as needed. Use the cross-platform capabilities of Beads to manage tasks from any device."]

Use Cases

Track and manage tasks across multiple agents in a collaborative coding environment.

Create and link tasks with dependencies to visualize project progress and blockers.

Utilize semantic memory decay to summarize closed tasks, maintaining relevant context for future work.

Run Beads in stealth mode for personal projects without affecting the main repository.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/steveyegge/beads

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Create a new Beads project for [PROJECT_NAME] with the following initial tasks: [TASK_LIST]. Ensure each task has clear dependencies and priority levels. Assign tasks to the appropriate AI agents based on their capabilities: [AGENT_ASSIGNMENTS].

Example Output

Project: 'Automated Customer Support System' created successfully. Initial tasks include: 1) Design database schema (Priority: High, Assigned to: Database Architect Agent), 2) Develop API endpoints (Priority: Medium, Assigned to: Backend Developer Agent), 3) Create frontend UI components (Priority: Low, Assigned to: Frontend Developer Agent). Task dependencies: API endpoints must be completed before frontend UI components. Project repository initialized at git@github.com:company/automated-customer-support-system.git.