Skip to content
Back to search

taskmaster

MarketplaceWorks with Claude CodeGitHub

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eyaltoledano-claude-task-master/badge.svg)](/listings/eyaltoledano-claude-task-master)

HTML

<a href="/listings/eyaltoledano-claude-task-master"><img src="/api/listings/eyaltoledano-claude-task-master/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **Note:** After clicking the link, you'll still need to add your API keys to the configuration. The link installs the MCP server with placeholder keys that you'll need to replace with your actual API keys.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 32 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "taskmaster",
  3. "owner": {
  4. "name": "Hamster",
  5. "email": "ralph@tryhamster.com"
  6. },
  7. "metadata": {
  8. "description": "Official marketplace for Taskmaster AI - AI-powered task management for ambitious development",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "taskmaster",
  14. "source": "./packages/claude-code-plugin",
  15. "description": "AI-powered task management system for ambitious development workflows with intelligent orchestration, complexity analysis, and automated coordination",
  16. "author": {
  17. "name": "Hamster"
  18. },
  19. "homepage": "https://github.com/eyaltoledano/claude-task-master",
  20. "repository": "https://github.com/eyaltoledano/claude-task-master",
  21. "keywords": [
  22. "task-management",
  23. "ai",
  24. "workflow",
  25. "orchestration",
  26. "automation",
  27. "mcp"
  28. ],
  29. "category": "productivity"
  30. }
  31. ]
  32. }
README.md · README · 428 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <a name="readme-top"></a>
  2. <div align='center'>
  3. <a href="https://trendshift.io/repositories/13971" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13971" alt="eyaltoledano%2Fclaude-task-master | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
  4. </div>
  5. <p align="center">
  6. <a href="https://tryhamster.com/product/taskmaster"><img src="./images/logo.png?raw=true" alt="Taskmaster logo"></a>
  7. </p>
  8. <p align="center">
  9. <b>Taskmaster</b>: A task management system for AI-driven development, designed to work seamlessly with any AI chat.
  10. </p>
  11. <p align="center">
  12. <a href="https://discord.gg/taskmasterai" target="_blank"><img src="https://dcbadge.limes.pink/api/server/https://discord.gg/taskmasterai?style=flat" alt="Discord"></a> |
  13. <a href="https://tryhamster.com/docs/taskmaster" target="_blank">Docs</a>
  14. </p>
  15. <p align="center">
  16. <a href="https://github.com/eyaltoledano/claude-task-master/actions/workflows/ci.yml"><img src="https://github.com/eyaltoledano/claude-task-master/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  17. <a href="https://github.com/eyaltoledano/claude-task-master/stargazers"><img src="https://img.shields.io/github/stars/eyaltoledano/claude-task-master?style=social" alt="GitHub stars"></a>
  18. <a href="https://badge.fury.io/js/task-master-ai"><img src="https://badge.fury.io/js/task-master-ai.svg" alt="npm version"></a>
  19. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT%20with%20Commons%20Clause-blue.svg" alt="License"></a>
  20. </p>
  21. <p align="center">
  22. <a href="https://www.npmjs.com/package/task-master-ai"><img src="https://img.shields.io/npm/d18m/task-master-ai?style=flat" alt="NPM Downloads"></a>
  23. <a href="https://www.npmjs.com/package/task-master-ai"><img src="https://img.shields.io/npm/dm/task-master-ai?style=flat" alt="NPM Downloads"></a>
  24. <a href="https://www.npmjs.com/package/task-master-ai"><img src="https://img.shields.io/npm/dw/task-master-ai?style=flat" alt="NPM Downloads"></a>
  25. </p>
  26. ## By [@eyaltoledano](https://x.com/eyaltoledano) & [@RalphEcom](https://x.com/RalphEcom)
  27. [![Twitter Follow](https://img.shields.io/twitter/follow/eyaltoledano)](https://x.com/eyaltoledano)
  28. [![Twitter Follow](https://img.shields.io/twitter/follow/RalphEcom)](https://x.com/RalphEcom)
  29. A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
  30. ## Documentation
  31. 📚 **[View Full Documentation](https://tryhamster.com/docs/taskmaster)**
  32. ### Quick Links
  33. - [Quick Start Guide](https://tryhamster.com/docs/taskmaster/getting-started/quick-start/quick-start)
  34. - [Installation](https://tryhamster.com/docs/taskmaster/getting-started/quick-start/installation)
  35. - [API Keys & Providers](https://tryhamster.com/docs/taskmaster/getting-started/api-keys)
  36. - [Supported Editors](https://tryhamster.com/docs/taskmaster/ide-setup/supported-editors)
  37. - [MCP Tools Reference](https://tryhamster.com/docs/taskmaster/capabilities/mcp)
  38. - [CLI Commands Reference](https://tryhamster.com/docs/taskmaster/capabilities/cli-root-commands)
  39. - [Task Structure](https://tryhamster.com/docs/taskmaster/capabilities/task-structure)
  40. - [Task Dependencies](https://tryhamster.com/docs/taskmaster/task-workflow/dependencies)
  41. - [Tags & Workstreams](https://tryhamster.com/docs/taskmaster/task-workflow/tags)
  42. - [Research Command](https://tryhamster.com/docs/taskmaster/task-workflow/research)
  43. - [Loop Command](https://tryhamster.com/docs/taskmaster/automation/loop)
  44. - [AI Providers Overview](https://tryhamster.com/docs/taskmaster/ai-providers/overview)
  45. - [Team Collaboration](https://tryhamster.com/docs/taskmaster/team/overview)
  46. - [Best Practices](https://tryhamster.com/docs/taskmaster/best-practices/index)
  47. - [FAQ](https://tryhamster.com/docs/taskmaster/getting-started/faq)
  48. - [Changelog](CHANGELOG.md)
  49. ### More from Hamster
  50. - [Hamster Studio](https://tryhamster.com/product/studio)
  51. - [Product & Engineering Methods](https://tryhamster.com/methods)
  52. - [Product & Engineering Skills](https://tryhamster.com/skills)
  53. - [Hamster Pricing](https://tryhamster.com/pricing)
  54. #### Quick Install for Cursor 1.0+ (One-Click)
  55. [![Add task-master-ai MCP server to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=task-master-ai&config=eyJjb21tYW5kIjoibnB4IC15IC0tcGFja2FnZT10YXNrLW1hc3Rlci1haSB0YXNrLW1hc3Rlci1haSIsImVudiI6eyJBTlRIUk9QSUNfQVBJX0tFWSI6IllPVVJfQU5USFJPUElDX0FQSV9LRVlfSEVSRSIsIlBFUlBMRVhJVFlfQVBJX0tFWSI6IllPVVJfUEVSUExFWElUWV9BUElfS0VZX0hFUkUiLCJPUEVOQUlfQVBJX0tFWSI6IllPVVJfT1BFTkFJX0tFWV9IRVJFIiwiR09PR0xFX0FQSV9LRVkiOiJZT1VSX0dPT0dMRV9LRVlfSEVSRSIsIk1JU1RSQUxfQVBJX0tFWSI6IllPVVJfTUlTVFJBTF9LRVlfSEVSRSIsIkdST1FfQVBJX0tFWSI6IllPVVJfR1JPUV9LRVlfSEVSRSIsIk9QRU5ST1VURVJfQVBJX0tFWSI6IllPVVJfT1BFTlJPVVRFUl9LRVlfSEVSRSIsIlhBSV9BUElfS0VZIjoiWU9VUl9YQUlfS0VZX0hFUkUiLCJBWlVSRV9PUEVOQUlfQVBJX0tFWSI6IllPVVJfQVpVUkVfS0VZX0hFUkUiLCJPTExBTUFfQVBJX0tFWSI6IllPVVJfT0xMQU1BX0FQSV9LRVlfSEVSRSJ9fQ%3D%3D)
  56. > **Note:** After clicking the link, you'll still need to add your API keys to the configuration. The link installs the MCP server with placeholder keys that you'll need to replace with your actual API keys.
  57. #### Claude Code Quick Install
  58. For Claude Code users:
  59. ```bash
  60. claude mcp add taskmaster-ai -- npx -y task-master-ai
  61. ```
  62. Don't forget to add your API keys to the configuration:
  63. - in the root .env of your Project
  64. - in the "env" section of your mcp config for taskmaster-ai
  65. ## Requirements
  66. Taskmaster utilizes AI across several commands, and those require a separate API key. You can use a variety of models from different AI providers provided you add your API keys. For example, if you want to use Claude 3.7, you'll need an Anthropic API key.
  67. You can define 3 types of models to be used: the main model, the research model, and the fallback model (in case either the main or research fail). Whatever model you use, its provider API key must be present in either mcp.json or .env.
  68. At least one (1) of the following is required:
  69. - Anthropic API key (Claude API)
  70. - OpenAI API key
  71. - Google Gemini API key
  72. - Perplexity API key (for research model)
  73. - xAI API Key (for research or main model)
  74. - OpenRouter API Key (for research or main model)
  75. - Claude Code (no API key required - requires Claude Code CLI)
  76. - Codex CLI (OAuth via ChatGPT subscription - requires Codex CLI)
  77. Using the research model is optional but highly recommended. You will need at least ONE API key (unless using Claude Code or Codex CLI with OAuth). Adding all API keys enables you to seamlessly switch between model providers at will.
  78. ## Quick Start
  79. ### Option 1: MCP (Recommended)
  80. MCP (Model Control Protocol) lets you run Task Master directly from your editor.
  81. #### 1. Add your MCP config at the following path depending on your editor
  82. | Editor | Scope | Linux/macOS Path | Windows Path | Key |
  83. | ------------ | ------- | ------------------------------------- | ------------------------------------------------- | ------------ |
  84. | **Cursor** | Global | `~/.cursor/mcp.json` | `%USERPROFILE%\.cursor\mcp.json` | `mcpServers` |
  85. | | Project | `<project_folder>/.cursor/mcp.json` | `<project_folder>\.cursor\mcp.json` | `mcpServers` |
  86. | **Windsurf** | Global | `~/.codeium/windsurf/mcp_config.json` | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` | `mcpServers` |
  87. | **VS Code** | Project | `<project_folder>/.vscode/mcp.json` | `<project_folder>\.vscode\mcp.json` | `servers` |
  88. | **Q CLI** | Global | `~/.aws/amazonq/mcp.json` | | `mcpServers` |
  89. ##### Manual Configuration
  90. ###### Cursor & Windsurf & Q Developer CLI (`mcpServers`)
  91. ```json
  92. {
  93. "mcpServers": {
  94. "task-master-ai": {
  95. "command": "npx",
  96. "args": ["-y", "task-master-ai"],
  97. "env": {
  98. // "TASK_MASTER_TOOLS": "all", // Options: "all", "standard", "core", or comma-separated list of tools
  99. "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
  100. "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
  101. "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
  102. "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
  103. "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
  104. "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
  105. "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
  106. "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
  107. "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
  108. "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
  109. }
  110. }
  111. }
  112. }
  113. ```
  114. > 🔑 Replace `YOUR_…_KEY_HERE` with your real API keys. You can remove keys you don't use.
  115. > **Note**: If you see `0 tools enabled` in the MCP settings, restart your editor and check that your API keys are correctly configured.
  116. ###### VS Code (`servers` + `type`)
  117. ```json
  118. {
  119. "servers": {
  120. "task-master-ai": {
  121. "command": "npx",
  122. "args": ["-y", "task-master-ai"],
  123. "env": {
  124. // "TASK_MASTER_TOOLS": "all", // Options: "all", "standard", "core", or comma-separated list of tools
  125. "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
  126. "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
  127. "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
  128. "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
  129. "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
  130. "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
  131. "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
  132. "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
  133. "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
  134. "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
  135. },
  136. "type": "stdio"
  137. }
  138. }
  139. }
  140. ```
  141. > 🔑 Replace `YOUR_…_KEY_HERE` with your real API keys. You can remove keys you don't use.
  142. #### 2. (Cursor-only) Enable Taskmaster MCP
  143. Open Cursor Settings (Ctrl+Shift+J) ➡ Click on MCP tab on the left ➡ Enable task-master-ai with the toggle
  144. #### 3. (Optional) Configure the models you want to use
  145. In your editor's AI chat pane, say:
  146. ```txt
  147. Change the main, research and fallback models to <model_name>, <model_name> and <model_name> respectively.
  148. ```
  149. For example, to use Claude Code (no API key required):
  150. ```txt
  151. Change the main model to claude-code/sonnet
  152. ```
  153. [Table of available models](docs/models.md) | [Claude Code setup](docs/examples/claude-code-usage.md)
  154. #### 4. Initialize Task Master
  155. In your editor's AI chat pane, say:
  156. ```txt
  157. Initialize taskmaster-ai in my project
  158. ```
  159. #### 5. Make sure you have a PRD (Recommended)
  160. For **new projects**: Create your PRD at `.taskmaster/docs/prd.txt`.
  161. For **existing projects**: You can use `scripts/prd.txt` or migrate with `task-master migrate`
  162. An example PRD template is available after initialization in `.taskmaster/templates/example_prd.txt`.
  163. > [!NOTE]
  164. > While a PRD is recommended for complex projects, you can always create individual tasks by asking "Can you help me implement [description of what you want to do]?" in chat.
  165. **Always start with a detailed PRD.**
  166. The more detailed your PRD, the better the generated tasks will be.
  167. #### 6. Common Commands
  168. Use your AI assistant to:
  169. - Parse requirements: `Can you parse my PRD at scripts/prd.txt?`
  170. - Plan next step: `What's the next task I should work on?`
  171. - Implement a task: `Can you help me implement task 3?`
  172. - View multiple tasks: `Can you show me tasks 1, 3, and 5?`
  173. - Expand a task: `Can you help me expand task 4?`
  174. - **Research fresh information**: `Research the latest best practices for implementing JWT authentication with Node.js`
  175. - **Research with context**: `Research React Query v5 migration strategies for our current API implementation in src/api.js`
  176. [More examples on how to use Task Master in chat](docs/examples.md)
  177. ### Option 2: Using Command Line
  178. #### Installation
  179. ```bash
  180. # Install globally
  181. npm install -g task-master-ai
  182. # OR install locally within your project
  183. npm install task-master-ai
  184. ```
  185. #### Initialize a new project
  186. ```bash
  187. # If installed globally
  188. task-master init
  189. # If installed locally
  190. npx task-master init
  191. # Initialize project with specific rules
  192. task-master init --rules cursor,windsurf,vscode
  193. ```
  194. This will prompt you for project details and set up a new project with the necessary files and structure.
  195. #### Common Commands
  196. ```bash
  197. # Initialize a new project
  198. task-master init
  199. # Parse a PRD and generate tasks
  200. task-master parse-prd your-prd.txt
  201. # List all tasks
  202. task-master list
  203. # Show the next task to work on
  204. task-master next
  205. # Show specific task(s) - supports comma-separated IDs
  206. task-master show 1,3,5
  207. # Research fresh information with project context
  208. task-master research "What are the latest best practices for JWT authentication?"
  209. # Move tasks between tags (cross-tag movement)
  210. task-master move --from=5 --from-tag=backlog --to-tag=in-progress
  211. task-master move --from=5,6,7 --from-tag=backlog --to-tag=done --with-dependencies
  212. task-master move --from=5 --from-tag=backlog --to-tag=in-progress --ignore-dependencies
  213. # Add rules after initialization
  214. task-master rules add windsurf,roo,vscode
  215. ```
  216. ## Tool Loading Configuration
  217. ### Optimizing MCP Tool Loading
  218. Task Master's MCP server supports selective tool loading to reduce context window usage. By default, all 36 tools are loaded (~21,000 tokens) to maintain backward compatibility with existing installations.
  219. You can optimize performance by configuring the `TASK_MASTER_TOOLS` environment variable:
  220. ### Available Modes
  221. | Mode | Tools | Context Usage | Use Case |
  222. |------|-------|--------------|----------|
  223. | `all` (default) | 36 | ~21,000 tokens | Complete feature set - all tools available |
  224. | `standard` | 15 | ~10,000 tokens | Common task management operations |
  225. | `core` (or `lean`) | 7 | ~5,000 tokens | Essential daily development workflow |
  226. | `custom` | Variable | Variable | Comma-separated list of specific tools |
  227. ### Configuration Methods
  228. #### Method 1: Environment Variable in MCP Configuration
  229. Add `TASK_MASTER_TOOLS` to your MCP configuration file's `env` section:
  230. ```jsonc
  231. {
  232. "mcpServers": { // or "servers" for VS Code
  233. "task-master-ai": {
  234. "command": "npx",
  235. "args": ["-y", "task-master-ai"],
  236. "env": {
  237. "TASK_MASTER_TOOLS": "standard", // Options: "all", "standard", "core", "lean", or comma-separated list
  238. "ANTHROPIC_API_KEY": "your-key-here",
  239. // ... other API keys
  240. }
  241. }
  242. }
  243. }
  244. ```
  245. #### Method 2: Claude Code CLI (One-Time Setup)
  246. For Claude Code users, you can set the mode during installation:
  247. ```bash
  248. # Core mode example (~70% token reduction)
  249. claude mcp add task-master-ai --scope user \
  250. --env TASK_MASTER_TOOLS="core" \
  251. -- npx -y task-master-ai@latest
  252. # Custom tools example
  253. claude mcp add task-master-ai --scope user \
  254. --env TASK_MASTER_TOOLS="get_tasks,next_task,set_task_status" \
  255. -- npx -y task-master-ai@latest
  256. ```
  257. ### Tool Sets Details
  258. **Core Tools (7):** `get_tasks`, `next_task`, `get_task`, `set_task_status`, `update_subtask`, `parse_prd`, `expand_task`
  259. **Standard Tools (15):** All core tools plus `initialize_project`, `analyze_project_complexity`, `expand_all`, `add_subtask`, `remove_task`, `generate`, `add_task`, `complexity_report`
  260. **All Tools (36):** Complete set including project setup, task management, analysis, dependencies, tags, research, and more
  261. ### Recommendations
  262. - **New users**: Start with `"standard"` mode for a good balance
  263. - **Large projects**: Use `"core"` mode to minimize token usage
  264. - **Complex workflows**: Use `"all"` mode or custom selection
  265. - **Backward compatibility**: If not specified, defaults to `"all"` mode
  266. ## Claude Code Support
  267. Task Master now supports Claude models through the Claude Code CLI, which requires no API key:
  268. - **Models**: `claude-code/opus` and `claude-code/sonnet`
  269. - **Requirements**: Claude Code CLI installed
  270. - **Benefits**: No API key needed, uses your local Claude instance
  271. [Learn more about Claude Code setup](docs/examples/claude-code-usage.md)
  272. ## Troubleshooting
  273. ### If `task-master init` doesn't respond
  274. Try running it with Node directly:
  275. ```bash
  276. node node_modules/claude-task-master/scripts/init.js
  277. ```
  278. Or clone the repository and run:
  279. ```bash
  280. git clone https://github.com/eyaltoledano/claude-task-master.git
  281. cd claude-task-master
  282. node scripts/init.js
  283. ```
  284. ## Join Our Team
  285. <a href="https://tryhamster.com" target="_blank">
  286. <img src="./images/hamster-hiring.png" alt="Join Hamster's founding team" />
  287. </a>
  288. ## Contributors
  289. <a href="https://github.com/eyaltoledano/claude-task-master/graphs/contributors">
  290. <img src="https://contrib.rocks/image?repo=eyaltoledano/claude-task-master" alt="Task Master project contributors" />
  291. </a>
  292. ## Star History
  293. [![Star History Chart](https://api.star-history.com/svg?repos=eyaltoledano/claude-task-master&type=Timeline)](https://www.star-history.com/#eyaltoledano/claude-task-master&Timeline)
  294. ## Licensing
  295. Task Master is licensed under the MIT License with Commons Clause. This means you can:
  296. ✅ **Allowed**:
  297. - Use Task Master for any purpose (personal, commercial, academic)
  298. - Modify the code
  299. - Distribute copies
  300. - Create and sell products built using Task Master
  301. ❌ **Not Allowed**:
  302. - Sell Task Master itself
  303. - Offer Task Master as a hosted service
  304. - Create competing products based on Task Master
  305. See the [LICENSE](LICENSE) file for the complete license text and [licensing details](docs/licensing.md) for more information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.