Persistente, sitzungsübergreifende Aufgabenverwaltung für Claude Code. Aufgaben überdauern Sitzungen, sodass Arbeit, die von einem Agenten begonnen wurde, von einem anderen fortgesetzt werden kann.
Aufgebaut auf @backloghq/agentdb — typisierte Schemas, automatisch inkrementierende IDs, virtuelle Filter, Blob-Speicherung. Reines TypeScript, keine nativen Abhängigkeiten.
/plugin marketplace add backloghq/backlog
/plugin install backlog@backloghq-backloggit clone https://github.com/backloghq/backlog.git
cd backlog && npm install && npm run build
claude --plugin-dir /path/to/backlogFügen Sie dies zur .claude/settings.json Ihres Projekts hinzu:
{
"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
Skill | Beschreibung |
| Zeigt den aktuellen Backlog an — ausstehende, aktive, blockierte, überfällige Aufgaben |
| Zerlegt ein Ziel in Aufgaben mit Abhängigkeiten, Prioritäten und Spezifikationen |
| Tägliches Standup — erledigt, in Bearbeitung, blockiert, als Nächstes |
| Backlog-Pflege — vage Aufgaben korrigieren, fehlende Prioritäten ergänzen, defekte Abhängigkeiten beheben, veraltete Elemente entfernen |
| Schreibt ein Spezifikationsdokument für eine Aufgabe vor der Implementierung |
| Wählt eine Aufgabe aus, liest deren Spezifikation, implementiert sie und markiert sie als erledigt |
| Vorbereitung auf die nächste Sitzung — Fortschritt kommentieren, aktive Aufgaben stoppen, Status zusammenfassen |
Der task-planner-Agent kann automatisch von Claude aufgerufen werden, wenn Arbeit geplant werden muss. Er liest die Codebasis, zerlegt Ziele in Aufgaben mit Abhängigkeiten und schreibt Spezifikationen für komplexe Elemente.
Ereignis | Was es bewirkt |
| Zeigt die Anzahl der ausstehenden Aufgaben zu Beginn einer Sitzung an |
| Synchronisiert Claudes integrierte Aufgaben mit dem persistenten Backlog |
| Markiert die entsprechende Backlog-Aufgabe als erledigt, wenn Claude eine integrierte Aufgabe abschließt |
| Weist nicht zugewiesene, ausstehende Aufgaben automatisch dem erzeugten Agenten zu |
Tools für die vollständige Verwaltung des Aufgabenlebenszyklus:
Tool | Beschreibung |
| Fragt Aufgaben mit Filtersyntax ab. Gibt ein JSON-Array mit allen Feldern zurück. |
| Zählt Aufgaben, die einem Filter entsprechen. Gleiche Syntax wie task_list. |
| Erstellt eine neue ausstehende Aufgabe. Nur die Beschreibung ist erforderlich; alle anderen Felder sind optional. |
| Protokolliert bereits abgeschlossene Arbeit direkt im Status „erledigt“. |
| Teilweise Aktualisierung einer oder mehrerer Aufgaben, die einem Filter entsprechen. Nur bereitgestellte Felder werden geändert. |
| Kopiert eine bestehende Aufgabe mit optionalen Feldüberschreibungen. |
| Markiert eine Aufgabe mit Endzeitstempel als erledigt. |
| Löscht eine Aufgabe (Soft-Delete). Wiederherstellbar mit task_undo. Verwenden Sie task_purge zum dauerhaften Entfernen. |
| Fügt eine mit Zeitstempel versehene Notiz hinzu. Verwenden Sie task_doc_write für längere Inhalte. |
| Entfernt eine Anmerkung durch exakten Textabgleich. |
| Markiert eine Aufgabe als aktiv in Bearbeitung. Sichtbar in +ACTIVE-Abfragen. |
| Stoppt die Arbeit an einer Aufgabe. Setzt sie zurück in den Status „ausstehend“. |
| Macht den letzten Vorgang rückgängig. Kann wiederholt aufgerufen werden. |
| Ruft vollständige JSON-Details für eine einzelne Aufgabe per ID oder UUID ab. |
| Erstellt Aufgaben in großen Mengen aus einem JSON-Array. Atomarer Batch-Vorgang. |
| Entfernt eine gelöschte Aufgabe dauerhaft. Nicht umkehrbar. |
| Hängt ein Markdown-Dokument an eine Aufgabe an oder ersetzt es (Spezifikationen, Notizen, Kontext). |
| Liest das an eine Aufgabe angehängte Markdown-Dokument. |
| Entfernt das Dokument einer Aufgabe. Dauerhaft. |
| Verschiebt alte erledigte/gelöschte Aufgaben in vierteljährliche Archivsegmente. |
| Listet verfügbare Archivsegmente auf. |
| Lädt archivierte Aufgaben zur schreibgeschützten Überprüfung. |
| Listet Projektnamen mit ausstehenden/wiederkehrenden Aufgaben auf. |
| Listet Tags mit ausstehenden/wiederkehrenden Aufgaben auf. |
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 matchUnterstützt Attributmodifikatoren (.before, .after, .by, .has, .not, .none, .any, .startswith, .endswith), Tags (+tag, -tag), virtuelle Tags (+OVERDUE, +ACTIVE, +BLOCKED, +READY, +TAGGED, +ANNOTATED usw.) und boolesche Operatoren (and, or).
Hängen Sie Markdown-Dokumente (Spezifikationen, Kontext, Übergabenotizen) an jede Aufgabe an:
task_doc_write id:"1" content:"# Spec\n\nBuild the auth flow.\n"
task_doc_read id:"1"
task_doc_delete id:"1"Das Schreiben eines Dokuments fügt ein +doc-Tag und has_doc:yes hinzu, sodass Agenten Aufgaben mit Dokumenten entdecken können:
task_list filter:"+doc"
task_list filter:"has_doc:yes"Aufgaben unterstützen ein agent-Feld zur Nachverfolgung, welcher Agent eine Aufgabe besitzt:
task_add description:"Investigate bug" agent:"explorer"
task_list filter:"agent:explorer status:pending"Jedes Projekt erhält automatisch seine eigenen Aufgabendaten. Bei Verwendung als Plugin befinden sich die Aufgabendaten unter ~/.claude/plugins/data/backlog/projects/<project-slug>/. Bei eigenständiger Verwendung setzen Sie TASKDATA explizit.
Variable | Beschreibung |
| Expliziter Pfad zum Aufgabendatenverzeichnis (überschreibt die automatische Ableitung) |
| Stammverzeichnis für automatisch abgeleitete projektbezogene Aufgabendaten |
| Expliziter Sammlungsname (Standard: |
| Auf |
| Agenten-ID für Unterstützung mehrerer Schreibzugriffe (Claude, Gemini usw.) |
| Speicher-Backend: weglassen für Dateisystem (Standard), |
| S3-Bucket-Name (erforderlich, wenn |
| AWS-Region (optional bei Verwendung von Standard-Anmeldeinformationen) |
Backlog unterstützt den gleichzeitigen Zugriff von mehreren Prozessen (z. B. Claude Desktop und Gemini CLI), die dieselben Daten teilen. Um dies zu aktivieren:
Weisen Sie jedem Prozess eine eindeutige BACKLOG_AGENT_ID zu (z. B. claude, gemini).
Wenn eine Agenten-ID festgelegt ist, verwendet die Engine agentenspezifische Schreibprotokolle, wodurch Dateisperren vermieden werden.
Jeder Prozess ruft vor Vorgängen automatisch refresh() auf, um Änderungen von anderen Agenten zu übernehmen.
Wenn Sie ein einzelnes TASKDATA-Verzeichnis (wie einen gemeinsam genutzten S3-Bucket oder einen globalen ~/.backlog-Ordner) für mehrere Projekte verwenden möchten, können Sie Namespaces verwenden, um Aufgaben getrennt zu halten:
Manuell: Setzen Sie BACKLOG_NAMESPACE=my-project, um einen bestimmten Sammlungsnamen zu verwenden.
Automatisch: Setzen Sie BACKLOG_AUTO_NAMESPACE=true, damit Backlog automatisch einen Sammlungsnamen aus Ihrem aktuellen Arbeitsverzeichnis ableitet (z. B. my-app-a1b2c3d4).
Beispielkonfiguration (.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"
}
}
}
}Beide Methoden ermöglichen es mehreren Projekten, dasselbe Speicher-Backend zu nutzen und gleichzeitig isolierte, projektspezifische Backlogs beizubehalten.
Speichern Sie Aufgabendaten in S3 für die Teamfreigabe oder Cloud-Persistenz. Erfordert @backloghq/opslog-s3:
npm install @backloghq/opslog-s3Konfiguration über Umgebungsvariablen in .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"
}
}
}
}Bei Verwendung von S3 wird TASKDATA zum Schlüsselpräfix im Bucket anstelle eines Dateisystempfads.
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 backlognpm 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 modeGitHub Discussions — Fragen, Ideen, Show & Tell
Issue Tracker — Fehlerberichte und Funktionsanfragen
Dokumentation — vollständige Dokumentation, Skills-Referenz, Filtersyntax
Wenn Backlog für Sie nützlich ist, ziehen Sie in Betracht, ihm einen Stern zu geben — es hilft anderen, das Projekt zu finden.
MIT
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
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.
