GitHub - eyaltoledano/claude-task-master
An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
Quick Start
Option 1 | MCP (Recommended):
- Install the package
npm i -g task-master-ai
- Add the MCP config to your editor
json { "mcpServers" : { "taskmaster-ai" : { "command" : "npx", "args" : [ "-y", "task-master-mcp" ], "env" : { "ANTHROPIC_API_KEY" : "YOUR_ANTHROPIC_API_KEY_HERE", "PERPLEXITY_API_KEY" : "YOUR_PERPLEXITY_API_KEY_HERE", "MODEL" : "claude-3-7-sonnet-20250219", "PERPLEXITY_MODEL" : "sonar-pro", "MAX_TOKENS" : 64000, "TEMPERATURE" : 0.2, "DEFAULT_SUBTASKS" : 5, "DEFAULT_PRIORITY" : "medium" } } } }
- Enable the MCP in your editor
- Prompt the AI to initialize Task Master:
Can you please initialize taskmaster-ai into my project?
- Use common commands directly through your AI assistant:
Can you parse my PRD at scripts/prd.txt? What's the next task I should work on? Can you help me implement task 3? Can you help me expand task 4?
Option 2: Using Command Line
- Installation
npm install -g task-master-ai
ornpm install task-master-ai
- Initialize a new project
task-master init
ornpx task-master-init
- This will prompt you for project details and set up a new project with the necessary files and structure.
Common Commands
- Initialize a new project
task-master init
- Parse a PRD and generate tasks
task-master parse-prd your-prd.txt
- List all tasks
task-master list
- Show the next task to work on
task-master next
- Generate task files
task-master generate
Documentation
For more detailed information, check out the documentation in the docs
directory:
- Configuration Guide
- Tutorial
- Command Reference
- Task Structure
- Example Interactions
Troubleshooting
If task-master init
doesn't respond:
- Try running it with Node directly:
node node_modules/claude-task-master/scripts/init.js
- Or clone the repository and run:
git clone https://github.com/eyaltoledano/claude-task-master.git cd claude-task-master node scripts/init.js
Contributors
Licensing
Task Master is licensed under the MIT License with Commons Clause.