beads

Manage persistent task memory for AI coding agents with Beads.

8|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/mrf/beads-skill --skill beads-mrf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/mrf/beads-skill/tree/main/
Command: npx skills add https://github.com/mrf/beads-skill --skill beads-mrf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beads, git, jq, and includes scripts (resource) and commands (resource) components.

What problem does it solve?

This Skill eliminates manual project tracking and context switching between coding sessions by providing persistent memory for AI agents.

Core Features & Use Cases

  • Persistent Memory: Track tasks, dependencies, and progress across all your AI coding sessions.
  • Priority Enforcement: Automatically ensure you're always working on the most important tasks first.
  • Use Case: Imagine you're building a complex web application. Use this Skill to automatically file bugs discovered during development, track feature dependencies, and resume work exactly where you left off.

Quick Start

Use the beads skill to check what's ready to work on and start making progress immediately.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I maintain task memory across multiple AI coding sessions?

Persistent memory for AI agents tracks tasks, dependencies, and progress across coding sessions using hash-based issue IDs and JSONL persistence in a git-backed .beads directory, eliminating manual context switching and ensuring you resume exactly where you left off.

Can I automate issue tracking and priority management for my AI agent?

Yes. Beads automates issue creation, updates, and priority enforcement so your AI agent always works on the most important tasks first, with slash-command integration and hierarchical task relationships for complex projects.

How do I track feature dependencies and plan epics in an AI-driven workflow?

Use Beads to manage feature dependencies, plan epic features, and synchronize task hierarchies across sessions with automated Project Manager audit processes that validate task relationships and maintain consistency.

Does this work with git-based project workflows?

Yes. Beads stores all task data as JSONL in a git-backed .beads directory, integrating seamlessly with existing git workflows and version control while providing persistent agent memory across coding sessions.

What's required to set up persistent task management for my AI agent?

Beads requires git, jq, and the beads dependency itself. It uses slash-command integration and TodoWrite synchronization for multi-session memory, with automated updates to issue tracking and priority management maintained in your .beads directory.