AI-Powered Task Management System for Cursor, Lovable, Windsurf, & Roo

The GitHub repository, claude-task-master, contains an AI-powered task-management system that is compatible with Cursor, Lovable, Windsurf, Roo, and other similar platforms. The system is called Task Master and can be integrated using either of the two provided options.

Option 1, which is recommended, is to use Model Control Protocol (MCP) and install the package using the command "npm i -g task-master-ai". After installation, add the MCP configuration to your editor and enable it. Finally, prompt the AI to initialize Task Master into your project.

Option 2 is to use the command line and install the package either globally or locally. Once installed, initialize a new project using the command "task-master init" or "npx task-master-init" if installed locally. Additional commands are available for various functions such as parsing a PRD, listing all tasks, and generating task files.

The repository also includes a documentation directory with a configuration guide, tutorial, command reference, task structure, and example interactions. Task Master is licensed under the MIT License with Commons Clause.

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):

  1. Install the package npm i -g task-master-ai
  2. 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" } } } }
  3. Enable the MCP in your editor
  4. Prompt the AI to initialize Task Master: Can you please initialize taskmaster-ai into my project?
  5. 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

  1. Installation npm install -g task-master-ai or npm install task-master-ai
  2. Initialize a new project task-master init or npx task-master-init
  3. 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.