# agent-tasks

Pipeline-driven task management for coding agents with stages, dependencies, and artifacts. Coordinates multi-agent workflows across a shared codebase.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22
- Author: keshrath
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/keshrath/agent-tasks
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/agent-tasks

## What it does

The server transforms flat todo lists into a directed acyclic graph of project stages, moving items from backlog to review and completion. Agents can claim assignments, attach versioned files, add threaded notes, or push tickets back when criteria fail. Dependency checks stop tasks from progressing until prerequisites pass.

Under the hood, the package provides 8 MCP tools along with a local REST interface listening on port 3422. Claude Code 2.1.289+ users get an interactive `/pipeline` split pane right next to the conversation.

Running it requires Node.js 20.11 or newer. Avoid setting the `require_approval` stage rule: no tool can confirm approvals yet, so tasks will remain stuck indefinitely.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-tasks -- npx -y agent-tasks
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-tasks -- npx -y agent-tasks
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-tasks": {
            "command": "npx",
            "args": [
                "-y",
                "agent-tasks"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-tasks": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agent-tasks"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-tasks npx -y agent-tasks
```

## When to use it
- coordinate multiple AI agents working on the same repository
- prevent premature task advancement before dependencies resolve
- track versioned decision logs and architectural findings per stage
- monitor task progress directly inside the Claude Code interface

## Example prompts
- Create a task for the auth migration and advance it to the spec stage
- Check next unblocked tasks matching my project context using task_list
- Attach a decision artifact explaining why we chose SQLite over Postgres

## Similar
- [memory-tasks](https://affpapa.org/en/nevibecode/skills/memory-tasks.md) — skill · 1200 installs
- [find-code-tasks](https://affpapa.org/en/nevibecode/skills/find-code-tasks.md) — skill · ★ 3189
- [speckit-tasks](https://affpapa.org/en/nevibecode/skills/speckit-tasks.md) — skill · 2400 installs
- [gws-tasks](https://affpapa.org/en/nevibecode/skills/gws-tasks.md) — skill · 44800 installs
- [recipe-review-overdue-tasks](https://affpapa.org/en/nevibecode/skills/recipe-review-overdue-tasks.md) — skill · 30200 installs
- [brief-to-tasks](https://affpapa.org/en/nevibecode/skills/brief-to-tasks.md) — skill · 5200 installs

From the same set: [keshrath/agent-tasks](https://affpapa.org/en/nevibecode/by/keshrath/agent-tasks.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md