backlog
backlog
Постоянное управление задачами для Claude Code с поддержкой нескольких сессий. Задачи сохраняются между сессиями, поэтому работу, начатую одним агентом, может продолжить другой.
Построено на @backloghq/agentdb — типизированные схемы, автоинкрементные ID, виртуальные фильтры, хранилище BLOB-объектов. Чистый TypeScript, отсутствие нативных зависимостей.
Установка
/plugin marketplace add backloghq/backlog
/plugin install backlog@backloghq-backlogИз исходного кода
git clone https://github.com/backloghq/backlog.git
cd backlog && npm install && npm run build
claude --plugin-dir /path/to/backlogАвтономный MCP-сервер
Добавьте в файл .claude/settings.json вашего проекта:
{
"mcpServers": {
"backlog": {
"command": "node",
"args": ["/path/to/agent-teams-task-mcp/dist/index.js"],
"env": {
"TASKDATA": "/path/to/task-data"
}
}
}
}Related MCP server: MCP Project Manager
Навыки
Навык | Описание |
| Показать текущий бэклог — ожидающие, активные, заблокированные, просроченные задачи |
| Разбить цель на задачи с зависимостями, приоритетами и спецификациями |
| Ежедневный дейли-митинг — сделано, в процессе, заблокировано, следующее |
| Упорядочить бэклог — исправить расплывчатые задачи, отсутствующие приоритеты, нарушенные зависимости, устаревшие элементы |
| Написать документ спецификации для задачи перед реализацией |
| Взять задачу, прочитать спецификацию, реализовать, отметить как выполненную |
| Подготовиться к следующей сессии — аннотировать прогресс, остановить активные задачи, суммировать состояние |
Агент
Агент task-planner может быть автоматически вызван Claude, когда кому-то нужно спланировать работу. Он читает кодовую базу, декомпозирует цели на задачи с зависимостями и пишет спецификации для сложных элементов.
Хуки
Событие | Что делает |
| Показывает количество ожидающих задач при начале сессии |
| Синхронизирует встроенные задачи Claude с постоянным бэклогом |
| Отмечает соответствующую задачу в бэклоге как выполненную, когда Claude завершает встроенную задачу |
| Автоматически назначает нераспределенные ожидающие задачи на созданного агента |
Инструменты (MCP)
Инструменты для управления полным жизненным циклом задачи:
Инструмент | Описание |
| Запрос задач с синтаксисом фильтрации. Возвращает JSON-массив со всеми полями. |
| Подсчет задач, соответствующих фильтру. Тот же синтаксис, что и у task_list. |
| Создание новой ожидающей задачи. Требуется только описание; все остальные поля опциональны. |
| Запись уже выполненной работы непосредственно в статусе завершенной. |
| Частичное обновление одной или нескольких задач, соответствующих фильтру. Изменяются только предоставленные поля. |
| Копирование существующей задачи с опциональной перезаписью полей. |
| Отметка задачи как выполненной с временной меткой завершения. |
| Мягкое удаление задачи. Можно восстановить с помощью task_undo. Используйте task_purge для окончательного удаления. |
| Добавление заметки с временной меткой. Используйте task_doc_write для более длинного контента. |
| Удаление аннотации по точному совпадению текста. |
| Отметка задачи как активно выполняемой. Видна в запросах +ACTIVE. |
| Остановка работы над задачей. Возвращает ее в статус ожидающей. |
| Отмена последней операции. Можно вызывать многократно. |
| Получение полных JSON-данных для одной задачи по ID или UUID. |
| Массовое создание задач из JSON-массива. Атомарная пакетная операция. |
| Окончательное удаление удаленной задачи. Необратимо. |
| Прикрепление/замена markdown-документа к задаче (спецификации, заметки, контекст). |
| Чтение markdown-документа, прикрепленного к задаче. |
| Удаление документа задачи. Навсегда. |
| Перемещение старых завершенных/удаленных задач в квартальные архивные сегменты. |
| Список доступных архивных сегментов. |
| Загрузка архивированных задач для просмотра в режиме только для чтения. |
| Список имен проектов с ожидающими/повторяющимися задачами. |
| Список тегов с ожидающими/повторяющимися задачами. |
Синтаксис фильтров
status:pending # all pending tasks
project:backend +bug # bugs in backend project
priority:H due.before:friday # high priority due before friday
+OVERDUE # overdue tasks
+ACTIVE # tasks currently being worked on
+BLOCKED # tasks blocked by dependencies
+READY # actionable tasks (past scheduled date)
agent:explorer # tasks assigned to the explorer agent
( project:web or project:api ) # boolean with parentheses
description.contains:auth # substring matchПоддерживает модификаторы атрибутов (.before, .after, .by, .has, .not, .none, .any, .startswith, .endswith), теги (+tag, -tag), виртуальные теги (+OVERDUE, +ACTIVE, +BLOCKED, +READY, +TAGGED, +ANNOTATED и т.д.) и логические операторы (and, or).
Документы задач
Прикрепляйте markdown-документы (спецификации, контекст, заметки о передаче дел) к любой задаче:
task_doc_write id:"1" content:"# Spec\n\nBuild the auth flow.\n"
task_doc_read id:"1"
task_doc_delete id:"1"Написание документа добавляет тег +doc и has_doc:yes, чтобы агенты могли находить задачи с документами:
task_list filter:"+doc"
task_list filter:"has_doc:yes"Идентификация агента
Задачи поддерживают поле agent для отслеживания того, какой агент владеет задачей:
task_add description:"Investigate bug" agent:"explorer"
task_list filter:"agent:explorer status:pending"Изоляция проектов
Каждый проект автоматически получает свои собственные данные задач. При использовании в качестве плагина данные задач хранятся в ~/.claude/plugins/data/backlog/projects/<project-slug>/. При автономном использовании установите TASKDATA явно.
Переменная | Описание |
| Явный путь к каталогу данных задач (переопределяет автоматическое определение) |
| Корневой каталог для автоматически определяемых данных задач по проектам |
| Явное имя коллекции (по умолчанию: |
| Установите |
| ID агента для поддержки нескольких авторов (Claude, Gemini и т.д.) |
| Бэкенд хранилища: пропустите для файловой системы (по умолчанию), |
| Имя корзины S3 (требуется, если |
| Регион AWS (опционально, если используются учетные данные по умолчанию) |
Поддержка нескольких авторов
Backlog поддерживает одновременный доступ из нескольких процессов (например, Claude Desktop и Gemini CLI), использующих одни и те же данные. Чтобы включить это:
Назначьте уникальный
BACKLOG_AGENT_IDкаждому процессу (например,claude,gemini).Когда установлен ID агента, движок использует журналы записи для каждого агента, избегая блокировок файлов.
Каждый процесс автоматически вызывает
refresh()перед операциями, чтобы получить изменения от других агентов.
Пространства имен
Если вы хотите использовать один каталог TASKDATA (например, общую корзину S3 или глобальную папку ~/.backlog) для нескольких проектов, вы можете использовать пространства имен, чтобы задачи оставались разделенными:
Вручную: Установите
BACKLOG_NAMESPACE=my-project, чтобы использовать определенное имя коллекции.Автоматически: Установите
BACKLOG_AUTO_NAMESPACE=true, чтобы Backlog автоматически определял имя коллекции из вашей текущей рабочей директории (например,my-app-a1b2c3d4).
Пример конфигурации (.claude/settings.json):
{
"mcpServers": {
"backlog": {
"command": "node",
"args": ["/path/to/backlog/dist/index.js"],
"env": {
"TASKDATA": "/home/user/.backlog",
"BACKLOG_AUTO_NAMESPACE": "true",
"BACKLOG_AGENT_ID": "claude-desktop"
}
}
}
}Оба метода позволяют нескольким проектам использовать один и тот же бэкенд хранилища, сохраняя при этом изолированные бэклоги для конкретных проектов.
Бэкенд S3
Храните данные задач в S3 для совместного использования командой или облачного хранения. Требуется @backloghq/opslog-s3:
npm install @backloghq/opslog-s3Настройте через переменные окружения в .claude/settings.json:
{
"mcpServers": {
"backlog": {
"command": "node",
"args": ["/path/to/backlog/dist/index.js"],
"env": {
"TASKDATA": "my-project/tasks",
"BACKLOG_BACKEND": "s3",
"BACKLOG_S3_BUCKET": "my-team-backlog",
"BACKLOG_S3_REGION": "us-east-1"
}
}
}
}При использовании S3 TASKDATA становится префиксом ключа в корзине вместо пути к файловой системе.
Docker
docker build -t backlog .
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
| docker run --rm -i backlogРазработка
npm install
npm run build # compile TypeScript
npm run lint # run ESLint
npm test # run tests
npm run test:coverage # run tests with coverage
npm run dev # watch modeСообщество
GitHub Discussions — вопросы, идеи, демонстрации
Issue Tracker — отчеты об ошибках и запросы функций
Документация — полная документация, справочник навыков, синтаксис фильтров
Если backlog полезен для вас, подумайте о том, чтобы поставить звезду — это помогает другим найти проект.
Лицензия
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool has a distinct, clearly separated purpose with explicit cross-references in descriptions (e.g., 'use task_log instead', 'use task_doc_write instead'). No overlapping functionality—CRUD, lifecycle, archival, and document operations are cleanly partitioned.
Strict snake_case convention with consistent 'task_' prefix. Sub-resources follow predictable patterns (task_doc_read/write/delete, task_archive_list/load). Verbs are clear and consistently placed (task_add, task_delete, task_modify).
24 tools is above the typical ideal range but justified by the domain complexity. The set covers full task lifecycle, document attachments, archival management, annotations, and discovery without redundancy. Each tool earns its place for a comprehensive backlog system.
Excellent coverage of CRUD, status workflow (start/stop/done), soft-delete with purge, annotations, document attachments, and archival. Minor gap: archived tasks are view-only with no restore-to-active operation, though this appears to be an intentional cold-storage design.
Maintenance
Related MCP Connectors
Project management shared by people and AI agents, with persistent project state through MCP.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
A task list shared by you and your coding agents (Claude Code, Cursor, Codex and any MCP client). Agents plan each task into steps, report live progress to a board, and block on questions you answer from your phone.
Related MCP Servers
- AlicenseAqualityCmaintenancePersistent memory and task board for Claude Code. 14 tools spanning projects, tasks, sessions, and activity logs — backed by Firestore, runs on the free tier. Handoff notes survive context compaction; the next session reads the last handoff and picks up where you stopped.14MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive project management and workflow tracking system that integrates with Claude Code via MCP, automatically capturing sessions, tools, agents, and project tasks into a centralized dashboard and database.13 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server for project planning inside Claude. It tracks progress, knows your codebase, and resumes exactly where you left off every session.7 npm5-
- FlicenseNot gradedqualityDmaintenanceProvides memory and project tracking for Claude Code via MCP, enabling semantic search over past transcripts, durable notes, and structured project management with milestones, epics, tickets, and todos.-