agent-tasks

AIコーディングエージェント向けのパイプライン駆動型タスク管理。 ステージゲート付きパイプライン、マルチエージェントコラボレーション、リアルタイムかんばんダッシュボードを備えたMCPサーバーです。タスクは設定可能なステージ（backlog、spec、plan、implement、test、review、done）を流れ、依存関係の追跡、承認ワークフロー、アーティファクトのバージョン管理、スレッドコメントに対応しています。

AIコーディングエージェント（Claude Code、Codex CLI、Gemini CLI、Aider）向けに構築されていますが、あらゆるMCPクライアント、RESTコンシューマー、WebSocketリスナーでも同様に動作します。

agent-tasksを選ぶ理由

同じコードベースで複数のAIエージェントを実行する場合、単なるフラットなTODOリストではなく、共有タスクパイプラインが必要です。ステージ、依存関係、承認、可視性が必要です。

Related MCP server: Agent Harness Kit

機能

• パイプラインステージ — プロジェクトごとに設定可能: backlog > spec > plan > implement > test > review > done

• タスク依存関係 — 自動サイクル検出付きDAG。解決されるまで進行をブロック

• 承認ワークフロー — ステージゲート付きの承認/却下。却下時は自動的にステージを戻す

• マルチエージェントコラボレーション — ロール（コラボレーター、レビュアー、ウォッチャー）、クレーム、割り当て

• サブタスク階層 — 親/子タスクツリーと進捗追跡

• スレッドコメント — エージェント間の非同期ディスカッション

• アーティファクトのバージョン管理 — ステージごとのドキュメント添付、自動バージョン管理、差分ビューアー

• 全文検索 — タスクのタイトルと説明に対するFTS5検索

• リアルタイムかんばんダッシュボード — ドラッグ＆ドロップ、サイドパネル、インライン作成、ダーク/ライトテーマ

• 3つのトランスポート層 — MCP（stdio）、REST API（HTTP）、WebSocket（リアルタイムイベント）

• TodoWriteブリッジ — Claude Codeの組み込みTodoWriteをインターセプトしてパイプラインに同期

• ステージゲート — プロジェクトごとに設定可能なゲートとステージごとのルール: 進行前に名前付きアーティファクト、最小アーティファクト数、コメント、承認を要求

• 決定ログ — task_artifact(type: "decision") による構造化された決定アーティファクト（XをYより選んだ理由Z）

• 学習の伝播 — task_artifact(type: "learning") が洞察（テクニック、落とし穴、決定、パターン）をキャプチャ。完了時に親タスクと兄弟タスクに自動伝播

• エージェント親和性 — task_list(next: true) は、関連履歴（親、依存関係、プロジェクト）を持つエージェントへのタスクルーティングをタイブレーカーとして優先

• ハートビートベースのクリーンアップ — 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サーバー（AIエージェント向け）

MCPクライアント設定（Claude Code、Clineなど）に追加:

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

最初のMCP接続時にダッシュボードが http://localhost:3422 で自動起動します。

オプション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 — ハートビートベースのタスククリーンアップとイベント通知。agent-commがハートビートを追跡 → agent-tasksがハートビートをチェック → 停止したエージェントのタスクを自動失敗。また、クレーム/進行時にダイレクトメッセージを送信し、コメント/承認時にチャンネルに投稿します。agent-commがない場合、古いエージェントの検出と通知はグレースフルにスキップされます。

• agent-knowledge — タスクの学習と決定のためのナレッジ永続化。タスク完了時に、KnowledgeBridgeはlearningおよびdecisionアーティファクトをPOST /api/knowledge経由でagent-knowledgeにプッシュします。エントリは埋め込みで自動インデックス化され、類似エントリに自動リンクされ、git同期されます。agent-knowledgeがない場合、アーティファクトはagent-tasks内にのみ残ります。

ドキュメント

• APIリファレンス — 8つのMCPツール、18のRESTエンドポイント、WebSocketプロトコル

• アーキテクチャ — ソース構造、設計原則、データベーススキーマ

• ダッシュボード — かんばんボードの機能、キーボードショートカット、スクリーンショット

• セットアップガイド — インストール、クライアント設定（Claude Code、OpenCode、Cursor、Windsurf）、フック

• 変更履歴

ライセンス

MIT — LICENSEを参照