Repolode
gastownhall

gastownhall/beads

Распределённый графовый трекер задач на базе Dolt, который через CLI `bd` даёт кодовым агентам постоянную память о задачах и их зависимостях.

Open source альтернатива:JiraLinear

Звёзды
28,009
Форки
1,895
Открытые issues
1,507
Последний коммит
вчера

Что это?

Beads (CLI `bd`) — трекер задач для AI-агентов, пишущих код. Вместо планов в разрозненных markdown-файлах он хранит задачи в виде графа с зависимостями в SQL-базе данных с контролем версий. Агент может запросить задачи без открытых блокирующих задач, атомарно взять задачу в работу и закрыть её, после чего зависимые задачи станут доступны. Это помогает отслеживать долгую работу и не терять контекст.

В качестве слоя хранения используется Dolt — SQL-база данных с ветвлением и слиянием в стиле Git. Задачам присваиваются ID на основе хеша, например `bd-a1b2`, чтобы избежать конфликтов, когда несколько агентов или веток параллельно создают задачи. Иерархические ID подходят для эпиков и подзадач, а граф поддерживает связи вроде `relates-to`, `duplicates` и `supersedes`. Синхронизация между машинами выполняется командами `bd dolt push` и `bd dolt pull` через удалённый git-репозиторий. Инструмент может работать во встроенном режиме или подключаться к внешнему серверу Dolt.

Команда `bd init` настраивает проект и при необходимости устанавливает интеграции для Claude Code, Codex, Cursor и других агентов. CLI также поддерживает скрытый режим без git и экспериментальный HTTP-бэкенд для подключения к общей инстанции `bd serve`.

Ключевые возможности

  • 01Хранит задачи в виде графа зависимостей; `bd ready` показывает задачи, которые ничто не блокирует.
  • 02Атомарное назначение задач с помощью `bd update --claim` для рабочих процессов с несколькими агентами.
  • 03ID на основе хеша и ветвление в Dolt помогают сократить конфликты слияния между ветками.
  • 04Иерархические ID для эпиков и подзадач, а также типы связей графа.
  • 05Семантическое сжатие обобщает старые закрытые задачи, экономя контекстное окно.
  • 06Режим без git и интеграции с агентами Claude Code, Codex и Cursor.

Сценарии использования

  • Предоставление кодовому агенту постоянной памяти о задачах в рамках долгих многоэтапных проектов.
  • Координация нескольких агентов, работающих с одним репозиторием в разных ветках.
  • Отслеживание задач планирования отдельно от изменений при участии в open-source-проектах.
  • Изолированное отслеживание задач в CI или в системе контроля версий, отличной от git.

Быстрый старт

  1. 1

    Установите bd CLI в масштабе всей системы

    Установите по официальной инструкции из README
  2. 2

    Перейдите в каталог проекта

    cd your-project
  3. 3

    Инициализируйте beads в проекте

    bd init

Что важно знать

  • Требуется база данных на основе Dolt, что добавляет зависимость, в которой команде нужно разобраться.
  • Некоторые особенности работы HTTP-бэкенда отличаются от локального режима и документированы как экспериментальные.
  • Для безопасной ручной установки необходимы скрипт установки и проверка бинарного файла.

Темы

Частые вопросы

Что такое beads?
Распределённый графовый трекер задач на базе Dolt, который через CLI `bd` даёт кодовым агентам постоянную память о задачах и их зависимостях. Beads (CLI `bd`) — трекер задач для AI-агентов, пишущих код. Вместо планов в разрозненных markdown-файлах он хранит задачи в виде графа с зависимостями в SQL-базе данных с контролем версий. Агент может запросить задачи без открытых блокирующих задач, атомарно взять задачу в работу и закрыть её, после чего зависимые задачи станут доступны. Это помогает отслеживать долгую работу и не терять контекст.
beads можно использовать бесплатно? Какая у него лицензия?
beads распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
beads всё ещё поддерживается?
Активно поддерживается. Последний коммит в beads — 19 окт. 2026 г..
Для чего можно использовать beads?
Предоставление кодовому агенту постоянной памяти о задачах в рамках долгих многоэтапных проектов. Координация нескольких агентов, работающих с одним репозиторием в разных ветках. Отслеживание задач планирования отдельно от изменений при участии в open-source-проектах. Изолированное отслеживание задач в CI или в системе контроля версий, отличной от git.
Как установить beads?
Установите bd CLI в масштабе всей системы Перейдите в каталог проекта: cd your-project Инициализируйте beads в проекте: bd init
Где скачать beads?
Исходный код и инструкции по установке — на GitHub: https://github.com/gastownhall/beads

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты