One-click install
npx skills add https://github.com/jordanhindo/meridian --skill beads-jordanhindo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/jordanhindo/meridian/tree/main/.claude/skills/beads
Command: npx skills add https://github.com/jordanhindo/meridian --skill beads-jordanhindo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Beads helps you manage complex, multi-session work by keeping a durable, graph-structured record of tasks, dependencies, and the rationale behind decisions—so you can reliably resume after conversation compaction or time away.

Core Features & Use Cases

  • Persistent issue tracking across sessions: Create and update Git-backed “beads” that survive compaction, with notes that preserve context.
  • Dependency graph with “ready” work discovery: Use dependency types to model blockers and prerequisites, so the next actionable items are surfaced automatically.
  • Session protocol for reliable execution: Support a practical workflow (ready → show → update in progress → close → sync) including advanced patterns like async gates and agent tracking.

Use cases: Track a research project over days, coordinate a feature with prerequisites and blockers, or manage collaborative work where context must persist beyond the current chat session.

Quick Start

Tell your AI assistant to use the beads skill to plan, track, and persist a multi-session task with dependencies by running the Beads workflow and starting from the current ready items.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I persist task context for multi-session AI agent workflows after conversation compaction?

A dependency graph models task blockers and prerequisites, automatically surfacing the next actionable items. This ready work discovery ensures your AI agent workflow only executes tasks whose dependencies are fully resolved.

What is the best way to track blockers and prerequisites in a backlog across multiple sessions?

Yes, you can coordinate feature work with prerequisites and blockers using a session protocol. This practical workflow cycles through ready, show, in progress, close, and sync states to manage dependencies and track agent execution reliably.

Do I need git to manage multi-session memory and task tracking with dependency graphs?

Multi-session memory task tracking is limited if notes are not properly synced to the git-backed repository. Without following the session protocol, context may not survive conversation compaction, making resumption of complex dependency graphs unreliable.

How do I resume an in-progress task with dependencies after time away from my AI assistant?

To resume an in-progress task with dependencies after time away, retrieve current ready items from the dependency graph. The persistent git-backed notes provide the rationale and context needed to continue execution seamlessly.