kata

Local-first трекер задач для разработки с участием ИИ. Два интерфейса поверх одного локального демона на базе SQLite: стабильный CLI с выводом в JSON для агентов и интерактивный TUI для контролирующего их человека. Задачи получают короткие идентификаторы на основе ULID (kata#abc4), append-only историю событий и привычные связи (родитель/потомок, блокирует/заблокирована, связано). Входит в состав kenn-software-suite - набора однобинарных local-first инструментов для работы с агентами.

Для чего это нужно

Структурированное место для задач, решений, ссылок, комментариев и изменений статуса - отдельно от GitHub Issues или плана в markdown, который агент переписывает на каждом шаге. Агент фиксирует работу в надёжном журнале; человек сортирует задачи и контролирует процесс через TUI. Чётко очерченные границы проекта: kata позиционируется как "надёжный журнал задач", а не "система управления проектами, движок для рабочих процессов в git или пул рабочих агентов".

Как это устроено внутри

Состояние хранится в локальной базе данных SQLite в KATA_HOME (по умолчанию ~/.kata), за которой следит один долгоживущий демон. И CLI, и TUI обращаются к этому демону, поэтому у базы всегда один писатель и консистентное представление данных. Поток событий - append-only и персистентный, благодаря чему работают журнал аудита и отслеживание через --tail: агент или наблюдатель могут следить за изменениями в реальном времени, не опрашивая списки заново.

Ключевое архитектурное решение - хранить состояние задач вне репозитория, что прямо противоположно подходу beads (база Dolt коммитится вместе с кодом) и git-bug (задачи хранятся как объекты git). Компромиссы:

• Меньше следов в репозитории - workspace привязывается только через закоммиченный .kata.toml с возможностью переопределения через .kata.local.toml для отдельных разработчиков.
• Одинаково работает в каталогах без git.
• История задач отделена от истории кода, а не версионируется вместе с ней: здесь нет слияния веток с задачами, как в beads, но нет и конфликтов слияния в хранилище задач.

Предусмотрен опциональный режим удалённого демона для закрытых сетей, но в нём нет аутентификации - это исключительно удобство для доверенных LAN, а не общий сервер.

Базовое использование

go install github.com/kenn-io/kata/cmd/kata@latest

kata init                       # bind workspace, writes .kata.toml
kata create "fix login race"    # returns a short_id, e.g. abc4
kata list                       # open issues
kata show abc4
kata close abc4 --done --message "Fixed; tests pass." --commit <sha>
kata tui                        # interactive triage

Другие возможности: метки, назначение ответственных, мягкое удаление/восстановление/очистка, поиск, проекты, дайджест-сводки по исполнителям за период времени, а также экспорт/импорт в JSONL для резервных копий и миграций схемы.

Ограничения

• Нет аутентификации ни в локальном, ни в удалённом режиме - только для доверенных окружений.
• Импорт всегда создаёт чистую базу данных; нет слияния отдельных проектов и инкрементального повторного импорта снапшотов.
• Общий многопользовательский серверный режим пока только в планах.
• Интерфейс команд всё ещё может измениться - см. примечание о watchlist ниже.

Watchlist

Ранняя публичная предварительная версия: инструмент пригоден для использования (CLI, демон и TUI работают), но стабильность сигнатур команд явно не гарантируется, и тегированных релизов пока нет. Отслеживается в watchlist для повторной проверки зрелости.

Связанные страницы

• beads - ближайший аналог; противоположная философия хранения (Dolt внутри репозитория против SQLite снаружи). Оба инструмента дают агентам структурированный граф задач вместо списка TODO в markdown.
• forge - находится на том же уровне "CLI для агентов", но связывает с удалёнными forge-платформами (GitHub/GitLab/Gitea); kata же служит локальным журналом задач.
• kenn-software-suite - остальные local-first инструменты для агентов от Kenn Software.

Репозиторий

github.com/kenn-io/kata - Go (1.26+), MIT, 210 звёзд, пока без тегированных релизов (ранняя публичная предварительная версия). macOS/Linux/Windows.