Начало работы

От установки до первого воркспейса менее чем за две минуты. Beadbox использует bd CLI, поэтому вы установите оба инструмента.

1Установить beads CLI

Команда bd — это движок Beadbox. Она управляет вашими задачами, эпиками и зависимостями локально с помощью хранилища на основе Git.

brew install beads

Требуется Homebrew. Устанавливает бинарный файл bd в ваш PATH.

Проверьте установку:

bd --version

Должен отобразиться номер версии. Если команда не найдена, убедитесь, что каталог установки добавлен в ваш PATH.

2Установить Beadbox

Beadbox — нативное десктопное приложение. Выберите установщик для своей платформы.

brew tap beadbox/cask && brew install --cask beadbox

Или скачайте DMG напрямую с GitHub Releases.

Apple Silicon (.dmg)Intel (.dmg)

3Первый запуск

Откройте Beadbox. Что произойдёт дальше, зависит от вашей конфигурации.

Впервые используете beads? Ещё нет воркспейсов?

Beadbox проверяет наличие bd CLI при запуске. Если он не найден, вы увидите экран приветствия с инструкциями по установке и кнопкой "Проверить снова".

Как только bd будет обнаружен, появится карточка Быстрый старт. Выберите папку проекта, нажмите Настроить воркспейс, и Beadbox выполнит bd за вас. Ваш воркспейс готов; все данные остаются локально на вашей машине.

Уже используете bd? Есть существующие воркспейсы?

Beadbox обнаруживает воркспейсы из вашего ~/.beads/registry.json и всех каталогов проектов, содержащих папку .beads/. Нажмите на воркспейс, чтобы открыть его. Дерево эпиков загрузится с индикаторами статуса в реальном времени.

Изменения из терминала распространяются в реальном времени. Выполните bd update <id> --status closed в терминале и наблюдайте, как статус обновится в Beadbox в течение двух секунд, без перезагрузки страницы.

4Что вы увидите

Главный экран состоит из трёх зон:

Главный экран Beadbox с деревом эпиков слева, панелью деталей справа и панелью фильтров сверху

Заголовок

Переключайтесь между воркспейсами, смотрите статус подключения и запускайте обновление вручную. Настройки горячих клавиш тоже здесь.

Панель фильтров

Фильтруйте по статусу, приоритету, исполнителю или полнотекстовому поиску. Сортируйте по обновлению, созданию, приоритету или статусу. Фильтры сохраняются для каждого воркспейса.

Дерево эпиков (слева)

Иерархическое представление ваших эпиков и их дочерних элементов. Раскройте, чтобы увидеть значки статуса, индикаторы приоритета и счётчики прогресса. Нажмите на любой bead, чтобы открыть его детали.

Панель деталей (справа)

Полные метаданные bead: описание, комментарии, зависимости, критерии приёмки. Всё отрендерено в виде markdown.

Следующие шаги