agent-scrum-master

One command to auto-configure agent-tasks pipeline for any project.

Bootstraps agent-tasks — a pipeline task manager for AI agents — with a single npx call. Sets up MCP integration, project structure, and gitignore automatically. Works with Claude Code, Cursor, Windsurf, and any MCP client.

Features

• ✨ One-command setup — npx agent-scrum-master
• 📁 Project-scoped — isolated task database per project (not global)
• 🤖 Agent-agnostic — works with Claude Code, Cursor, Windsurf, any MCP client
• 🔗 Ticket system ready — optional Jira integration flags
• 🧹 Automatic cleanup — handles .gitignore and directory structure
• 📊 Dashboard included — real-time kanban at localhost:3422

Quick Start

Option 1: npx (one-liner, no install)

cd /path/to/your/project
npx agent-scrum-master

Option 2: npm install (global)

npm install -g agent-scrum-master
cd /path/to/your/project
agent-scrum-master

What It Does

Runs in your project root and:

1. ✓ Creates .mcp.json with Claude Code MCP server config
2. ✓ Creates .agent-tasks/ directory for local task database
3. ✓ Adds .agent-tasks/ to .gitignore
4. ✓ Creates .claude/skills/agents-scrum-master.md — skill documentation
5. ✓ Pins agent-tasks@1.10.11 for consistent MCP behavior

Result: Commit .mcp.json, open the project in Claude Code, approve the server once, then agents have full access to task pipeline.

Dependencies

agents-scrum-master pins agent-tasks@1.10.11 in the MCP config to ensure consistent behavior across sessions.

To use a different version, edit .claude/settings.json and change args: ['agent-tasks@VERSION'] to your desired version.

Commands

# Initialize (default)
npx agent-scrum-master

# Open dashboard in browser
npx agent-scrum-master dashboard

# With Jira integration
npx agent-scrum-master --jira-url=https://jira.company.com --jira-project=GROWTH

# Check status
npx agent-scrum-master status

# Remove setup
npx agent-scrum-master reset

# Verbose output
npx agent-scrum-master --verbose

# Overwrite existing config
npx agent-scrum-master --force

Usage in Your Agent

Once initialized, open the project in Claude Code or Cursor:

View dashboard

Open in browser with one command:

npx agent-scrum-master dashboard

Or navigate manually to http://localhost:3422

Create a task

Use the MCP tool: task_create(title: "Build login flow", description: "...", project: "MyProject")

Advance stages

Use task_stage(id: "task-123", stage: "implement")

See agent-tasks API docs for full tool reference.

Project Structure

After running agent-scrum-master:

your-project/
├── .mcp.json                  # MCP server config (commit this!)
├── .claude/
│   └── skills/
│       └── agents-scrum-master.md   # Skill for agents
├── .agent-tasks/              # Task database (git-ignored)
│   └── tasks.db
├── .gitignore                 # Updated with .agent-tasks/
└── ... (your code)

Commit .mcp.json to git — teammates inherit the setup automatically. On first Claude Code session, approve the MCP server once and it auto-connects thereafter.

Jira Integration (Optional)

Add Jira sync to your project:

npx agent-scrum-master \
  --jira-url=https://jira.company.com \
  --jira-project=GROWTH

This sets environment variables in .claude/settings.json. Agent-tasks can then sync task completions to Jira.

Multi-Project Setup

Each project gets its own isolated database:

project-a/
└── .agent-tasks/tasks.db       # Isolated to project-a

project-b/
└── .agent-tasks/tasks.db       # Isolated to project-b

No cross-project bleed — dashboards run on the same port but serve different DBs by project.

Requirements

• Node.js >= 18
• Agent supporting MCP (Claude Code, Cursor, Windsurf, etc.)

Troubleshooting

Dashboard doesn't start

# Check if agent-tasks is installed
npx agent-tasks --help

# Manually start dashboard
cd your-project
npx agent-tasks

Reset and reinitialize

npx agent-scrum-master reset
npx agent-scrum-master --force

Check status

npx agent-scrum-master status

Development

# Clone
git clone https://github.com/ashishdogra/agent-scrum-master.git
cd agent-scrum-master

# Test locally
node bin/cli.js --verbose

# Publish to npm
npm publish

License

MIT — see LICENSE

See Also

• agent-tasks — The pipeline engine this bootstraps
• agent-comm — Agent heartbeat & messaging
• agent-knowledge — Knowledge persistence