AgentBoard

Локальный трекер задач в духе Linear — для совместной работы человека и AI-агентов (Claude Code и других). Все данные — обычные markdown-файлы в vault-папке: видны и редактируемы в любом текстовом редакторе, версионируются прямо внутри файла, без git.

Зачем

Агентам, которые работают над проектом в фоне, нужен способ вести задачи так, чтобы человек видел прогресс визуально (канбан-доска, как в Linear), а сам агент не терял план работ между сессиями и не тратил лишний контекст на навигацию. AgentBoard даёт:

• Канбан-доску — проекты слева (сворачиваемая панель), задачи по статусам справа.
• Версионные "апдейты" — осознанные чекпоинты эволюции сути задачи (резюме "что и почему" + полный снимок описания), отдельно от обычных комментариев и от технической активности (статусы/поля), которая свёрнута по умолчанию.
• Подзадачи как полноценные сущности со своим статусом, а не чек-листы.
• get_next_task — агент спрашивает "что делать дальше" вместо перебора всего списка.
• MCP-сервер для агентов + документированный формат файлов для прямого доступа (см. AGENTS.md), если MCP недоступен.

Структура

src/core/    общая логика: парсинг/запись markdown, версии, подзадачи, next-task
src/server/  Fastify REST API + WebSocket + отдаёт собранный web/dist
src/mcp/     MCP-сервер для агентов (см. AGENTS.md)
web/         React + Vite + Tailwind фронтенд (Kanban-доска, детали задачи)
vault/       данные по умолчанию — проекты и задачи в markdown

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

npm install
npm --prefix web install

# демо-данные (один раз)
npm run seed

# API-сервер (порт 4173) и фронтенд (порт 5173) — в двух терминалах
npm run dev:server
npm run dev:web

Откройте http://127.0.0.1:5173.

Для продакшн-режима (один процесс, один порт):

npm run build        # соберёт web/dist и скомпилирует сервер
npm start             # отдаёт всё на http://127.0.0.1:4173

Путь к vault настраивается переменной окружения AGENTBOARD_VAULT (по умолчанию ./vault).

Подключение агента (MCP)

См. AGENTS.md — конвенция трёх типов записей (комментарии/апдейты/активность), таблица MCP-инструментов и формат файлов для прямого доступа.

Тесты

npm test

Лицензия

MIT — см. LICENSE. Свободно используйте, форкайте, разворачивайте у себя.