Skip to main content
Glama
deenesjakoruzh
backloghq

backlog

by backloghq
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

backlog

GitHub stars License: MIT CI Docs

Persistente, sitzungsübergreifende Aufgabenverwaltung für Claude Code. Aufgaben bleiben über Sitzungen hinweg erhalten, sodass Arbeit, die von einem Agenten begonnen wurde, von einem anderen fortgesetzt werden kann.

Basiert auf @backloghq/agentdb — typisierte Schemas, automatisch inkrementierende IDs, virtuelle Filter, Blob-Speicherung. Reines TypeScript, keine nativen Abhängigkeiten.

Installation

/plugin marketplace add backloghq/backlog
/plugin install backlog@backloghq-backlog

Aus dem Quellcode

git clone https://github.com/backloghq/backlog.git
cd backlog && npm install && npm run build
claude --plugin-dir /path/to/backlog

Standalone MCP-Server

Fü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"
      }
    }
  }
}

Skills

Skill

Beschreibung

/backlog:tasks

Zeigt das aktuelle Backlog an — ausstehende, aktive, blockierte, überfällige Aufgaben

/backlog:plan

Zerlegt ein Ziel in Aufgaben mit Abhängigkeiten, Prioritäten und Spezifikationen

/backlog:standup

Tägliches Standup — erledigt, in Bearbeitung, blockiert, als Nächstes

/backlog:refine

Backlog-Pflege — vage Aufgaben korrigieren, fehlende Prioritäten ergänzen, defekte Abhängigkeiten beheben, veraltete Elemente entfernen

/backlog:spec

Schreibt ein Spezifikationsdokument für eine Aufgabe vor der Implementierung

/backlog:implement

Wählt eine Aufgabe aus, liest deren Spezifikation, implementiert sie und markiert sie als erledigt

/backlog:handoff

Vorbereitung auf die nächste Sitzung — Fortschritt kommentieren, aktive Aufgaben stoppen, Status zusammenfassen

Agent

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.

Hooks

Ereignis

Was es bewirkt

SessionStart

Zeigt die Anzahl der ausstehenden Aufgaben zu Beginn einer Sitzung an

TaskCreated

Synchronisiert Claudes integrierte Aufgaben mit dem persistenten Backlog

TaskCompleted

Markiert die entsprechende Backlog-Aufgabe als erledigt, wenn Claude eine integrierte Aufgabe abschließt

SubagentStart

Weist nicht zugewiesene, ausstehende Aufgaben automatisch dem erzeugten Agenten zu

Tools (MCP)

24 Tools für das vollständige Aufgaben-Lebenszyklusmanagement:

Tool

Beschreibung

task_list

Fragt Aufgaben mit Filtersyntax ab. Gibt ein JSON-Array mit allen Feldern zurück.

task_count

Zählt Aufgaben, die einem Filter entsprechen. Gleiche Syntax wie task_list.

task_add

Erstellt eine neue ausstehende Aufgabe. Nur Beschreibung erforderlich; alle anderen Felder optional.

task_log

Protokolliert bereits abgeschlossene Arbeit direkt im Status „erledigt“.

task_modify

Teil-Update einer oder mehrerer Aufgaben, die einem Filter entsprechen. Nur bereitgestellte Felder werden geändert.

task_duplicate

Kopiert eine bestehende Aufgabe mit optionalen Feldüberschreibungen.

task_done

Markiert eine Aufgabe als abgeschlossen mit End-Zeitstempel.

task_delete

Löscht eine Aufgabe (Soft-Delete). Wiederherstellbar mit task_undo. Verwenden Sie task_purge zum dauerhaften Entfernen.

task_annotate

Fügt eine mit Zeitstempel versehene Notiz hinzu. Verwenden Sie task_doc_write für längere Inhalte.

task_denotate

Entfernt eine Anmerkung durch exakten Textabgleich.

task_start

Markiert eine Aufgabe als aktiv in Bearbeitung. Sichtbar in +ACTIVE-Abfragen.

task_stop

Stoppt die Arbeit an einer Aufgabe. Setzt sie zurück in den Status „ausstehend“.

task_undo

Macht den letzten Vorgang rückgängig. Kann wiederholt aufgerufen werden.

task_info

Ruft vollständige JSON-Details für eine einzelne Aufgabe per ID oder UUID ab.

task_import

Erstellt Aufgaben in großen Mengen aus einem JSON-Array. Atomarer Batch-Vorgang.

task_purge

Entfernt eine gelöschte Aufgabe dauerhaft. Nicht umkehrbar.

task_doc_write

Hängt ein Markdown-Dokument an eine Aufgabe an oder ersetzt es (Spezifikationen, Notizen, Kontext).

task_doc_read

Liest das an eine Aufgabe angehängte Markdown-Dokument.

task_doc_delete

Entfernt das Dokument einer Aufgabe. Dauerhaft.

task_archive

Verschiebt alte abgeschlossene/gelöschte Aufgaben in vierteljährliche Archivsegmente.

task_archive_list

Listet verfügbare Archivsegmente auf.

task_archive_load

Lädt archivierte Aufgaben zur schreibgeschützten Überprüfung.

task_projects

Listet Projektnamen mit ausstehenden/wiederkehrenden Aufgaben auf.

task_tags

Listet Tags mit ausstehenden/wiederkehrenden Aufgaben auf.

Filtersyntax

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

Unterstützt Attribut-Modifikatoren (.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).

Aufgabendokumente

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"

Agentenidentität

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"

Projektisolierung

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

TASKDATA

Expliziter Pfad zum Aufgabendatenverzeichnis (überschreibt automatische Ableitung)

TASKDATA_ROOT

Stammverzeichnis für automatisch abgeleitete projektbezogene Aufgabendaten

BACKLOG_BACKEND

Speicher-Backend: weglassen für Dateisystem (Standard), s3 für Amazon S3

BACKLOG_S3_BUCKET

S3-Bucket-Name (erforderlich, wenn BACKLOG_BACKEND=s3)

BACKLOG_S3_REGION

AWS-Region (optional bei Verwendung von Standard-Anmeldeinformationen)

S3-Backend

Speichern Sie Aufgabendaten in S3 für die Teamfreigabe oder Cloud-Persistenz. Erfordert @backloghq/opslog-s3:

npm install @backloghq/opslog-s3

Konfiguration ü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

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

Entwicklung

npm install
npm run build          # compile TypeScript
npm run lint           # run ESLint
npm test               # run tests (189 tests)
npm run test:coverage  # run tests with coverage
npm run dev            # watch mode

Community

Wenn backlog für Sie nützlich ist, ziehen Sie in Betracht, einen Stern zu vergeben — es hilft anderen, das Projekt zu finden.

Lizenz

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/backloghq/backlog'

If you have feedback or need assistance with the MCP directory API, please join our Discord server