# steveyegge/beads

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/steveyegge-beads).**

16,757 stars · 1,021 forks · Go · mit

## Links

- GitHub: https://github.com/steveyegge/beads
- awesome-repositories: https://awesome-repositories.com/repository/steveyegge-beads.md

## Topics

`agents` `claude-code` `coding`

## Description

Beads is a versioned, dependency-aware graph database designed for distributed issue tracking and project management. It functions as an agentic workflow orchestrator, providing a structured environment where tasks, dependencies, and project metadata are linked through relational hierarchies. By maintaining a persistent, version-controlled record of project state, the system enables teams to manage complex work items across multiple repositories and environments.

The platform distinguishes itself through its deep integration with automated coding agents, acting as a Model Context Protocol server to inject persistent memory and task context directly into development sessions. It supports multi-agent coordination by managing work reservations and presence awareness, while its declarative workflow engine automates sequences through asynchronous gates and conditional triggers. Unlike standard trackers, it treats project data as a graph, allowing for complex relational queries and the automated identification of unblocked tasks based on real-time dependency analysis.

Beyond its core orchestration capabilities, the system provides comprehensive tools for project oversight, including health metrics, workflow visualization, and unified synchronization with external issue trackers. It offers flexible deployment options, ranging from embedded local storage for single-writer workflows to persistent server configurations for multi-user environments. Access control and project visibility are managed independently of source code repositories, ensuring that planning data remains secure and structured throughout the project lifecycle.

## Tags

### Data & Databases

- [Versioned Task](https://awesome-repositories.com/f/data-databases/graph-databases/versioned-task.md) — Acts as a versioned, dependency-aware graph database for tracking project tasks and complex workflows.
- [Data Source Synchronizers](https://awesome-repositories.com/f/data-databases/data-synchronization/data-source-synchronizers.md) — Imports tasks and metadata from external repositories into a unified, structured format. ([source](https://gastownhall.github.io/beads/community-tools))
- [Concurrent Database Servers](https://awesome-repositories.com/f/data-databases/data-writers/concurrent-database-servers.md) — Hosts a persistent database server allowing multiple agents or users to concurrently read and write task data. ([source](https://gastownhall.github.io/beads/))
- [Issue Status Mappers](https://awesome-repositories.com/f/data-databases/external-data-integrations/issue-status-mappers.md) — Maps project issue statuses and labels to external platforms to maintain data consistency. ([source](https://gastownhall.github.io/beads/reference/configuration))
- [Search and Indexing](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing.md) — Enables complex relational queries and searches across the issue graph for project insights. ([source](https://gastownhall.github.io/beads/cli-reference))

### Artificial Intelligence & ML

- [Task Management Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/model-context-protocol/mcp-server-management/task-management-servers.md) — A protocol-compliant interface that allows AI coding agents to programmatically query, update, and manage project tasks and dependencies.
- [Agentic Workflow Automation](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-workflow-automation.md) — Injects persistent project memory and task context directly into development sessions to enable automated coding agents to maintain state. ([source](https://gastownhall.github.io/beads/integrations/aider))
- [Agentic Workflow Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-workflow-orchestrators.md) — Coordinates multi-agent teams by injecting persistent project memory and structured guidance into development sessions.
- [Multi-Agent Coordination](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-agent-coordination.md) — Facilitates communication and work reservation across distributed agents to ensure synchronized execution. ([source](https://gastownhall.github.io/beads/multi-agent))
- [Agent Context Providers](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-context-providers.md) — Injects persistent project memory and task context directly into development sessions to support automated coding agents. ([source](https://gastownhall.github.io/beads/integrations/codex))
- [Model Context Protocol Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/model-context-protocol-servers.md) — Provides a standard Model Context Protocol interface for AI agents to interact with task management systems. ([source](https://gastownhall.github.io/beads/getting-started/installation))
- [Knowledge Graphs](https://awesome-repositories.com/f/artificial-intelligence-ml/knowledge-graphs.md) — Links tasks through relational hierarchies to maintain structured project context for automated agents. ([source](https://cdn.jsdelivr.net/gh/steveyegge/beads@main/README.md))
- [Task Provenance Trackers](https://awesome-repositories.com/f/artificial-intelligence-ml/memory-provenance-tracking/task-provenance-trackers.md) — Links new issues to the work items that triggered their creation to maintain an audit trail. ([source](https://gastownhall.github.io/beads/integrations/aider))
- [Guidance Generators](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-context-management/guidance-generators.md) — Generates project-specific guidance files to instruct coding assistants on interacting with the task graph. ([source](https://gastownhall.github.io/beads/integrations/windsurf))

### Business & Productivity Software

- [Productivity and Task Management](https://awesome-repositories.com/f/business-productivity-software/task-workflow-automation/productivity-task-management.md) — Tracks tasks with custom priorities and complex dependency relationships in a structured graph. ([source](https://gastownhall.github.io/beads/llms.txt))
- [Hierarchical Task Nesting](https://awesome-repositories.com/f/business-productivity-software/project-task-management/hierarchical-task-nesting.md) — Groups tasks into nested structures to manage complex requirements through parent-child relationships. ([source](https://gastownhall.github.io/beads/getting-started/quickstart))

### Development Tools & Productivity

- [Issue Tracking Systems](https://awesome-repositories.com/f/development-tools-productivity/issue-tracking-systems.md) — Synchronizes project state across multiple repositories using version-controlled data structures and relational task graphs.
- [Task Dependency Managers](https://awesome-repositories.com/f/development-tools-productivity/task-dependency-managers.md) — Links work items through blocking and discovery relationships to determine ready queues. ([source](https://gastownhall.github.io/beads/llms.txt))
- [Command Line Interfaces](https://awesome-repositories.com/f/development-tools-productivity/command-line-interfaces.md) — Provides text commands to manage tracked tasks directly from the coding environment. ([source](https://gastownhall.github.io/beads/integrations/claude-code))
- [Issue Management Utilities](https://awesome-repositories.com/f/development-tools-productivity/issue-management-utilities.md) — Provides an interface to create, update, and close structured task details. ([source](https://gastownhall.github.io/beads/integrations/junie))
- [Workflow Automation Templates](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-templates.md) — Provides declarative definitions for complex task sequences, supporting variable substitution and conditional gates to standardize development processes. ([source](https://gastownhall.github.io/beads/workflows/molecules))
- [Issue Tracking Integrations](https://awesome-repositories.com/f/development-tools-productivity/issue-tracking-integrations.md) — Consolidates task data from multiple external platforms into a single, searchable interface.
- [Task Dependency Filters](https://awesome-repositories.com/f/development-tools-productivity/task-dependency-filters.md) — Computes dependency graphs to filter and display only unblocked, actionable tasks. ([source](https://gastownhall.github.io/beads/getting-started/quickstart))
- [Project Analysis CLIs](https://awesome-repositories.com/f/development-tools-productivity/code-quality-analysis/project-analysis-clis.md) — Generates metrics on rework costs and project fidelity by analyzing historical task data. ([source](https://gastownhall.github.io/beads/community-tools))
- [Cross-Repository Enforcers](https://awesome-repositories.com/f/development-tools-productivity/task-dependency-management/cross-repository-enforcers.md) — Tracks and enforces task relationships across different repository boundaries to maintain project-wide consistency. ([source](https://gastownhall.github.io/beads/multi-agent))
- [Task Composition Engines](https://awesome-repositories.com/f/development-tools-productivity/task-scheduling/task-composition-engines.md) — Links task definitions through connection points to build reusable project structures. ([source](https://gastownhall.github.io/beads/workflows/molecules))

### DevOps & Infrastructure

- [Database Versioning Engines](https://awesome-repositories.com/f/devops-infrastructure/version-control-management/version-control/git-native-storage-engines/database-versioning-engines.md) — Maintains a complete history of project state changes using version control semantics for branching and merging. ([source](https://gastownhall.github.io/beads/core-concepts))
- [Asynchronous Pipeline Orchestrators](https://awesome-repositories.com/f/devops-infrastructure/cicd-pipeline-automation/workflow-orchestration/asynchronous-pipeline-orchestrators.md) — Orchestrates asynchronous tasks using gates triggered by human input or external events. ([source](https://gastownhall.github.io/beads/workflows))
- [Visual Task Management Boards](https://awesome-repositories.com/f/devops-infrastructure/devops/workflows/visual-task-management-boards.md) — Provides visual interfaces like kanban boards and dependency graphs to monitor task progress. ([source](https://gastownhall.github.io/beads/community-tools))
- [Distributed Synchronization](https://awesome-repositories.com/f/devops-infrastructure/distributed-synchronization.md) — Maintains a consistent, versioned record of project tasks and dependencies across distributed environments.
- [External Status Synchronizers](https://awesome-repositories.com/f/devops-infrastructure/version-control-management/version-control/status-integrations/external-status-synchronizers.md) — Synchronizes task data across multiple third-party project management platforms to maintain a unified view. ([source](https://gastownhall.github.io/beads/cli-reference))

### Security & Cryptography

- [Role-Based Access Control](https://awesome-repositories.com/f/security-cryptography/role-based-access-control.md) — Configures project visibility and write permissions by managing user roles independently of source code. ([source](https://cdn.jsdelivr.net/gh/steveyegge/beads@main/README.md))

### Software Engineering & Architecture

- [Project Configuration Management](https://awesome-repositories.com/f/software-engineering-architecture/project-configuration-management.md) — Stores persistent project-level settings and diagnostic rules in versioned configuration files. ([source](https://gastownhall.github.io/beads/integrations/junie))
- [Workflow Approval Gates](https://awesome-repositories.com/f/software-engineering-architecture/workflow-approval-gates.md) — Automates complex project sequences using declarative definitions and asynchronous gates for human-in-the-loop approvals.