56 KiB
task-master-ai
0.15.0
Minor Changes
-
#567
09add37Thanks @eyaltoledano! - Added comprehensive Ollama model validation and interactive setup support- Interactive Setup Enhancement: Added "Custom Ollama model" option to
task-master models --setup, matching the existing OpenRouter functionality - Live Model Validation: When setting Ollama models, Taskmaster now validates against the local Ollama instance by querying
/api/tagsendpoint - Configurable Endpoints: Uses the
ollamaBaseUrlfrom.taskmasterconfig(with role-specificbaseUrloverrides supported) - Robust Error Handling:
- Detects when Ollama server is not running and provides clear error messages
- Validates model existence and lists available alternatives when model not found
- Graceful fallback behavior for connection issues
- Full Platform Support: Both MCP server tools and CLI commands support the new validation
- Improved User Experience: Clear feedback during model validation with informative success/error messages
- Interactive Setup Enhancement: Added "Custom Ollama model" option to
-
#567
4c83526Thanks @eyaltoledano! - Adds and updates supported AI models with costs:- Added new OpenRouter models: GPT-4.1 series, O3, Codex Mini, Llama 4 Maverick, Llama 4 Scout, Qwen3-235b
- Added Mistral models: Devstral Small, Mistral Nemo
- Updated Ollama models with latest variants: Devstral, Qwen3, Mistral-small3.1, Llama3.3
- Updated Gemini model to latest 2.5 Flash preview version
-
#567
70f4054Thanks @eyaltoledano! - Add--researchflag to parse-prd command, enabling enhanced task generation from PRD files. When used, Taskmaster leverages the research model to:- Research current technologies and best practices relevant to the project
- Identify technical challenges and security concerns not explicitly mentioned in the PRD
- Include specific library recommendations with version numbers
- Provide more detailed implementation guidance based on industry standards
- Create more accurate dependency relationships between tasks
This results in higher quality, more actionable tasks with minimal additional effort.
NOTE That this is an experimental feature. Research models don't typically do great at structured output. You may find some failures when using research mode, so please share your feedback so we can improve this.
-
#567
5e9bc28Thanks @eyaltoledano! - This change significantly enhances theadd-taskcommand's intelligence. When you add a new task, Taskmaster now automatically: - Analyzes your existing tasks to find those most relevant to your new task's description. - Provides the AI with detailed context from these relevant tasks.This results in newly created tasks being more accurately placed within your project's dependency structure, saving you time and any need to update tasks just for dependencies, all without significantly increasing AI costs. You'll get smarter, more connected tasks right from the start.
-
#567
34c769bThanks @eyaltoledano! - Enhance analyze-complexity to support analyzing specific task IDs. - You can now analyze individual tasks or selected task groups by using the new--idoption with comma-separated IDs, or--fromand--tooptions to specify a range of tasks. - The feature intelligently merges analysis results with existing reports, allowing incremental analysis while preserving previous results. -
#558
86d8f00Thanks @ShreyPaharia! - Add next task to set task status response Status: DONE -
#567
04af16dThanks @eyaltoledano! - Add move command to enable moving tasks and subtasks within the task hierarchy. This new command supports moving standalone tasks to become subtasks, subtasks to become standalone tasks, and moving subtasks between different parents. The implementation handles circular dependencies, validation, and proper updating of parent-child relationships.Usage:
- CLI command:
task-master move --from=<id> --to=<id> - MCP tool:
move_taskwith parameters:from: ID of task/subtask to move (e.g., "5" or "5.2")to: ID of destination (e.g., "7" or "7.3")file(optional): Custom path to tasks.json
Example scenarios:
- Move task to become subtask:
--from="5" --to="7" - Move subtask to standalone task:
--from="5.2" --to="7" - Move subtask to different parent:
--from="5.2" --to="7.3" - Reorder subtask within same parent:
--from="5.2" --to="5.4" - Move multiple tasks at once:
--from="10,11,12" --to="16,17,18" - Move task to new ID:
--from="5" --to="25"(creates a new task with ID 25)
Multiple Task Support: The command supports moving multiple tasks simultaneously by providing comma-separated lists for both
--fromand--toparameters. The number of source and destination IDs must match. This is particularly useful for resolving merge conflicts in task files when multiple team members have created tasks on different branches.Validation Features:
- Allows moving tasks to new, non-existent IDs (automatically creates placeholders)
- Prevents moving to existing task IDs that already contain content (to avoid overwriting)
- Validates source tasks exist before attempting to move them
- Ensures proper parent-child relationships are maintained
- CLI command:
Patch Changes
-
#567
231e569Thanks @eyaltoledano! - Adjusts default main model model to Claude Sonnet 4. Adjusts default fallback to Claude Sonney 3.7" -
#567
b371808Thanks @eyaltoledano! - Adds llms-install.md to the root to enable AI agents to programmatically install the Taskmaster MCP server. This is specifically being introduced for the Cline MCP marketplace and will be adjusted over time for other MCP clients as needed. -
#567
a59dd03Thanks @eyaltoledano! - Adds AGENTS.md to power Claude Code integration more natively based on Anthropic's best practice and Claude-specific MCP client behaviours. Also adds in advanced workflows that tie Taskmaster commands together into one Claude workflow." -
#567
e0e1155Thanks @eyaltoledano! - Fixes issue with force/append flag combinations for parse-prd. -
#567
34df2c8Thanks @eyaltoledano! - You can now add tasks to a newly initialized project without having to parse a prd. This will automatically create the missing tasks.json file and create the first task. Lets you vibe if you want to vibe." -
#567
d2e6431Thanks @eyaltoledano! - Fixes an issue where the research fallback would attempt to make API calls without checking for a valid API key first. This ensures proper error handling when the main task generation and first fallback both fail. Closes #421 #519.
0.15.0-rc.0
Minor Changes
-
#567
09add37Thanks @eyaltoledano! - Added comprehensive Ollama model validation and interactive setup support- Interactive Setup Enhancement: Added "Custom Ollama model" option to
task-master models --setup, matching the existing OpenRouter functionality - Live Model Validation: When setting Ollama models, Taskmaster now validates against the local Ollama instance by querying
/api/tagsendpoint - Configurable Endpoints: Uses the
ollamaBaseUrlfrom.taskmasterconfig(with role-specificbaseUrloverrides supported) - Robust Error Handling:
- Detects when Ollama server is not running and provides clear error messages
- Validates model existence and lists available alternatives when model not found
- Graceful fallback behavior for connection issues
- Full Platform Support: Both MCP server tools and CLI commands support the new validation
- Improved User Experience: Clear feedback during model validation with informative success/error messages
- Interactive Setup Enhancement: Added "Custom Ollama model" option to
-
#567
4c83526Thanks @eyaltoledano! - Adds and updates supported AI models with costs:- Added new OpenRouter models: GPT-4.1 series, O3, Codex Mini, Llama 4 Maverick, Llama 4 Scout, Qwen3-235b
- Added Mistral models: Devstral Small, Mistral Nemo
- Updated Ollama models with latest variants: Devstral, Qwen3, Mistral-small3.1, Llama3.3
- Updated Gemini model to latest 2.5 Flash preview version
-
#567
70f4054Thanks @eyaltoledano! - Add--researchflag to parse-prd command, enabling enhanced task generation from PRD files. When used, Taskmaster leverages the research model to:- Research current technologies and best practices relevant to the project
- Identify technical challenges and security concerns not explicitly mentioned in the PRD
- Include specific library recommendations with version numbers
- Provide more detailed implementation guidance based on industry standards
- Create more accurate dependency relationships between tasks
This results in higher quality, more actionable tasks with minimal additional effort.
NOTE That this is an experimental feature. Research models don't typically do great at structured output. You may find some failures when using research mode, so please share your feedback so we can improve this.
-
#567
5e9bc28Thanks @eyaltoledano! - This change significantly enhances theadd-taskcommand's intelligence. When you add a new task, Taskmaster now automatically: - Analyzes your existing tasks to find those most relevant to your new task's description. - Provides the AI with detailed context from these relevant tasks.This results in newly created tasks being more accurately placed within your project's dependency structure, saving you time and any need to update tasks just for dependencies, all without significantly increasing AI costs. You'll get smarter, more connected tasks right from the start.
-
#567
34c769bThanks @eyaltoledano! - Enhance analyze-complexity to support analyzing specific task IDs. - You can now analyze individual tasks or selected task groups by using the new--idoption with comma-separated IDs, or--fromand--tooptions to specify a range of tasks. - The feature intelligently merges analysis results with existing reports, allowing incremental analysis while preserving previous results. -
#558
86d8f00Thanks @ShreyPaharia! - Add next task to set task status response Status: DONE -
#567
04af16dThanks @eyaltoledano! - Add move command to enable moving tasks and subtasks within the task hierarchy. This new command supports moving standalone tasks to become subtasks, subtasks to become standalone tasks, and moving subtasks between different parents. The implementation handles circular dependencies, validation, and proper updating of parent-child relationships.Usage:
- CLI command:
task-master move --from=<id> --to=<id> - MCP tool:
move_taskwith parameters:from: ID of task/subtask to move (e.g., "5" or "5.2")to: ID of destination (e.g., "7" or "7.3")file(optional): Custom path to tasks.json
Example scenarios:
- Move task to become subtask:
--from="5" --to="7" - Move subtask to standalone task:
--from="5.2" --to="7" - Move subtask to different parent:
--from="5.2" --to="7.3" - Reorder subtask within same parent:
--from="5.2" --to="5.4" - Move multiple tasks at once:
--from="10,11,12" --to="16,17,18" - Move task to new ID:
--from="5" --to="25"(creates a new task with ID 25)
Multiple Task Support: The command supports moving multiple tasks simultaneously by providing comma-separated lists for both
--fromand--toparameters. The number of source and destination IDs must match. This is particularly useful for resolving merge conflicts in task files when multiple team members have created tasks on different branches.Validation Features:
- Allows moving tasks to new, non-existent IDs (automatically creates placeholders)
- Prevents moving to existing task IDs that already contain content (to avoid overwriting)
- Validates source tasks exist before attempting to move them
- Ensures proper parent-child relationships are maintained
- CLI command:
Patch Changes
-
#567
231e569Thanks @eyaltoledano! - Adjusts default main model model to Claude Sonnet 4. Adjusts default fallback to Claude Sonney 3.7" -
#567
b371808Thanks @eyaltoledano! - Adds llms-install.md to the root to enable AI agents to programmatically install the Taskmaster MCP server. This is specifically being introduced for the Cline MCP marketplace and will be adjusted over time for other MCP clients as needed. -
#567
a59dd03Thanks @eyaltoledano! - Adds AGENTS.md to power Claude Code integration more natively based on Anthropic's best practice and Claude-specific MCP client behaviours. Also adds in advanced workflows that tie Taskmaster commands together into one Claude workflow." -
#567
e0e1155Thanks @eyaltoledano! - Fixes issue with force/append flag combinations for parse-prd. -
#567
34df2c8Thanks @eyaltoledano! - You can now add tasks to a newly initialized project without having to parse a prd. This will automatically create the missing tasks.json file and create the first task. Lets you vibe if you want to vibe." -
#567
d2e6431Thanks @eyaltoledano! - Fixes an issue where the research fallback would attempt to make API calls without checking for a valid API key first. This ensures proper error handling when the main task generation and first fallback both fail. Closes #421 #519.
0.14.0
Minor Changes
-
#521
ed17cb0Thanks @Crunchyman-ralph! - .taskmasterconfig now supports a baseUrl field per model role (main, research, fallback), allowing endpoint overrides for any provider. -
#536
f4a83ecThanks @Crunchyman-ralph! - Add Ollama as a supported AI provider.- You can now add it by running
task-master models --setupand selecting it. - Ollama is a local model provider, so no API key is required.
- Ollama models are available at
http://localhost:11434/apiby default. - You can change the default URL by setting the
OLLAMA_BASE_URLenvironment variable or by adding abaseUrlproperty to theollamamodel role in.taskmasterconfig.- If you want to use a custom API key, you can set it in the
OLLAMA_API_KEYenvironment variable.
- If you want to use a custom API key, you can set it in the
- You can now add it by running
-
#528
58b417aThanks @Crunchyman-ralph! - Display task complexity scores in task lists, next task, and task details views.
Patch Changes
-
#402
01963afThanks @Crunchyman-ralph! - Resolve all issues related to MCP -
#478
4117f71Thanks @joedanz! - Fix CLI --force flag for parse-prd commandPreviously, the --force flag was not respected when running
parse-prd, causing the command to prompt for confirmation or fail even when --force was provided. This patch ensures that the flag is correctly passed and handled, allowing users to overwrite existing tasks.json files as intended.- Fixes #477
-
#511
17294ffThanks @Crunchyman-ralph! - Task Master no longer tells you to update when you're already up to date -
#442
2b3ae8bThanks @eyaltoledano! - Adds costs information to AI commands using input/output tokens and model costs. -
#402
01963afThanks @Crunchyman-ralph! - Fix ERR_MODULE_NOT_FOUND when trying to run MCP Server -
#402
01963afThanks @Crunchyman-ralph! - Add src directory to exports -
#523
da317f2Thanks @Crunchyman-ralph! - Fix the error handling of task status settings -
#527
a8dabf4Thanks @Crunchyman-ralph! - Remove caching layer from MCP direct functions for task listing, next task, and complexity report- Fixes issues users where having where they were getting stale data
-
#417
a1f8d52Thanks @ksylvan! - Fix for issue #409 LOG_LEVEL Pydantic validation error -
#442
0288311Thanks @eyaltoledano! - Small fixes -nextcommand no longer incorrectly suggests that subtasks be broken down into subtasks in the CLI - fixes theappendflag so it properly works in the CLI -
#501
0a61184Thanks @Crunchyman-ralph! - Fix initial .env.example to work out of the box- Closes #419
-
#435
a96215aThanks @lebsral! - Fix default fallback model and maxTokens in Taskmaster initialization -
#517
e96734aThanks @Crunchyman-ralph! - Fix bug when updating tasks on the MCP server (#412) -
#496
efce374Thanks @joedanz! - Fix duplicate output on CLI help screen- Prevent the Task Master CLI from printing the help screen more than once when using
-hor--help. - Removed redundant manual event handlers and guards for help output; now only the Commander
.helpInformationoverride is used for custom help. - Simplified logic so that help is only shown once for both "no arguments" and help flag flows.
- Ensures a clean, branded help experience with no repeated content.
- Fixes #339
- Prevent the Task Master CLI from printing the help screen more than once when using
0.14.0-rc.1
Minor Changes
-
#536
f4a83ecThanks @Crunchyman-ralph! - Add Ollama as a supported AI provider.- You can now add it by running
task-master models --setupand selecting it. - Ollama is a local model provider, so no API key is required.
- Ollama models are available at
http://localhost:11434/apiby default. - You can change the default URL by setting the
OLLAMA_BASE_URLenvironment variable or by adding abaseUrlproperty to theollamamodel role in.taskmasterconfig.- If you want to use a custom API key, you can set it in the
OLLAMA_API_KEYenvironment variable.
- If you want to use a custom API key, you can set it in the
- You can now add it by running
Patch Changes
-
#442
2b3ae8bThanks @eyaltoledano! - Adds costs information to AI commands using input/output tokens and model costs. -
#442
0288311Thanks @eyaltoledano! - Small fixes -nextcommand no longer incorrectly suggests that subtasks be broken down into subtasks in the CLI - fixes theappendflag so it properly works in the CLI
0.14.0-rc.0
Minor Changes
-
#521
ed17cb0Thanks @Crunchyman-ralph! - .taskmasterconfig now supports a baseUrl field per model role (main, research, fallback), allowing endpoint overrides for any provider. -
#528
58b417aThanks @Crunchyman-ralph! - Display task complexity scores in task lists, next task, and task details views.
Patch Changes
-
#478
4117f71Thanks @joedanz! - Fix CLI --force flag for parse-prd commandPreviously, the --force flag was not respected when running
parse-prd, causing the command to prompt for confirmation or fail even when --force was provided. This patch ensures that the flag is correctly passed and handled, allowing users to overwrite existing tasks.json files as intended.- Fixes #477
-
#511
17294ffThanks @Crunchyman-ralph! - Task Master no longer tells you to update when you're already up to date -
#523
da317f2Thanks @Crunchyman-ralph! - Fix the error handling of task status settings -
#527
a8dabf4Thanks @Crunchyman-ralph! - Remove caching layer from MCP direct functions for task listing, next task, and complexity report- Fixes issues users where having where they were getting stale data
-
#417
a1f8d52Thanks @ksylvan! - Fix for issue #409 LOG_LEVEL Pydantic validation error -
#501
0a61184Thanks @Crunchyman-ralph! - Fix initial .env.example to work out of the box- Closes #419
-
#435
a96215aThanks @lebsral! - Fix default fallback model and maxTokens in Taskmaster initialization -
#517
e96734aThanks @Crunchyman-ralph! - Fix bug when updating tasks on the MCP server (#412) -
#496
efce374Thanks @joedanz! - Fix duplicate output on CLI help screen- Prevent the Task Master CLI from printing the help screen more than once when using
-hor--help. - Removed redundant manual event handlers and guards for help output; now only the Commander
.helpInformationoverride is used for custom help. - Simplified logic so that help is only shown once for both "no arguments" and help flag flows.
- Ensures a clean, branded help experience with no repeated content.
- Fixes #339
- Prevent the Task Master CLI from printing the help screen more than once when using
0.13.1
Patch Changes
- #399
734a4fdThanks @Crunchyman-ralph! - Fix ERR_MODULE_NOT_FOUND when trying to run MCP Server
0.13.0
Minor Changes
-
#240
ef782ffThanks @eyaltoledano! - feat(expand): Enhanceexpandandexpand-allcommands- Integrate
task-complexity-report.jsonto automatically determine the number of subtasks and use tailored prompts for expansion based on prior analysis. You no longer need to try copy-pasting the recommended prompt. If it exists, it will use it for you. You can just runtask-master update --id=[id of task] --researchand it will use that prompt automatically. No extra prompt needed. - Change default behavior to append new subtasks to existing ones. Use the
--forceflag to clear existing subtasks before expanding. This is helpful if you need to add more subtasks to a task but you want to do it by the batch from a given prompt. Use force if you want to start fresh with a task's subtasks.
- Integrate
-
#240
87d97bbThanks @eyaltoledano! - Adds support for the OpenRouter AI provider. Users can now configure models available through OpenRouter (requiring anOPENROUTER_API_KEY) via thetask-master modelscommand, granting access to a wide range of additional LLMs. - IMPORTANT FYI ABOUT OPENROUTER: Taskmaster relies on AI SDK, which itself relies on tool use. It looks like free models sometimes do not include tool use. For example, Gemini 2.5 pro (free) failed via OpenRouter (no tool use) but worked fine on the paid version of the model. Custom model support for Open Router is considered experimental and likely will not be further improved for some time. -
#240
1ab836fThanks @eyaltoledano! - Adds model management and new configuration file .taskmasterconfig which houses the models used for main, research and fallback. Adds models command and setter flags. Adds a --setup flag with an interactive setup. We should be calling this during init. Shows a table of active and available models when models is called without flags. Includes SWE scores and token costs, which are manually entered into the supported_models.json, the new place where models are defined for support. Config-manager.js is the core module responsible for managing the new config." -
#240
c8722b0Thanks @eyaltoledano! - Adds custom model ID support for Ollama and OpenRouter providers.- Adds the
--ollamaand--openrouterflags totask-master models --set-<role>command to set models for those providers outside of the support models list. - Updated
task-master models --setupinteractive mode with options to explicitly enter custom Ollama or OpenRouter model IDs. - Implemented live validation against OpenRouter API (
/api/v1/models) when setting a custom OpenRouter model ID (via flag or setup). - Refined logic to prioritize explicit provider flags/choices over internal model list lookups in case of ID conflicts.
- Added warnings when setting custom/unvalidated models.
- We obviously don't recommend going with a custom, unproven model. If you do and find performance is good, please let us know so we can add it to the list of supported models.
- Adds the
-
#240
2517bc1Thanks @eyaltoledano! - Integrate OpenAI as a new AI provider. - Enhancemodelscommand/tool to display API key status. - Implement model-specificmaxTokensoverride based onsupported-models.jsonto save you if you use an incorrect max token value. -
#240
9a48278Thanks @eyaltoledano! - Tweaks Perplexity AI calls for research mode to max out input tokens and get day-fresh information - Forces temp at 0.1 for highly deterministic output, no variations - Adds a system prompt to further improve the output - Correctly uses the maximum input tokens (8,719, used 8,700) for perplexity - Specificies to use a high degree of research across the web - Specifies to use information that is as fresh as today; this support stuff like capturing brand new announcements like new GPT models and being able to query for those in research. 🔥
Patch Changes
-
#240
842eaf7Thanks @eyaltoledano! - - Add support for Google Gemini models via Vercel AI SDK integration. -
#240
ed79d4fThanks @eyaltoledano! - Add xAI provider and Grok models support -
#378
ad89253Thanks @eyaltoledano! - Better support for file paths on Windows, Linux & WSL.- Standardizes handling of different path formats (URI encoded, Windows, Linux, WSL).
- Ensures tools receive a clean, absolute path suitable for the server OS.
- Simplifies tool implementation by centralizing normalization logic.
-
#285
2acba94Thanks @neno-is-ooo! - Add integration for Roo Code -
#378
d63964aThanks @eyaltoledano! - Improved update-subtask - Now it has context about the parent task details - It also has context about the subtask before it and the subtask after it (if they exist) - Not passing all subtasks to stay token efficient -
#240
5f504faThanks @eyaltoledano! - Improve and adjustinitcommand for robustness and updated dependencies.- Update Initialization Dependencies: Ensure newly initialized projects (
task-master init) include all required AI SDK dependencies (@ai-sdk/*,ai, provider wrappers) in theirpackage.jsonfor out-of-the-box AI feature compatibility. Remove unnecessary dependencies (e.g.,uuid) from the init template. - Silence
npm installduringinit: Preventnpm installoutput from interfering with non-interactive/MCP initialization by suppressing its stdio in silent mode. - Improve Conditional Model Setup: Reliably skip interactive
models --setupduring non-interactiveinitruns (e.g.,init -yor MCP) by checkingisSilentMode()instead of passing flags. - Refactor
init.js: Remove internalisInteractiveflag logic. - Update
initInstructions: Tweak the "Getting Started" text displayed afterinit. - Fix MCP Server Launch: Update
.cursor/mcp.jsontemplate to usenode ./mcp-server/server.jsinstead ofnpx task-master-mcp. - Update Default Model: Change the default main model in the
.taskmasterconfigtemplate.
- Update Initialization Dependencies: Ensure newly initialized projects (
-
#240
96aeeffThanks @eyaltoledano! - Fixes an issue with add-task which did not use the manually defined properties and still needlessly hit the AI endpoint. -
#240
5aea93dThanks @eyaltoledano! - Fixes an issue that prevented remove-subtask with comma separated tasks/subtasks from being deleted (only the first ID was being deleted). Closes #140 -
#240
66ac9abThanks @eyaltoledano! - Improves next command to be subtask-aware - The logic for determining the "next task" (findNextTask function, used by task-master next and the next_task MCP tool) has been significantly improved. Previously, it only considered top-level tasks, making its recommendation less useful when a parent task containing subtasks was already marked 'in-progress'. - The updated logic now prioritizes finding the next available subtask within any 'in-progress' parent task, considering subtask dependencies and priority. - If no suitable subtask is found within active parent tasks, it falls back to recommending the next eligible top-level task based on the original criteria (status, dependencies, priority).This change makes the next command much more relevant and helpful during the implementation phase of complex tasks.
-
#240
ca7b045Thanks @eyaltoledano! - Add--statusflag toshowcommand to filter displayed subtasks. -
#328
5a2371bThanks @knoxgraeme! - Fix --task to --num-tasks in ui + related tests - issue #324 -
#240
6cb213eThanks @eyaltoledano! - Adds a 'models' CLI and MCP command to get the current model configuration, available models, and gives the ability to set main/research/fallback models." - In the CLI,task-master modelsshows the current models config. Using the--setupflag launches an interactive set up that allows you to easily select the models you want to use for each of the three roles. Useqduring the interactive setup to cancel the setup. - In the MCP, responses are simplified in RESTful format (instead of the full CLI output). The agent can use themodelstool with different arguments, includinglistAvailableModelsto get available models. Run without arguments, it will return the current configuration. Arguments are available to set the model for each of the three roles. This allows you to manage Taskmaster AI providers and models directly from either the CLI or MCP or both. - Updated the CLI help menu when you runtask-masterto include missing commands and .taskmasterconfig information. - Adds--researchflag toadd-taskso you can hit up Perplexity right from the add-task flow, rather than having to add a task and then update it.
0.12.1
Patch Changes
- #307
2829194Thanks @Crunchyman-ralph! - Fix add_dependency tool crashing the MCP Server
0.12.0
Minor Changes
-
#253
b2ccd60Thanks @Crunchyman-ralph! - Addnpx task-master-aithat runs mcp instead of using `task-master-mcp`` -
#267
c17d912Thanks @Crunchyman-ralph! - Improve PRD parsing prompt with structured analysis and clearer task generation guidelines. We are testing a new prompt - please provide feedback on your experience.
Patch Changes
-
#243
454a1d9Thanks @Crunchyman-ralph! - - Fixes shebang issue not allowing task-master to run on certain windows operating systems- Resolves #241 #211 #184 #193
-
#268
3e872f8Thanks @Crunchyman-ralph! - Fix remove-task command to handle multiple comma-separated task IDs -
#239
6599cb0Thanks @eyaltoledano! - Updates the parameter descriptions for update, update-task and update-subtask to ensure the MCP server correctly reaches for the right update command based on what is being updated -- all tasks, one task, or a subtask. -
#272
3aee9bcThanks @Crunchyman-ralph! - Enhance theparsePRDto include--appendflag. This flag allows users to append the parsed PRD to an existing file, making it easier to manage multiple PRD files without overwriting existing content. -
#264
ff8e75cThanks @joedanz! - Add quotes around numeric env vars in mcp.json (Windsurf, etc.) -
#248
d99fa00Thanks @Crunchyman-ralph! - - Fixtask-master initpolluting codebase with new packages insidepackage.jsonand modifying projectREADME- Now only initializes with cursor rules, windsurf rules, mcp.json, scripts/example_prd.txt, .gitignore modifications, and
README-task-master.md
- Now only initializes with cursor rules, windsurf rules, mcp.json, scripts/example_prd.txt, .gitignore modifications, and
-
#266
41b979cThanks @Crunchyman-ralph! - Fixed a bug that prevented the task-master from running in a Linux container -
#265
0eb16d5Thanks @Crunchyman-ralph! - Remove the need for project name, description, and version. Since we no longer create a package.json for you
0.11.0
Minor Changes
- #71
7141062Thanks @eyaltoledano! - - Easier Ways to Use Taskmaster (CLI & MCP):- You can now use Taskmaster either by installing it as a standard command-line tool (
task-master) or as an MCP server directly within integrated development tools like Cursor (using its built-in features). This makes Taskmaster accessible regardless of your preferred workflow. - Setting up a new project is simpler in integrated tools, thanks to the new
initialize_projectcapability. - Complete MCP Implementation:
- NOTE: Many MCP clients charge on a per tool basis. In that regard, the most cost-efficient way to use Taskmaster is through the CLI directly. Otherwise, the MCP offers the smoothest and most recommended user experience.
- All MCP tools now follow a standardized output format that mimicks RESTful API responses. They are lean JSON responses that are context-efficient. This is a net improvement over the last version which sent the whole CLI output directly, which needlessly wasted tokens.
- Added a
remove-taskcommand to permanently delete tasks you no longer need. - Many new MCP tools are available for managing tasks (updating details, adding/removing subtasks, generating task files, setting status, finding the next task, breaking down complex tasks, handling dependencies, analyzing complexity, etc.), usable both from the command line and integrated tools. (See the
taskmaster.mdcreference guide and improved readme for a full list).
- Better Task Tracking:
- Added a "cancelled" status option for tasks, providing more ways to categorize work.
- Smoother Experience in Integrated Tools:
- Long-running operations (like breaking down tasks or analysis) now run in the background via an Async Operation Manager with progress updates, so you know what's happening without waiting and can check status later.
- Improved Documentation:
- Added a comprehensive reference guide (
taskmaster.mdc) detailing all commands and tools with examples, usage tips, and troubleshooting info. This is mostly for use by the AI but can be useful for human users as well. - Updated the main README with clearer instructions and added a new tutorial/examples guide.
- Added documentation listing supported integrated tools (like Cursor).
- Added a comprehensive reference guide (
- Increased Stability & Reliability:
- Using Taskmaster within integrated tools (like Cursor) is now more stable and the recommended approach.
- Added automated testing (CI) to catch issues earlier, leading to a more reliable tool.
- Fixed release process issues to ensure users get the correct package versions when installing or updating via npm.
- Better Command-Line Experience:
- Fixed bugs in the
expand-allcommand that could cause NaN errors or JSON formatting issues (especially when using--research). - Fixed issues with parameter validation in the
analyze-complexitycommand (specifically related to thethresholdparameter). - Made the
add-taskcommand more consistent by adding standard flags like--title,--descriptionfor manual task creation so you don't have to use--promptand can quickly drop new ideas and stay in your flow. - Improved error messages for incorrect commands or flags, making them easier to understand.
- Added confirmation warnings before permanently deleting tasks (
remove-task) to prevent mistakes. There's a known bug for deleting multiple tasks with comma-separated values. It'll be fixed next release. - Renamed some background tool names used by integrated tools (e.g.,
list-tasksis nowget_tasks) to be more intuitive if seen in logs or AI interactions. - Smoother project start: Improved the guidance provided to AI assistants immediately after setup (related to
initandparse-prdsteps). This ensures the AI doesn't go on a tangent deciding its own workflow, and follows the exact process outlined in the Taskmaster workflow.
- Fixed bugs in the
- Clearer Error Messages:
- When generating subtasks fails, error messages are now clearer, including specific task IDs and potential suggestions.
- AI fallback from Claude to Perplexity now also works the other way around. If Perplexity is down, will switch to Claude.
- Simplified Setup & Configuration:
- Made it clearer how to configure API keys depending on whether you're using the command-line tool (
.envfile) or an integrated tool (.cursor/mcp.jsonfile). - Taskmaster is now better at automatically finding your project files, especially in integrated tools, reducing the need for manual path settings.
- Fixed an issue that could prevent Taskmaster from working correctly immediately after initialization in integrated tools (related to how the MCP server was invoked). This should solve the issue most users were experiencing with the last release (0.10.x)
- Updated setup templates with clearer examples for API keys.
- **For advanced users setting up the MCP server manually, the command is now
npx -y task-master-ai task-master-mcp.
- Made it clearer how to configure API keys depending on whether you're using the command-line tool (
- Enhanced Performance & AI:
- Updated underlying AI model settings:
- Increased Context Window: Can now handle larger projects/tasks due to an increased Claude context window (64k -> 128k tokens).
- Reduced AI randomness: More consistent and predictable AI outputs (temperature 0.4 -> 0.2).
- Updated default AI models: Uses newer models like
claude-3-7-sonnet-20250219and Perplexitysonar-proby default. - More granular breakdown: Increased the default number of subtasks generated by
expandto 5 (from 4). - Consistent defaults: Set the default priority for new tasks consistently to "medium".
- Improved performance when viewing task details in integrated tools by sending less redundant data.
- Updated underlying AI model settings:
- Documentation Clarity:
- Clarified in documentation that Markdown files (
.md) can be used for Product Requirements Documents (parse_prd). - Improved the description for the
numTasksoption inparse_prdfor better guidance.
- Clarified in documentation that Markdown files (
- Improved Visuals (CLI):
- Enhanced the look and feel of progress bars and status updates in the command line.
- Added a helpful color-coded progress bar to the task details view (
showcommand) to visualize subtask completion. - Made progress bars show a breakdown of task statuses (e.g., how many are pending vs. done).
- Made status counts clearer with text labels next to icons.
- Prevented progress bars from messing up the display on smaller terminal windows.
- Adjusted how progress is calculated for 'deferred' and 'cancelled' tasks in the progress bar, while still showing their distinct status visually.
- Fixes for Integrated Tools:
- Fixed how progress updates are sent to integrated tools, ensuring they display correctly.
- Fixed internal issues that could cause errors or invalid JSON responses when using Taskmaster with integrated tools.
- You can now use Taskmaster either by installing it as a standard command-line tool (
0.10.1
Patch Changes
-
#80
aa185b2Thanks @Crunchyman-ralph! - Remove non-existent package@model-context-protocol/sdk -
#45
757fd47Thanks @Crunchyman-ralph! - Add license to repo
0.10.0
Minor Changes
-
#44
eafdb47Thanks @Crunchyman-ralph! - add github actions to automate github and npm releases -
#20
4eed269Thanks @Crunchyman-ralph! - Implement MCP server for all commands using tools.
Patch Changes
-
#44
44db895Thanks @Crunchyman-ralph! - Added changeset config #39 -
#50
257160aThanks @Crunchyman-ralph! - Fix addTask toolprojectRoot not defined -
#57
9fd42eeThanks @github-actions! - fix mcp server not connecting to cursor -
#48
5ec3651Thanks @Crunchyman-ralph! - Fix workflows