agent-tasks

Pipeline-gesteuertes Aufgabenmanagement für KI-Codierungsagenten. Ein MCP-Server mit stufenweise gesteuerten Pipelines, Multi-Agenten-Kollaboration und einem Echtzeit-Kanban-Dashboard. Aufgaben durchlaufen konfigurierbare Stufen — backlog, spec, plan, implement, test, review, done — mit Abhängigkeitsverfolgung, Genehmigungsworkflows, Artefaktversionierung und verschachtelten Kommentaren.

Entwickelt für KI-Codierungsagenten (Claude Code, Codex CLI, Gemini CLI, Aider), funktioniert aber ebenso gut mit jedem MCP-Client, REST-Consumer oder WebSocket-Listener.

Warum agent-tasks?

Wenn Sie mehrere KI-Agenten auf derselben Codebasis ausführen, benötigen sie eine gemeinsame Aufgabenpipeline – nicht nur eine flache To-do-Liste. Sie brauchen Stufen, Abhängigkeiten, Genehmigungen und Transparenz.

Related MCP server: agent-runtime-mcp

Funktionen

• Pipeline-Stufen — pro Projekt konfigurierbar: backlog > spec > plan > implement > test > review > done

• Aufgabenabhängigkeiten — DAG mit automatischer Zykluserkennung; blockiert Fortschritt, bis aufgelöst

• Genehmigungsworkflows — stufenbasierte Genehmigung/Ablehnung mit automatischem Rückschritt bei Ablehnung

• Multi-Agenten-Kollaboration — Rollen (collaborator, reviewer, watcher), Beanspruchung, Zuweisung

• Unteraufgaben-Hierarchien — Eltern-/Kind-Aufgabenbäume mit Fortschrittsverfolgung

• Verschachtelte Kommentare — asynchrone Diskussionen zwischen Agenten zu jeder Aufgabe

• Artefaktversionierung — Dokumentanhänge pro Stufe mit automatischer Versionierung und Diff-Viewer

• Volltextsuche — FTS5-Suche über Aufgabentitel und -beschreibungen

• Echtzeit-Kanban-Dashboard — Drag-and-drop, Seitenpanel, Inline-Erstellung, dunkles/helles Design

• 3 Transportschichten — MCP (stdio), REST-API (HTTP), WebSocket (Echtzeit-Ereignisse)

• TodoWrite-Brücke — fängt Claude Codes integriertes TodoWrite ab und synchronisiert es mit der Pipeline

• Stufen-Gates — konfigurierbare Gates pro Projekt mit Regeln pro Stufe: benannte Artefakte, Mindestanzahl an Artefakten, Kommentare oder Genehmigungen erforderlich, bevor fortgefahren wird

• Entscheidungsprotokoll — strukturierte Entscheidungsartefakte (X statt Y gewählt, weil Z) über task_artifact(type: "decision")

• Weitergabe von Erkenntnissen — task_artifact(type: "learning") erfasst Einsichten (Technik, Stolperfalle, Entscheidung, Muster); wird bei Abschluss automatisch an übergeordnete und verwandte Aufgaben weitergegeben

• Agenten-Affinität — task_list(next: true) bevorzugt die Weiterleitung von Aufgaben an Agenten mit verwandter Historie (übergeordnet, abhängig, Projekt) als Tie-Breaker

• Heartbeat-basierte Bereinigung — schlägt Aufgaben von toten Agenten automatisch fehl, basierend auf agent-comm-Heartbeat-Daten

• Aufgabenbereinigungs-Hooks — schlägt verwaiste Aufgaben beim Stoppen der Sitzung automatisch fehl und bereinigt veraltete Aufgaben beim Start der Sitzung

• Agenten-Brücke — benachrichtigt verbundene Agenten über Aufgabenereignisse (Beanspruchung, Fortschritt, Kommentar, Genehmigung)

• Wissensbrücke — überträgt automatisch Lern- und Entscheidungsartefakte an agent-knowledge bei Aufgabenabschluss, mit Embedding-Indexierung und automatischer Verlinkung

Schnellstart

Installation über npm

npm install -g agent-tasks

Oder aus dem Quellcode klonen

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

Option 1: MCP-Server (für KI-Agenten)

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (Claude Code, Cline usw.):

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

Das Dashboard startet automatisch unter http://localhost:3422 bei der ersten MCP-Verbindung.

Option 2: Eigenständiger Server (für REST/WebSocket-Clients)

node dist/server.js --port 3422

Claude-Code-Integration

Nach der Konfiguration (siehe Schnellstart oben) kann Claude Code alle 8 MCP-Tools direkt verwenden – Aufgaben erstellen, Stufen vorantreiben, Artefakte hinzufügen, kommentieren und mehr. Detaillierte Integrationsschritte finden Sie im Setup-Leitfaden.

MCP-Tools (8)

Siehe vollständige API-Referenz für detaillierte Beschreibungen jedes Tools und Endpunkts.

REST-API (18 Endpunkte)

Alle Endpunkte geben JSON zurück. CORS ist aktiviert. Details finden Sie in der vollständigen API-Referenz.

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

Testen

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

Umgebungsvariablen

Abhängigkeiten

Erforderlich: Node.js >= 20.11, better-sqlite3 (gebündelt)

Optional (weiche Abhängigkeiten — Fail-Open, nur HTTP, keine npm-Abhängigkeit):

• agent-comm — Heartbeat-basierte Aufgabenbereinigung und Ereignisbenachrichtigungen. agent-comm verfolgt Heartbeats → agent-tasks prüft Heartbeats → schlägt Aufgaben von toten Agenten automatisch fehl. Sendet außerdem direkte Nachrichten bei Beanspruchung/Fortschritt und postet in Kanäle bei Kommentaren/Genehmigungen. Ohne agent-comm werden die Erkennung veralteter Agenten und Benachrichtigungen elegant übersprungen.

• agent-knowledge — Wissenspersistenz für Aufgaben-Erkenntnisse und Entscheidungen. Bei Aufgabenabschluss überträgt die KnowledgeBridge learning- und decision-Artefakte über POST /api/knowledge an agent-knowledge. Einträge werden automatisch mit Embeddings indiziert, automatisch mit ähnlichen Einträgen verknüpft und mit Git synchronisiert. Ohne agent-knowledge bleiben Artefakte nur in agent-tasks.

Dokumentation

• API-Referenz — alle 8 MCP-Tools, 18 REST-Endpunkte, WebSocket-Protokoll

• Architektur — Quellstruktur, Designprinzipien, Datenbankschema

• Dashboard — Kanban-Board-Funktionen, Tastaturkürzel, Screenshots

• Setup-Leitfaden — Installation, Client-Einrichtung (Claude Code, OpenCode, Cursor, Windsurf), Hooks

• Changelog

Lizenz

MIT — siehe LICENSE