agent-tasks

Управление задачами на основе конвейеров для ИИ-агентов, пишущих код. Сервер MCP с поэтапными конвейерами, совместной работой нескольких агентов и канбан-панелью в реальном времени. Задачи проходят через настраиваемые этапы — backlog, spec, plan, implement, test, review, done — с отслеживанием зависимостей, рабочими процессами утверждения, версионированием артефактов и ветками комментариев.

Создан для ИИ-агентов, пишущих код (Claude Code, Codex CLI, Gemini CLI, Aider), но одинаково хорошо работает с любым MCP-клиентом, REST-потребителем или WebSocket-слушателем.

Зачем agent-tasks?

Когда вы запускаете несколько ИИ-агентов в одной кодовой базе, им нужен общий конвейер задач — а не просто плоский список дел. Им нужны этапы, зависимости, утверждения и видимость.

Related MCP server: Agent Harness Kit

Возможности

• Этапы конвейера — настраиваются для каждого проекта: backlog > spec > plan > implement > test > review > done

• Зависимости задач — DAG с автоматическим обнаружением циклов; блокирует продвижение до разрешения

• Рабочие процессы утверждения — поэтапные approve/reject с автоматическим откатом при отклонении

• Совместная работа нескольких агентов — роли (collaborator, reviewer, watcher), взятие задач, назначение

• Иерархии подзадач — деревья родительских/дочерних задач с отслеживанием прогресса

• Ветки комментариев — асинхронные обсуждения между агентами по любой задаче

• Версионирование артефактов — вложения документов на каждом этапе с автоматическим версионированием и просмотром различий

• Полнотекстовый поиск — поиск FTS5 по заголовкам и описаниям задач

• Канбан-панель в реальном времени — перетаскивание, боковая панель, создание на месте, тёмная/светлая тема

• 3 транспортных уровня — MCP (stdio), REST API (HTTP), WebSocket (события в реальном времени)

• Мост TodoWrite — перехватывает встроенный TodoWrite от Claude Code и синхронизирует с конвейером

• Этапные шлюзы — настраиваемые шлюзы для каждого проекта с правилами для каждого этапа: требуйте именованные артефакты, минимальное количество артефактов, комментарии или утверждения перед продвижением

• Журнал решений — структурированные артефакты решений (выбрали X вместо Y, потому что Z) через task_artifact(type: "decision")

• Распространение знаний — task_artifact(type: "learning") фиксирует инсайты (техника, подводный камень, решение, паттерн); автоматически распространяется на родительские и дочерние задачи при завершении

• Привязка агентов — task_list(next: true) предпочитает направлять задачи агентам со связанной историей (родитель, зависимость, проект) как критерий разрешения ничьей

• Очистка на основе heartbeat — автоматически помечает задачи как проваленные от мёртвых агентов, используя данные heartbeat от agent-comm

• Хуки очистки задач — автоматически помечает осиротевшие задачи как проваленные при остановке сеанса и очищает устаревшие задачи при запуске сеанса

• Мост агентов — уведомляет подключённых агентов о событиях задач (взятие, продвижение, комментарий, утверждение)

• Мост знаний — автоматически отправляет артефакты обучения и решений в agent-knowledge при завершении задачи, с индексацией эмбеддингов и автоматической привязкой

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

Установка из npm

npm install -g agent-tasks

Или клонировать из исходного кода

git clone https://github.com/keshrath/agent-tasks.git
cd agent-tasks
npm install
npm run build

Вариант 1: MCP-сервер (для ИИ-агентов)

Добавьте в конфигурацию вашего MCP-клиента (Claude Code, Cline и т.д.):

{
  "mcpServers": {
    "agent-tasks": {
      "command": "npx",
      "args": ["agent-tasks"]
    }
  }
}

Панель управления автоматически запускается на http://localhost:3422 при первом MCP-подключении.

Вариант 2: Автономный сервер (для REST/WebSocket клиентов)

node dist/server.js --port 3422

Интеграция с Claude Code

После настройки (см. Быстрый старт выше) Claude Code может напрямую использовать все 8 MCP-инструментов — создавать задачи, продвигать этапы, добавлять артефакты, комментировать и многое другое. Подробные шаги по интеграции см. в Руководстве по настройке.

MCP-инструменты (8)

См. полную справку по API с подробным описанием каждого инструмента и конечной точки.

REST API (18 конечных точек)

Все конечные точки возвращают JSON. CORS включён. Подробнее см. в полной справке по API.

GET  /health                          Health check with version + uptime
GET  /api/tasks                       List tasks (status, stage, project, assignee filters)
GET  /api/tasks/:id                   Get a single task
GET  /api/tasks/:id/subtasks          Subtasks of a parent
GET  /api/tasks/:id/artifacts         Artifacts (filter by stage)
GET  /api/tasks/:id/comments          Comments on a task
GET  /api/tasks/:id/dependencies      Dependencies for a task
GET  /api/dependencies                All dependencies across all tasks
GET  /api/pipeline                    Pipeline stage configuration
GET  /api/overview                    Full state dump
GET  /api/agents                      Online agents
GET  /api/search?q=                   Full-text search

POST /api/tasks                       Create a new task
PUT  /api/tasks/:id                   Update task fields
PUT  /api/tasks/:id/stage             Change stage (advance or regress)
POST /api/tasks/:id/comments          Add a comment
POST /api/cleanup                     Trigger manual cleanup

Тестирование

npm test              # 355 tests across 13 files
npm run test:watch    # Watch mode
npm run test:coverage # Coverage report
npm run check         # Full CI: typecheck + lint + format + test

Переменные окружения

Зависимости

Обязательные: Node.js >= 20.11, better-sqlite3 (в комплекте)

Необязательные (мягкие зависимости — отказоустойчивые, только HTTP, без npm-зависимостей):

• agent-comm — очистка задач на основе heartbeat и уведомления о событиях. agent-comm отслеживает heartbeat → agent-tasks проверяет heartbeat → автоматически помечает задачи от мёртвых агентов как проваленные. Также отправляет прямые сообщения при взятии/продвижении и публикует в каналы при комментариях/утверждениях. Без agent-comm обнаружение устаревших агентов и уведомления gracefully пропускаются.

• agent-knowledge — постоянное хранение знаний о задачах и решений. При завершении задачи KnowledgeBridge отправляет артефакты learning и decision в agent-knowledge через POST /api/knowledge. Записи автоматически индексируются с эмбеддингами, автоматически связываются с похожими записями и синхронизируются с git. Без agent-knowledge артефакты остаются только в agent-tasks.

Документация

• Справка по API — все 8 MCP-инструментов, 18 REST конечных точек, протокол WebSocket

• Архитектура — структура исходного кода, принципы проектирования, схема базы данных

• Панель управления — функции канбан-доски, сочетания клавиш, скриншоты

• Руководство по настройке — установка, настройка клиентов (Claude Code, OpenCode, Cursor, Windsurf), хуки

• Журнал изменений

Лицензия

MIT — см. LICENSE