beads

Beads is a command-line issue tracker that gives coding agents persistent memory of tasks and project facts.

What it is good for

  • Keeping an AI coding agent on track across long tasks
  • Replacing messy markdown plans with a task list
  • Tracking dependencies between tasks an agent works on
  • Storing project facts so an agent remembers them later

At a glance

Who it is for
Setup
Guided command-line setup

Level 4 of 5. You copy and paste commands into a terminal by following the instructions. Comfortable territory for vibe coders.

Cost
Free and open source
Type
Agent app
Tasks
Works with
Claude Code, Codex, Cursor, Factory, Dolt, Git

Momentum

Rank this week
Not ranked yet
Best rank
None yet
GitHub stars
28,407

GitHub numbers as of Nov 2, 2026. Updated weekly.

27.2k 27.9k 28.5k Sep 24, 2026 Nov 2, 2026
GitHub stars for beads: 27,296 on Sep 24, 2026, 28,407 on Nov 2, 2026. Source: GitHub.

Official links

Setup steps are on the official pages. We do not repeat them here, since they change.

Questions

Is beads free?
Yes. It is free and open source (MIT license).
Do I need to know how to code to use beads?
You do not need to write code, but setup means copying and pasting commands into a terminal by following its instructions.
What does beads work with?
According to its own documentation, it works with Claude Code, Codex, Cursor, Factory, Dolt, and Git.
What is beads good for?
Keeping an AI coding agent on track across long tasks, replacing messy markdown plans with a task list, tracking dependencies between tasks an agent works on, and storing project facts so an agent remembers them later.

Similar agents

  • Orca

    Orca is a desktop app that runs and tracks several coding agents at once, each in its own worktree, for developers and vibe coders.

  • TencentDB-Agent-Memory

    TencentDB-Agent-Memory is a self-hosted memory hub that lets a team's AI agents share saved chats, skills, docs, and code context for developers.

  • Paseo

    Paseo is an app that runs and coordinates several coding agents at once for developers working across desktop and phone.

  • Orchestrator.inc

    Orchestrator.inc is a desktop app that runs a fleet of coding agents on one project, each in its own branch, for developers who want parallel work merged without manual juggling.

  • HumanLayer

    HumanLayer is a platform that runs coding agents on your machines so a team can steer them from one place for hard software problems.

  • Worktrunk

    Worktrunk is a command line tool that makes git worktrees easy to create, switch, and clean up for running several AI agents in parallel.

Last updated Nov 2, 2026. Tracked since Oct 28, 2026. The summary was written by an AI model from the project's own description and checked against our copy rules. Spotted an error? Tell us.