ros/claude-task-master

Fork 0

Files

github-actions[bot] 86027f1ee4 chore: rc version bump

2025-10-04 17:26:07 +00:00

211 KiB

Raw Blame History

task-master-ai

0.28.0-rc.1

Patch Changes

#1274 4f984f8 Thanks @Crunchyman-ralph! - Do a quick fix on build

0.28.0-rc.0

Minor Changes

#1215 0079b7d Thanks @joedanz! - Add Cursor IDE custom slash command support

Expose Task Master commands as Cursor slash commands by copying assets/claude/commands to .cursor/commands on profile add and cleaning up on remove.
#1246 18aa416 Thanks @Crunchyman-ralph! - Added api keys page on docs website: docs.task-master.dev/getting-started/api-keys
#1246 18aa416 Thanks @Crunchyman-ralph! - Move to AI SDK v5:
- Works better with claude-code and gemini-cli as ai providers
- Improved openai model family compatibility
- Migrate ollama provider to v2
- Closes #1223, #1013, #1161, #1174
#1262 738ec51 Thanks @Crunchyman-ralph! - Migrate AI services to use generateObject for structured data generation

This update migrates all AI service calls from generateText to generateObject, ensuring more reliable and structured responses across all commands.

Key Changes:
- Unified AI Service: Replaced separate generateText implementations with a single generateObjectService that handles structured data generation
- JSON Mode Support: Added proper JSON mode configuration for providers that support it (OpenAI, Anthropic, Google, Groq)
- Schema Validation: Integrated Zod schemas for all AI-generated content with automatic validation
- Provider Compatibility: Maintained compatibility with all existing providers while leveraging their native structured output capabilities
- Improved Reliability: Structured output generation reduces parsing errors and ensures consistent data formats
Technical Improvements:
- Centralized provider configuration in ai-providers-unified.js
- Added generateObject support detection for each provider
- Implemented proper error handling for schema validation failures
- Maintained backward compatibility with existing prompt structures
Bug Fixes:
- Fixed subtask ID numbering issue where AI was generating inconsistent IDs (101-105, 601-603) instead of sequential numbering (1, 2, 3...)
- Enhanced prompt instructions to enforce proper ID generation patterns
- Ensured subtasks display correctly as X.1, X.2, X.3 format
This migration improves the reliability and consistency of AI-generated content throughout the Task Master application.
#1112 d67b81d Thanks @olssonsten! - Enhanced Roo Code profile with MCP timeout configuration for improved reliability during long-running AI operations. The Roo profile now automatically configures a 300-second timeout for MCP server operations, preventing timeouts during complex tasks like parse-prd, expand-all, analyze-complexity, and research operations. This change also replaces static MCP configuration files with programmatic generation for better maintainability.

What's New:
- 300-second timeout for MCP operations (up from default 60 seconds)
- Programmatic MCP configuration generation (replaces static asset files)
- Enhanced reliability for AI-powered operations
- Consistent with other AI coding assistant profiles
Migration: No user action required - existing Roo Code installations will automatically receive the enhanced MCP configuration on next initialization.
#1246 986ac11 Thanks @Crunchyman-ralph! - Upgrade grok-cli ai provider to ai sdk v5

Patch Changes

#1235 aaacc3d Thanks @Crunchyman-ralph! - Improve analyze-complexity cli docs and --research flag documentation
#1251 0b2c696 Thanks @Crunchyman-ralph! - Change parent task back to "pending" when all subtasks are in "pending" state
#1172 b5fe723 Thanks @jujax! - Fix Claude Code settings validation for pathToClaudeCodeExecutable
#1192 2b69936 Thanks @nukunga! - Fix sonar deep research model failing, should be called sonar-deep-research
#1270 20004a3 Thanks @Crunchyman-ralph! - Fix complexity score not showing for task-master show and task-master list
- Added complexity score on "next task" when running task-master list
- Added colors to complexity to reflect complexity (easy, medium, hard)

0.27.3

Patch Changes

#1254 af53525 Thanks @Crunchyman-ralph! - Fixed issue where tm show command could not find subtasks using dotted notation IDs (e.g., '8.1').
- The command now properly searches within parent task subtasks and returns the correct subtask information.

0.27.2

Patch Changes

#1248 044a7bf Thanks @Crunchyman-ralph! - Fix set-status for subtasks:
- Parent tasks are now set as done when subtasks are all done
- Parent tasks are now set as in-progress when at least one subtask is in-progress or done

0.27.1

Patch Changes

#1232 f487736 Thanks @Crunchyman-ralph! - Fix module not found for new 0.27.0 release
#1233 c911608 Thanks @Crunchyman-ralph! - Fix Zed MCP configuration by adding required "source" property
- Add "source": "custom" property to task-master-ai server in Zed settings.json

0.27.1-rc.1

Patch Changes

#1233 1a18794 Thanks @Crunchyman-ralph! - One last testing final final

0.27.1-rc.0

Patch Changes

#1232 f487736 Thanks @Crunchyman-ralph! - Fix module not found for new 0.27.0 release

0.27.0

Minor Changes

#1220 4e12643 Thanks @Crunchyman-ralph! - No longer need --package=task-master-ai in mcp server
- A lot of users were having issues with Taskmaster and usually a simple fix was to remove --package from your mcp.json
- we now bundle our whole package, so we no longer need the --package
#1200 fce8414 Thanks @eyaltoledano! - Add new task-master start command for automated task execution with Claude Code
- You can now start working on tasks directly by running task-master start <task-id> which will automatically launch Claude Code with a comprehensive prompt containing all task details, implementation guidelines, and context.
- task-master start will automatically detect next-task when no ID is provided.
#1200 fce8414 Thanks @eyaltoledano! - Move from javascript to typescript, not a full refactor but we now have a typescript environment and are moving our javascript commands slowly into typescript
#1200 fce8414 Thanks @eyaltoledano! - Add grok-cli as a provider with full codebase context support. You can now use Grok models (grok-2, grok-3, grok-4, etc.) with Task Master for AI operations that have access to your entire codebase context, enabling more informed task generation and PRD parsing.

Setup Instructions
1. Get your Grok API key from console.x.ai
2. Set the environment variable:
```
export GROK_CLI_API_KEY="your-api-key-here"
```
3. Configure Task Master to use Grok:
```
task-master models --set-main grok-beta
# or
task-master models --set-research grok-beta
# or
task-master models --set-fallback grok-beta
```
Key Features
- Full codebase context: Grok models can analyze your entire project when generating tasks or parsing PRDs
- xAI model access: Support for latest Grok models (grok-2, grok-3, grok-4, etc.)
- Code-aware task generation: Create more accurate and contextual tasks based on your actual codebase
- Intelligent PRD parsing: Parse requirements with understanding of your existing code structure
Available Models
- grok-beta - Latest Grok model with codebase context
- grok-vision-beta - Grok with vision capabilities and codebase context
The Grok CLI provider integrates with xAI's Grok models via grok-cli and can also use the local Grok CLI configuration file (~/.grok/user-settings.json) if available.

Credits

Built using the grok-cli by Superagent AI for seamless integration with xAI's Grok models.
#1225 a621ff0 Thanks @Crunchyman-ralph! - Improve taskmaster ai provider defaults
- moving from main anthropic 3.7 to anthropic sonnet 4
- moving from fallback anthropic 3.5 to anthropic 3.7
#1217 e6de285 Thanks @Crunchyman-ralph! - @tm/cli: add auto-update functionality to every command
#1200 fce8414 Thanks @eyaltoledano! - Fix Grok model configuration validation and update deprecated Claude fallback model. Grok models now properly support their full 131K token capacity, and the fallback model has been upgraded to Claude Sonnet 4 for better performance and future compatibility.

0.27.0-rc.2

Minor Changes

#1217 e6de285 Thanks @Crunchyman-ralph! - @tm/cli: add auto-update functionality to every command

0.27.0-rc.1

Minor Changes

255b9f0 Thanks @Crunchyman-ralph! - Testing one more pre-release iteration

0.27.0-rc.0

Minor Changes

#1213 137ef36 Thanks @Crunchyman-ralph! - Test out the RC

Patch Changes

Updated dependencies [137ef36]:
- @tm/cli@0.27.0-rc.0

0.26.0

Minor Changes

#1133 df26c65 Thanks @neonwatty! - Restore Taskmaster claude-code commands and move clear commands under /remove to avoid collision with the claude-code /clear command.
#1163 37af0f1 Thanks @Crunchyman-ralph! - Enhanced Gemini CLI provider with codebase-aware task generation

Added automatic codebase analysis for Gemini CLI provider in parse-prd, and analyze-complexity, add-task, udpate-task, update, update-subtask commands When using Gemini CLI as the AI provider, Task Master now instructs the AI to analyze the project structure, existing implementations, and patterns before generating tasks or subtasks Tasks and subtasks generated by Claude Code are now informed by actual codebase analysis, resulting in more accurate and contextual outputs
#1165 c4f92f6 Thanks @Crunchyman-ralph! - Add configurable codebase analysis feature flag with multiple configuration sources

Users can now control whether codebase analysis features (Claude Code and Gemini CLI integration) are enabled through environment variables, MCP configuration, or project config files.

Priority order: .env > MCP session env > .taskmaster/config.json.

Set TASKMASTER_ENABLE_CODEBASE_ANALYSIS=false in .env to disable codebase analysis prompts and tool integration.
#1135 8783708 Thanks @mm-parthy! - feat(move): improve cross-tag move UX and safety
- CLI: print "Next Steps" tips after cross-tag moves that used --ignore-dependencies (validate/fix guidance)
- CLI: show dedicated help block on ID collisions (destination tag already has the ID)
- Core: add structured suggestions to TASK_ALREADY_EXISTS errors
- MCP: map ID collision errors to TASK_ALREADY_EXISTS and include suggestions
- Tests: cover MCP options, error suggestions, CLI tips printing, and integration error payload suggestions
#1162 4dad2fd Thanks @Crunchyman-ralph! - Enhanced Claude Code and Google CLI integration with automatic codebase analysis for task operations

When using Claude Code as the AI provider, task management commands now automatically analyze your codebase before generating or updating tasks. This provides more accurate, context-aware implementation details that align with your project's existing architecture and patterns.

Commands contextualised:
- add-task
- update-subtask
- update-task
- update

Patch Changes

#1135 8783708 Thanks @mm-parthy! - docs(move): clarify cross-tag move docs; deprecate "force"; add explicit --with-dependencies/--ignore-dependencies examples

0.26.0-rc.1

Minor Changes

#1165 c4f92f6 Thanks @Crunchyman-ralph! - Add configurable codebase analysis feature flag with multiple configuration sources

Users can now control whether codebase analysis features (Claude Code and Gemini CLI integration) are enabled through environment variables, MCP configuration, or project config files.

Priority order: .env > MCP session env > .taskmaster/config.json.

Set TASKMASTER_ENABLE_CODEBASE_ANALYSIS=false in .env to disable codebase analysis prompts and tool integration.

0.26.0-rc.0

Minor Changes

#1163 37af0f1 Thanks @Crunchyman-ralph! - Enhanced Gemini CLI provider with codebase-aware task generation

Added automatic codebase analysis for Gemini CLI provider in parse-prd, and analyze-complexity, add-task, udpate-task, update, update-subtask commands When using Gemini CLI as the AI provider, Task Master now instructs the AI to analyze the project structure, existing implementations, and patterns before generating tasks or subtasks Tasks and subtasks generated by Claude Code are now informed by actual codebase analysis, resulting in more accurate and contextual outputs
#1135 8783708 Thanks @mm-parthy! - feat(move): improve cross-tag move UX and safety
- CLI: print "Next Steps" tips after cross-tag moves that used --ignore-dependencies (validate/fix guidance)
- CLI: show dedicated help block on ID collisions (destination tag already has the ID)
- Core: add structured suggestions to TASK_ALREADY_EXISTS errors
- MCP: map ID collision errors to TASK_ALREADY_EXISTS and include suggestions
- Tests: cover MCP options, error suggestions, CLI tips printing, and integration error payload suggestions
#1162 4dad2fd Thanks @Crunchyman-ralph! - Enhanced Claude Code and Google CLI integration with automatic codebase analysis for task operations

When using Claude Code as the AI provider, task management commands now automatically analyze your codebase before generating or updating tasks. This provides more accurate, context-aware implementation details that align with your project's existing architecture and patterns.

Commands contextualised:
- add-task
- update-subtask
- update-task
- update

Patch Changes

#1135 8783708 Thanks @mm-parthy! - docs(move): clarify cross-tag move docs; deprecate "force"; add explicit --with-dependencies/--ignore-dependencies examples

0.25.1

Patch Changes

#1152 8933557 Thanks @ben-vargas! - fix(claude-code): prevent crash/hang when the optional @anthropic-ai/claude-code SDK is missing by guarding AbortError instanceof checks and adding explicit SDK presence checks in doGenerate/doStream. Also bump the optional dependency to ^1.0.88 for improved export consistency.

Related to JSON truncation handling in #920; this change addresses a separate error-path crash reported in #1142.
#1151 db720a9 Thanks @Crunchyman-ralph! - Temporarily disable streaming for improved model compatibility - will be re-enabled in upcoming release

0.25.0

Minor Changes

#1088 04e11b5 Thanks @mm-parthy! - Add cross-tag task movement functionality for organizing tasks across different contexts.

This feature enables moving tasks between different tags (contexts) in your project, making it easier to organize work across different branches, environments, or project phases.

CLI Usage Examples

Move a single task from one tag to another:

# Move task 5 from backlog tag to in-progress tag
task-master move --from=5 --from-tag=backlog --to-tag=feature-1

# Move task with its dependencies
task-master move --from=5 --from-tag=backlog --to-tag=feature-2 --with-dependencies

# Move task without checking dependencies
task-master move --from=5 --from-tag=backlog --to-tag=bug-3 --ignore-dependencies

Move multiple tasks at once:

# Move multiple tasks between tags
task-master move --from=5,6,7 --from-tag=backlog --to-tag=bug-4 --with-dependencies

#1040 fc47714 Thanks @DomVidja! - "Add Kilo Code profile integration with custom modes and MCP configuration"
#1054 782728f Thanks @martincik! - Add compact mode --compact / -c flag to the tm list CLI command
- outputs tasks in a minimal, git-style one-line format. This reduces verbose output from ~30+ lines of dashboards and tables to just 1 line per task, making it much easier to quickly scan available tasks.
  - Git-style format: ID STATUS TITLE (PRIORITY) → DEPS
  - Color-coded status, priority, and dependencies
  - Smart title truncation and dependency abbreviation
  - Subtask support with indentation
  - Full backward compatibility with existing list options
#1048 e3ed4d7 Thanks @joedanz! - Add CLI & MCP progress tracking for parse-prd command.
#1124 95640dc Thanks @Crunchyman-ralph! - Add support for ollama gpt-oss:20b and gpt-oss:120b
#1123 311b243 Thanks @Crunchyman-ralph! - Remove clear Taskmaster claude code commands since they were too close to the claude-code clear command

Patch Changes

#1131 3dee60d Thanks @joedanz! - Update Cursor one-click install link to new URL format
#1088 04e11b5 Thanks @mm-parthy! - Fix add-tag --from-branch command error where projectRoot was not properly referenced

The command was failing with "projectRoot is not defined" error because the code was directly referencing projectRoot instead of context.projectRoot in the git repository checks. This fix corrects the variable references to use the proper context object.

0.25.0-rc.0

Minor Changes

#1088 04e11b5 Thanks @mm-parthy! - Add cross-tag task movement functionality for organizing tasks across different contexts.

This feature enables moving tasks between different tags (contexts) in your project, making it easier to organize work across different branches, environments, or project phases.

CLI Usage Examples

Move a single task from one tag to another:

# Move task 5 from backlog tag to in-progress tag
task-master move --from=5 --from-tag=backlog --to-tag=feature-1

# Move task with its dependencies
task-master move --from=5 --from-tag=backlog --to-tag=feature-2 --with-dependencies

# Move task without checking dependencies
task-master move --from=5 --from-tag=backlog --to-tag=bug-3 --ignore-dependencies

Move multiple tasks at once:

# Move multiple tasks between tags
task-master move --from=5,6,7 --from-tag=backlog --to-tag=bug-4 --with-dependencies

#1040 fc47714 Thanks @DomVidja! - "Add Kilo Code profile integration with custom modes and MCP configuration"
#1054 782728f Thanks @martincik! - Add compact mode --compact / -c flag to the tm list CLI command
- outputs tasks in a minimal, git-style one-line format. This reduces verbose output from ~30+ lines of dashboards and tables to just 1 line per task, making it much easier to quickly scan available tasks.
  - Git-style format: ID STATUS TITLE (PRIORITY) → DEPS
  - Color-coded status, priority, and dependencies
  - Smart title truncation and dependency abbreviation
  - Subtask support with indentation
  - Full backward compatibility with existing list options
#1048 e3ed4d7 Thanks @joedanz! - Add CLI & MCP progress tracking for parse-prd command.
#1124 95640dc Thanks @Crunchyman-ralph! - Add support for ollama gpt-oss:20b and gpt-oss:120b
#1123 311b243 Thanks @Crunchyman-ralph! - Remove clear Taskmaster claude code commands since they were too close to the claude-code clear command

Patch Changes

#1131 3dee60d Thanks @joedanz! - Update Cursor one-click install link to new URL format
#1088 04e11b5 Thanks @mm-parthy! - Fix add-tag --from-branch command error where projectRoot was not properly referenced

The command was failing with "projectRoot is not defined" error because the code was directly referencing projectRoot instead of context.projectRoot in the git repository checks. This fix corrects the variable references to use the proper context object.

0.24.0

Minor Changes

#1098 36468f3 Thanks @Crunchyman-ralph! - Enhanced Claude Code provider with codebase-aware task generation
- Added automatic codebase analysis for Claude Code provider in parse-prd, expand-task, and analyze-complexity commands
- When using Claude Code as the AI provider, Task Master now instructs the AI to analyze the project structure, existing implementations, and patterns before generating tasks or subtasks
- Tasks and subtasks generated by Claude Code are now informed by actual codebase analysis, resulting in more accurate and contextual outputs
#1105 75c514c Thanks @Crunchyman-ralph! - Add GPT-5 support with proper parameter handling
- Added GPT-5 model to supported models configuration with SWE score of 0.749
#1091 4bb6370 Thanks @Crunchyman-ralph! - Add Claude Code subagent support with task-orchestrator, task-executor, and task-checker

New Claude Code Agents

Added specialized agents for Claude Code users to enable parallel task execution, intelligent task orchestration, and quality assurance:

task-orchestrator

Coordinates and manages the execution of Task Master tasks with intelligent dependency analysis:
- Analyzes task dependencies to identify parallelizable work
- Deploys multiple task-executor agents for concurrent execution
- Monitors task completion and updates the dependency graph
- Automatically identifies and starts newly unblocked tasks
task-executor

Handles the actual implementation of individual tasks:
- Executes specific tasks identified by the orchestrator
- Works on concrete implementation rather than planning
- Updates task status and logs progress
- Can work in parallel with other executors on independent tasks
task-checker

Verifies that completed tasks meet their specifications:
- Reviews tasks marked as 'review' status
- Validates implementation against requirements
- Runs tests and checks for best practices
- Ensures quality before marking tasks as 'done'
Installation

When using the Claude profile (task-master rules add claude), the agents are automatically installed to .claude/agents/ directory.

Usage Example
```
# In Claude Code, after initializing a project with tasks:

# Use task-orchestrator to analyze and coordinate work
# The orchestrator will:
# 1. Check task dependencies
# 2. Identify tasks that can run in parallel
# 3. Deploy executors for available work
# 4. Monitor progress and deploy new executors as tasks complete

# Use task-executor for specific task implementation
# When the orchestrator identifies task 2.3 needs work:
# The executor will implement that specific task
```
Benefits
- Parallel Execution: Multiple independent tasks can be worked on simultaneously
- Intelligent Scheduling: Orchestrator understands dependencies and optimizes execution order
- Separation of Concerns: Planning (orchestrator) is separated from execution (executor)
- Progress Tracking: Real-time updates as tasks are completed
- Automatic Progression: As tasks complete, newly unblocked tasks are automatically started

Patch Changes

#1094 4357af3 Thanks @Crunchyman-ralph! - Fix expand task generating unrelated generic subtasks

Fixed an issue where task-master expand would generate generic authentication-related subtasks regardless of the parent task context when using complexity reports. The expansion now properly includes the parent task details alongside any expansion guidance.
#1079 e495b2b Thanks @Crunchyman-ralph! - Fix scope-up/down prompts to include all required fields for better AI model compatibility
- Added missing priority field to scope adjustment prompts to prevent validation errors with Claude-code and other models
- Ensures generated JSON includes all fields required by the schema
#1079 e495b2b Thanks @Crunchyman-ralph! - Fix MCP scope-up/down tools not finding tasks
- Fixed task ID parsing in MCP layer - now correctly converts string IDs to numbers
- scope_up_task and scope_down_task MCP tools now work properly
#1079 e495b2b Thanks @Crunchyman-ralph! - Improve AI provider compatibility for JSON generation
- Fixed schema compatibility issues between Perplexity and OpenAI o3 models
- Removed nullable/default modifiers from Zod schemas for broader compatibility
- Added automatic JSON repair for malformed AI responses (handles cases like missing array values)
- Perplexity now uses JSON mode for more reliable structured output
- Post-processing handles default values separately from schema validation

0.24.0-rc.2

Minor Changes

#1105 75c514c Thanks @Crunchyman-ralph! - Add GPT-5 support with proper parameter handling
- Added GPT-5 model to supported models configuration with SWE score of 0.749

0.24.0-rc.1

Minor Changes

#1093 36468f3 Thanks @Crunchyman-ralph! - Enhanced Claude Code provider with codebase-aware task generation
- Added automatic codebase analysis for Claude Code provider in parse-prd, expand-task, and analyze-complexity commands
- When using Claude Code as the AI provider, Task Master now instructs the AI to analyze the project structure, existing implementations, and patterns before generating tasks or subtasks
- Tasks and subtasks generated by Claude Code are now informed by actual codebase analysis, resulting in more accurate and contextual outputs
#1091 4bb6370 Thanks @Crunchyman-ralph! - Add Claude Code subagent support with task-orchestrator, task-executor, and task-checker

New Claude Code Agents

Added specialized agents for Claude Code users to enable parallel task execution, intelligent task orchestration, and quality assurance:

task-orchestrator

Coordinates and manages the execution of Task Master tasks with intelligent dependency analysis:
- Analyzes task dependencies to identify parallelizable work
- Deploys multiple task-executor agents for concurrent execution
- Monitors task completion and updates the dependency graph
- Automatically identifies and starts newly unblocked tasks
task-executor

Handles the actual implementation of individual tasks:
- Executes specific tasks identified by the orchestrator
- Works on concrete implementation rather than planning
- Updates task status and logs progress
- Can work in parallel with other executors on independent tasks
task-checker

Verifies that completed tasks meet their specifications:
- Reviews tasks marked as 'review' status
- Validates implementation against requirements
- Runs tests and checks for best practices
- Ensures quality before marking tasks as 'done'
Installation

When using the Claude profile (task-master rules add claude), the agents are automatically installed to .claude/agents/ directory.

Usage Example
```
# In Claude Code, after initializing a project with tasks:

# Use task-orchestrator to analyze and coordinate work
# The orchestrator will:
# 1. Check task dependencies
# 2. Identify tasks that can run in parallel
# 3. Deploy executors for available work
# 4. Monitor progress and deploy new executors as tasks complete

# Use task-executor for specific task implementation
# When the orchestrator identifies task 2.3 needs work:
# The executor will implement that specific task
```
Benefits
- Parallel Execution: Multiple independent tasks can be worked on simultaneously
- Intelligent Scheduling: Orchestrator understands dependencies and optimizes execution order
- Separation of Concerns: Planning (orchestrator) is separated from execution (executor)
- Progress Tracking: Real-time updates as tasks are completed
- Automatic Progression: As tasks complete, newly unblocked tasks are automatically started

Patch Changes

#1094 4357af3 Thanks @Crunchyman-ralph! - Fix expand task generating unrelated generic subtasks

Fixed an issue where task-master expand would generate generic authentication-related subtasks regardless of the parent task context when using complexity reports. The expansion now properly includes the parent task details alongside any expansion guidance.

0.23.1-rc.0

Patch Changes

#1079 e495b2b Thanks @Crunchyman-ralph! - Fix scope-up/down prompts to include all required fields for better AI model compatibility
- Added missing priority field to scope adjustment prompts to prevent validation errors with Claude-code and other models
- Ensures generated JSON includes all fields required by the schema
#1079 e495b2b Thanks @Crunchyman-ralph! - Fix MCP scope-up/down tools not finding tasks
- Fixed task ID parsing in MCP layer - now correctly converts string IDs to numbers
- scope_up_task and scope_down_task MCP tools now work properly
#1079 e495b2b Thanks @Crunchyman-ralph! - Improve AI provider compatibility for JSON generation
- Fixed schema compatibility issues between Perplexity and OpenAI o3 models
- Removed nullable/default modifiers from Zod schemas for broader compatibility
- Added automatic JSON repair for malformed AI responses (handles cases like missing array values)
- Perplexity now uses JSON mode for more reliable structured output
- Post-processing handles default values separately from schema validation

0.23.0

Minor Changes

#1064 53903f1 Thanks @eyaltoledano! - Add new scope-up and scope-down commands for dynamic task complexity adjustment

This release introduces two powerful new commands that allow you to dynamically adjust the complexity of your tasks and subtasks without recreating them from scratch.

New CLI Commands:
- task-master scope-up - Increase task complexity (add more detail, requirements, or implementation steps)
- task-master scope-down - Decrease task complexity (simplify, remove unnecessary details, or streamline)
Key Features:
- Multiple tasks: Support comma-separated IDs to adjust multiple tasks at once (--id=5,7,12)
- Strength levels: Choose adjustment intensity with --strength=light|regular|heavy (defaults to regular)
- Custom prompts: Use --prompt flag to specify exactly how you want tasks adjusted
- MCP integration: Available as scope_up_task and scope_down_task tools in Cursor and other MCP environments
- Smart context: AI considers your project context and task dependencies when making adjustments
Usage Examples:
```
# Make a task more detailed
task-master scope-up --id=5

# Simplify multiple tasks with light touch
task-master scope-down --id=10,11,12 --strength=light

# Custom adjustment with specific instructions
task-master scope-up --id=7 --prompt="Add more error handling and edge cases"
```
Why use this?
- Iterative refinement: Adjust task complexity as your understanding evolves
- Project phase adaptation: Scale tasks up for implementation, down for planning
- Team coordination: Adjust complexity based on team member experience levels
- Milestone alignment: Fine-tune tasks to match project phase requirements
Perfect for agile workflows where task requirements change as you learn more about the problem space.

Patch Changes

#1063 2ae6e7e Thanks @Crunchyman-ralph! - Fix for tasks not found when using string IDs
#1049 45a14c3 Thanks @ben-vargas! - Fix tag-specific complexity report detection in expand command

The expand command now correctly finds and uses tag-specific complexity reports (e.g., task-complexity-report_feature-xyz.json) when operating in a tag context. Previously, it would always look for the generic task-complexity-report.json file due to a default value in the CLI option definition.

0.23.0-rc.2

Minor Changes

#1064 53903f1 Thanks @Crunchyman-ralph! - Add new scope-up and scope-down commands for dynamic task complexity adjustment

This release introduces two powerful new commands that allow you to dynamically adjust the complexity of your tasks and subtasks without recreating them from scratch.

New CLI Commands:
- task-master scope-up - Increase task complexity (add more detail, requirements, or implementation steps)
- task-master scope-down - Decrease task complexity (simplify, remove unnecessary details, or streamline)
Key Features:
- Multiple tasks: Support comma-separated IDs to adjust multiple tasks at once (--id=5,7,12)
- Strength levels: Choose adjustment intensity with --strength=light|regular|heavy (defaults to regular)
- Custom prompts: Use --prompt flag to specify exactly how you want tasks adjusted
- MCP integration: Available as scope_up_task and scope_down_task tools in Cursor and other MCP environments
- Smart context: AI considers your project context and task dependencies when making adjustments
Usage Examples:
```
# Make a task more detailed
task-master scope-up --id=5

# Simplify multiple tasks with light touch
task-master scope-down --id=10,11,12 --strength=light

# Custom adjustment with specific instructions
task-master scope-up --id=7 --prompt="Add more error handling and edge cases"
```
Why use this?
- Iterative refinement: Adjust task complexity as your understanding evolves
- Project phase adaptation: Scale tasks up for implementation, down for planning
- Team coordination: Adjust complexity based on team member experience levels
- Milestone alignment: Fine-tune tasks to match project phase requirements
Perfect for agile workflows where task requirements change as you learn more about the problem space.

0.22.1-rc.1

Patch Changes

#1069 72ca68e Thanks @eyaltoledano! - Add new scope-up and scope-down commands for dynamic task complexity adjustment

This release introduces two powerful new commands that allow you to dynamically adjust the complexity of your tasks and subtasks without recreating them from scratch.

New CLI Commands:
- task-master scope-up - Increase task complexity (add more detail, requirements, or implementation steps)
- task-master scope-down - Decrease task complexity (simplify, remove unnecessary details, or streamline)
Key Features:
- Multiple tasks: Support comma-separated IDs to adjust multiple tasks at once (--id=5,7,12)
- Strength levels: Choose adjustment intensity with --strength=light|regular|heavy (defaults to regular)
- Custom prompts: Use --prompt flag to specify exactly how you want tasks adjusted
- MCP integration: Available as scope_up_task and scope_down_task tools in Cursor and other MCP environments
- Smart context: AI considers your project context and task dependencies when making adjustments
Usage Examples:
```
# Make a task more detailed
task-master scope-up --id=5

# Simplify multiple tasks with light touch
task-master scope-down --id=10,11,12 --strength=light

# Custom adjustment with specific instructions
task-master scope-up --id=7 --prompt="Add more error handling and edge cases"
```
Why use this?
- Iterative refinement: Adjust task complexity as your understanding evolves
- Project phase adaptation: Scale tasks up for implementation, down for planning
- Team coordination: Adjust complexity based on team member experience levels
- Milestone alignment: Fine-tune tasks to match project phase requirements
Perfect for agile workflows where task requirements change as you learn more about the problem space.

0.22.1-rc.0

Patch Changes

#1063 2ae6e7e Thanks @Crunchyman-ralph! - Fix for tasks not found when using string IDs
#1049 45a14c3 Thanks @ben-vargas! - Fix tag-specific complexity report detection in expand command

The expand command now correctly finds and uses tag-specific complexity reports (e.g., task-complexity-report_feature-xyz.json) when operating in a tag context. Previously, it would always look for the generic task-complexity-report.json file due to a default value in the CLI option definition.

0.22.0

Minor Changes

#1043 dc44ed9 Thanks @Crunchyman-ralph! - Prompt to generate a complexity report when it is missing
#1032 4423119 Thanks @Crunchyman-ralph! - Add comprehensive Kiro IDE integration with autonomous task management hooks
- Kiro Profile: Added full support for Kiro IDE with automatic installation of 7 Taskmaster agent hooks
- Hook-Driven Workflow: Introduced natural language automation hooks that eliminate manual task status updates
- Automatic Hook Installation: Hooks are now automatically copied to .kiro/hooks/ when running task-master rules add kiro
- Language-Agnostic Support: All hooks support multiple programming languages (JS, Python, Go, Rust, Java, etc.)
- Frontmatter Transformation: Kiro rules use simplified inclusion: always format instead of Cursor's complex frontmatter
- Special Rule: Added taskmaster_hooks_workflow.md that guides AI assistants to prefer hook-driven completion
Key hooks included:
- Task Dependency Auto-Progression: Automatically starts tasks when dependencies complete
- Code Change Task Tracker: Updates task progress as you save files
- Test Success Task Completer: Marks tasks done when tests pass
- Daily Standup Assistant: Provides personalized task status summaries
- PR Readiness Checker: Validates task completion before creating pull requests
- Complexity Analyzer: Auto-expands complex tasks into manageable subtasks
- Git Commit Task Linker: Links commits to tasks for better traceability
This creates a truly autonomous development workflow where task management happens naturally as you code!

Patch Changes

#1033 7b90568 Thanks @ben-vargas! - Fix compatibility with @google/gemini-cli-core v0.1.12+ by updating ai-sdk-provider-gemini-cli to v0.1.1.
#1038 77cc5e4 Thanks @Crunchyman-ralph! - Fix 'expand --all' and 'show' commands to correctly handle tag contexts for complexity reports and task display.
#1025 8781794 Thanks @joedanz! - Clean up remaining automatic task file generation calls
#1035 fb7d588 Thanks @Crunchyman-ralph! - Fix max_tokens limits for OpenRouter and Groq models
- Add special handling in config-manager.js for custom OpenRouter models to use a conservative default of 32,768 max_tokens
- Update qwen/qwen-turbo model max_tokens from 1,000,000 to 32,768 to match OpenRouter's actual limits
- Fix moonshotai/kimi-k2-instruct max_tokens to 16,384 to match Groq's actual limit (fixes #1028)
- This prevents "maximum context length exceeded" errors when using OpenRouter models not in our supported models list
#1027 6ae66b2 Thanks @andreswebs! - Fix VSCode profile generation to use correct rule file names (using .instructions.md extension instead of .md) and front-matter properties (removing the unsupported alwaysApply property from instructions files' front-matter).

0.22.0-rc.1

Minor Changes

#1043 dc44ed9 Thanks @Crunchyman-ralph! - Prompt to generate a complexity report when it is missing

0.22.0-rc.0

Minor Changes

#1032 4423119 Thanks @Crunchyman-ralph! - Add comprehensive Kiro IDE integration with autonomous task management hooks
- Kiro Profile: Added full support for Kiro IDE with automatic installation of 7 Taskmaster agent hooks
- Hook-Driven Workflow: Introduced natural language automation hooks that eliminate manual task status updates
- Automatic Hook Installation: Hooks are now automatically copied to .kiro/hooks/ when running task-master rules add kiro
- Language-Agnostic Support: All hooks support multiple programming languages (JS, Python, Go, Rust, Java, etc.)
- Frontmatter Transformation: Kiro rules use simplified inclusion: always format instead of Cursor's complex frontmatter
- Special Rule: Added taskmaster_hooks_workflow.md that guides AI assistants to prefer hook-driven completion
Key hooks included:
- Task Dependency Auto-Progression: Automatically starts tasks when dependencies complete
- Code Change Task Tracker: Updates task progress as you save files
- Test Success Task Completer: Marks tasks done when tests pass
- Daily Standup Assistant: Provides personalized task status summaries
- PR Readiness Checker: Validates task completion before creating pull requests
- Complexity Analyzer: Auto-expands complex tasks into manageable subtasks
- Git Commit Task Linker: Links commits to tasks for better traceability
This creates a truly autonomous development workflow where task management happens naturally as you code!

Patch Changes

#1033 7b90568 Thanks @ben-vargas! - Fix compatibility with @google/gemini-cli-core v0.1.12+ by updating ai-sdk-provider-gemini-cli to v0.1.1.
#1038 77cc5e4 Thanks @Crunchyman-ralph! - Fix 'expand --all' and 'show' commands to correctly handle tag contexts for complexity reports and task display.
#1025 8781794 Thanks @joedanz! - Clean up remaining automatic task file generation calls
#1035 fb7d588 Thanks @Crunchyman-ralph! - Fix max_tokens limits for OpenRouter and Groq models
- Add special handling in config-manager.js for custom OpenRouter models to use a conservative default of 32,768 max_tokens
- Update qwen/qwen-turbo model max_tokens from 1,000,000 to 32,768 to match OpenRouter's actual limits
- Fix moonshotai/kimi-k2-instruct max_tokens to 16,384 to match Groq's actual limit (fixes #1028)
- This prevents "maximum context length exceeded" errors when using OpenRouter models not in our supported models list
#1027 6ae66b2 Thanks @andreswebs! - Fix VSCode profile generation to use correct rule file names (using .instructions.md extension instead of .md) and front-matter properties (removing the unsupported alwaysApply property from instructions files' front-matter).

0.21.0

Minor Changes

#1009 9c58a92 Thanks @Crunchyman-ralph! - Add Kiro editor rule profile support
- Add support for Kiro IDE with custom rule files and MCP configuration
- Generate rule files in .kiro/steering/ directory with markdown format
- Include MCP server configuration with enhanced file inclusion patterns
#1009 444aa5a Thanks @Crunchyman-ralph! - Created a comprehensive documentation site for Task Master AI. Visit https://docs.task-master.dev to explore guides, API references, and examples.
#1009 58a301c Thanks @Crunchyman-ralph! - Complete Groq provider integration and add MoonshotAI Kimi K2 model support
- Fixed Groq provider registration
- Added Groq API key validation
- Added GROQ_API_KEY to .env.example
- Added moonshotai/kimi-k2-instruct model with $1/$3 per 1M token pricing and 16k max output
#1009 b0e09c7 Thanks @Crunchyman-ralph! - feat: Add Zed editor rule profile with agent rules and MCP config
- Resolves #637
#1009 6c5e0f9 Thanks @Crunchyman-ralph! - Add Amp rule profile with AGENT.md and MCP config
#1009 444aa5a Thanks @Crunchyman-ralph! - Improve project root detection
- No longer creates an infinite loop when unable to detect your code workspace
#1009 36c4a7a Thanks @Crunchyman-ralph! - Add OpenCode profile with AGENTS.md and MCP config
- Resolves #965

Patch Changes

#1009 444aa5a Thanks @Crunchyman-ralph! - Make task-master update more reliable with AI responses

The update command now handles AI responses more robustly. If the AI forgets to include certain task fields, the command will automatically fill in the missing data from your original tasks instead of failing. This means smoother bulk task updates without losing important information like IDs, dependencies, or completed subtasks.
#1009 444aa5a Thanks @Crunchyman-ralph! - Fix subtask dependency validation when expanding tasks

When using task-master expand to break down tasks into subtasks, dependencies between subtasks are now properly validated. Previously, subtasks with dependencies would fail validation. Now subtasks can correctly depend on their siblings within the same parent task.
#1009 6d69d02 Thanks @Crunchyman-ralph! - Prevent CLAUDE.md overwrite by using Claude Code's import feature
- Task Master now creates its instructions in .taskmaster/CLAUDE.md instead of overwriting the user's CLAUDE.md
- Adds an import section to the user's CLAUDE.md that references the Task Master instructions
- Preserves existing user content in CLAUDE.md files
- Provides clean uninstall that only removes Task Master's additions
Breaking Change: Task Master instructions for Claude Code are now stored in .taskmaster/CLAUDE.md and imported into the main CLAUDE.md file. Users who previously had Task Master content directly in their CLAUDE.md will need to run task-master rules remove claude followed by task-master rules add claude to migrate to the new structure.
#1009 fd005c4 Thanks @Crunchyman-ralph! - Implement Boundary-First Tag Resolution to ensure consistent and deterministic tag handling across CLI and MCP, resolving potential race conditions.
#1009 444aa5a Thanks @Crunchyman-ralph! - Fix task-master lang --setup breaking when no language is defined, now defaults to English
#1009 624922c Thanks @Crunchyman-ralph! - Fix: show command no longer requires complexity report file to exist

The tm show command was incorrectly requiring the complexity report file to exist even when not needed. Now it only validates the complexity report path when a custom report file is explicitly provided via the -r/--report option.
#1009 858d4a1 Thanks @Crunchyman-ralph! - Update VS Code profile with MCP config transformation
#1009 0451ebc Thanks @Crunchyman-ralph! - Fix MCP server error when retrieving tools and resources
#1009 0a70ab6 Thanks @Crunchyman-ralph! - Add MCP configuration support to Claude Code rules
#1009 4629128 Thanks @Crunchyman-ralph! - Fixed the comprehensive taskmaster system integration via custom slash commands with proper syntax
- Provide claude clode with a complete set of of commands that can trigger task master events directly within Claude Code
#1009 0886c83 Thanks @Crunchyman-ralph! - Correct MCP server name and use 'Add to Cursor' button with updated placeholder keys.
#1009 88c434a Thanks @Crunchyman-ralph! - Add missing API keys to .env.example and README.md

0.21.0-rc.0

Minor Changes

#1001 75a36ea Thanks @Crunchyman-ralph! - Add Kiro editor rule profile support
- Add support for Kiro IDE with custom rule files and MCP configuration
- Generate rule files in .kiro/steering/ directory with markdown format
- Include MCP server configuration with enhanced file inclusion patterns
#1011 3eb050a Thanks @Crunchyman-ralph! - Created a comprehensive documentation site for Task Master AI. Visit https://docs.task-master.dev to explore guides, API references, and examples.
#978 fedfd6a Thanks @ben-vargas! - Complete Groq provider integration and add MoonshotAI Kimi K2 model support
- Fixed Groq provider registration
- Added Groq API key validation
- Added GROQ_API_KEY to .env.example
- Added moonshotai/kimi-k2-instruct model with $1/$3 per 1M token pricing and 16k max output
#974 5b0eda0 Thanks @joedanz! - feat: Add Zed editor rule profile with agent rules and MCP config
- Resolves #637
#973 6d05e86 Thanks @joedanz! - Add Amp rule profile with AGENT.md and MCP config
#1011 3eb050a Thanks @Crunchyman-ralph! - Improve project root detection
- No longer creates an infinite loop when unable to detect your code workspace
#970 b87499b Thanks @joedanz! - Add OpenCode profile with AGENTS.md and MCP config
- Resolves #965

Patch Changes

#1011 3eb050a Thanks @Crunchyman-ralph! - Make task-master update more reliable with AI responses

The update command now handles AI responses more robustly. If the AI forgets to include certain task fields, the command will automatically fill in the missing data from your original tasks instead of failing. This means smoother bulk task updates without losing important information like IDs, dependencies, or completed subtasks.
#1011 3eb050a Thanks @Crunchyman-ralph! - Fix subtask dependency validation when expanding tasks

When using task-master expand to break down tasks into subtasks, dependencies between subtasks are now properly validated. Previously, subtasks with dependencies would fail validation. Now subtasks can correctly depend on their siblings within the same parent task.
#949 f662654 Thanks @ben-vargas! - Prevent CLAUDE.md overwrite by using Claude Code's import feature
- Task Master now creates its instructions in .taskmaster/CLAUDE.md instead of overwriting the user's CLAUDE.md
- Adds an import section to the user's CLAUDE.md that references the Task Master instructions
- Preserves existing user content in CLAUDE.md files
- Provides clean uninstall that only removes Task Master's additions
Breaking Change: Task Master instructions for Claude Code are now stored in .taskmaster/CLAUDE.md and imported into the main CLAUDE.md file. Users who previously had Task Master content directly in their CLAUDE.md will need to run task-master rules remove claude followed by task-master rules add claude to migrate to the new structure.
#943 f98df5c Thanks @mm-parthy! - Implement Boundary-First Tag Resolution to ensure consistent and deterministic tag handling across CLI and MCP, resolving potential race conditions.
#1011 3eb050a Thanks @Crunchyman-ralph! - Fix task-master lang --setup breaking when no language is defined, now defaults to English
#979 ab2e946 Thanks @ben-vargas! - Fix: show command no longer requires complexity report file to exist

The tm show command was incorrectly requiring the complexity report file to exist even when not needed. Now it only validates the complexity report path when a custom report file is explicitly provided via the -r/--report option.
#971 5544222 Thanks @joedanz! - Update VS Code profile with MCP config transformation
#1002 6d0654c Thanks @Crunchyman-ralph! - Fix MCP server error when retrieving tools and resources
#980 cc4fe20 Thanks @joedanz! - Add MCP configuration support to Claude Code rules
#968 7b4803a Thanks @Crunchyman-ralph! - Fixed the comprehensive taskmaster system integration via custom slash commands with proper syntax
- Provide claude clode with a complete set of of commands that can trigger task master events directly within Claude Code
#995 b78de8d Thanks @joedanz! - Correct MCP server name and use 'Add to Cursor' button with updated placeholder keys.
#972 1c7badf Thanks @joedanz! - Add missing API keys to .env.example and README.md

0.20.0

Minor Changes

#950 699e9ee Thanks @ben-vargas! - Add support for xAI Grok 4 model
- Add grok-4 model to xAI provider with $3/$15 per 1M token pricing
- Enable main, fallback, and research roles for grok-4
- Max tokens set to 131,072 (matching other xAI models)
#946 5f009a5 Thanks @Crunchyman-ralph! - Add stricter validation and clearer feedback for task priority when adding new tasks
- if a task priority is invalid, it will default to medium
- made taks priority case-insensitive, essentially making HIGH and high the same value
#863 b530657 Thanks @OrenMe! - Add support for MCP Sampling as AI provider, requires no API key, uses the client LLM provider
#930 98d1c97 Thanks @OmarElKadri! - Added Groq provider support

Patch Changes

#958 6c88a4a Thanks @Crunchyman-ralph! - Recover from @anthropic-ai/claude-code JSON truncation bug that caused Task Master to crash when handling large (>8 kB) structured responses. The CLI/SDK still truncates, but Task Master now detects the error, preserves buffered text, and returns a usable response instead of throwing.
#958 3334e40 Thanks @Crunchyman-ralph! - Updating dependency ai-sdk-provider-gemini-cli to 0.0.4 to address breaking change Google made to Gemini CLI and add better 'api-key' in addition to 'gemini-api-key' AI-SDK compatibility.
#853 95c299d Thanks @joedanz! - Unify and streamline profile system architecture for improved maintainability

0.20.0-rc.0

Minor Changes

#950 699e9ee Thanks @ben-vargas! - Add support for xAI Grok 4 model
- Add grok-4 model to xAI provider with $3/$15 per 1M token pricing
- Enable main, fallback, and research roles for grok-4
- Max tokens set to 131,072 (matching other xAI models)
#946 5f009a5 Thanks @Crunchyman-ralph! - Add stricter validation and clearer feedback for task priority when adding new tasks
- if a task priority is invalid, it will default to medium
- made taks priority case-insensitive, essentially making HIGH and high the same value
#863 b530657 Thanks @OrenMe! - Add support for MCP Sampling as AI provider, requires no API key, uses the client LLM provider
#930 98d1c97 Thanks @OmarElKadri! - Added Groq provider support

Patch Changes

#916 6c88a4a Thanks @Crunchyman-ralph! - Recover from @anthropic-ai/claude-code JSON truncation bug that caused Task Master to crash when handling large (>8 kB) structured responses. The CLI/SDK still truncates, but Task Master now detects the error, preserves buffered text, and returns a usable response instead of throwing.
#916 3334e40 Thanks @Crunchyman-ralph! - Updating dependency ai-sdk-provider-gemini-cli to 0.0.4 to address breaking change Google made to Gemini CLI and add better 'api-key' in addition to 'gemini-api-key' AI-SDK compatibility.
#853 95c299d Thanks @joedanz! - Unify and streamline profile system architecture for improved maintainability

0.19.0

Minor Changes

#897 dd96f51 Thanks @ben-vargas! - Adds support for gemini-cli as a provider, enabling free or subscription use through Google Accounts and paid Gemini Cloud Assist (GCA) subscriptions.
#884 5eafc5e Thanks @geoh! - Added option for the AI to determine the number of tasks required based entirely on complexity
#872 f7fbdd6 Thanks @geoh! - Add advanced settings for Claude Code AI Provider
#870 6fd5e23 Thanks @nishedcob! - Include additional Anthropic models running on Bedrock in what is supported
#510 c99df64 Thanks @shenysun! - Add support for custom response language

Patch Changes

#892 56a415e Thanks @joedanz! - Ensure projectRoot is a string (potential WSL fix)
#856 43e0025 Thanks @mm-parthy! - Fix bulk update tag corruption in tagged task lists
#857 598e687 Thanks @mm-parthy! - Fix expand-task to use tag-specific complexity reports

The expand-task function now correctly uses complexity reports specific to the current tag context (e.g., task-complexity-report_feature-branch.json) instead of always using the default task-complexity-report.json file. This enables proper task expansion behavior when working with multiple tag contexts.
#855 e4456b1 Thanks @joedanz! - Fix .gitignore missing trailing newline during project initialization
#846 59a4ec9 Thanks @joedanz! - Default to Cursor profile for MCP init when no rules specified
#852 f38abd6 Thanks @hrmshandy! - fixes a critical issue where subtask generation fails on gemini-2.5-pro unless explicitly prompted to return 'details' field as a string not an object
#908 24e9206 Thanks @joedanz! - Fix rules command to use reliable project root detection like other commands

0.18.0

Minor Changes

#840 b40139c Thanks @Crunchyman-ralph! - Can now configure baseURL of provider with <PROVIDER>_BASE_URL
- For example:
  - OPENAI_BASE_URL
#840 b40139c Thanks @Crunchyman-ralph! - Added comprehensive rule profile management:

New Profile Support: Added comprehensive IDE profile support with eight specialized profiles: Claude Code, Cline, Codex, Cursor, Roo, Trae, VS Code, and Windsurf. Each profile is optimized for its respective IDE with appropriate mappings and configuration. Initialization: You can now specify which rule profiles to include at project initialization using --rules <profiles> or -r <profiles> (e.g., task-master init -r cursor,roo). Only the selected profiles and configuration are included. Add/Remove Commands: task-master rules add <profiles> and task-master rules remove <profiles> let you manage specific rule profiles and MCP config after initialization, supporting multiple profiles at once. Interactive Setup: task-master rules setup launches an interactive prompt to select which rule profiles to add to your project. This does not re-initialize your project or affect shell aliases; it only manages rules. Selective Removal: Rules removal intelligently preserves existing non-Task Master rules and files and only removes Task Master-specific rules. Profile directories are only removed when completely empty and all conditions are met (no existing rules, no other files/folders, MCP config completely removed). Safety Features: Confirmation messages clearly explain that only Task Master-specific rules and MCP configurations will be removed, while preserving existing custom rules and other files. Robust Validation: Includes comprehensive checks for array types in MCP config processing and error handling throughout the rules management system.

This enables more flexible, rule-specific project setups with intelligent cleanup that preserves user customizations while safely managing Task Master components.
- Resolves #338
#840 b40139c Thanks @Crunchyman-ralph! - Make task-master more compatible with the "o" family models of OpenAI

Now works well with:
- o3
- o3-mini
- etc.
#840 b40139c Thanks @Crunchyman-ralph! - Add better support for python projects by adding pyproject.toml as a projectRoot marker
#840 b40139c Thanks @Crunchyman-ralph! - - Git Worktree Detection:
- Now properly skips Git initialization when inside existing Git worktree
- Prevents accidental nested repository creation
- Flag System Overhaul:
  - --git/--no-git controls repository initialization
  - --aliases/--no-aliases consistently manages shell alias creation
  - --git-tasks/--no-git-tasks controls whether task files are stored in Git
  - --dry-run accurately previews all initialization behaviors
- GitTasks Functionality:
  - New --git-tasks flag includes task files in Git (comments them out in .gitignore)
  - New --no-git-tasks flag excludes task files from Git (default behavior)
  - Supports both CLI and MCP interfaces with proper parameter passing
Implementation Details:
- Added explicit Git worktree detection before initialization
- Refactored flag processing to ensure consistent behavior
- Fixes #734
#840 b40139c Thanks @Crunchyman-ralph! - Add Claude Code provider support

Introduces a new provider that enables using Claude models (Opus and Sonnet) through the Claude Code CLI without requiring an API key.

Key features:
- New claude-code provider with support for opus and sonnet models
- No API key required - uses local Claude Code CLI installation
- Optional dependency - won't affect users who don't need Claude Code
- Lazy loading ensures the provider only loads when requested
- Full integration with existing Task Master commands and workflows
- Comprehensive test coverage for reliability
- New --claude-code flag for the models command
Users can now configure Claude Code models with: task-master models --set-main sonnet --claude-code task-master models --set-research opus --claude-code

The @anthropic-ai/claude-code package is optional and won't be installed unless explicitly needed.

Patch Changes

#840 b40139c Thanks @Crunchyman-ralph! - Fix expand command preserving tagged task structure and preventing data corruption
- Enhance E2E tests with comprehensive tag-aware expand testing to verify tag corruption fix
- Add new test section for feature-expand tag creation and testing during expand operations
- Verify tag preservation during expand, force expand, and expand --all operations
- Test that master tag remains intact while feature-expand tag receives subtasks correctly
- Fix file path references to use correct .taskmaster/config.json and .taskmaster/tasks/tasks.json locations
- All tag corruption verification tests pass successfully, confirming the expand command tag corruption bug fix works as expected
#840 b40139c Thanks @Crunchyman-ralph! - Fix Cursor deeplink installation by providing copy-paste instructions for GitHub compatibility
#840 b40139c Thanks @Crunchyman-ralph! - Call rules interactive setup during init
#840 b40139c Thanks @Crunchyman-ralph! - Update o3 model price
#840 b40139c Thanks @Crunchyman-ralph! - Improves Amazon Bedrock support
#840 b40139c Thanks @Crunchyman-ralph! - Fix issues with task creation/update where subtasks are being created like id: <parent_task>. instead if just id:
#840 b40139c Thanks @Crunchyman-ralph! - Fixes issue with expand CLI command "Complexity report not found"
- Closes #735
- Closes #728
#840 b40139c Thanks @Crunchyman-ralph! - Store tasks in Git by default
#840 b40139c Thanks @Crunchyman-ralph! - Improve provider validation system with clean constants structure
- Fixed "Invalid provider hint" errors: Resolved validation failures for Azure, Vertex, and Bedrock providers
- Improved search UX: Integrated search for better model discovery with real-time filtering
- Better organization: Moved custom provider options to bottom of model selection with clear section separators
This change ensures all custom providers (Azure, Vertex, Bedrock, OpenRouter, Ollama) work correctly in task-master models --setup
#840 b40139c Thanks @Crunchyman-ralph! - Fix weird task-master init bug when using in certain environments
#840 b40139c Thanks @Crunchyman-ralph! - Rename Roo Code Boomerang role to Orchestrator
#840 b40139c Thanks @Crunchyman-ralph! - Improve mcp keys check in cursor

0.18.0-rc.0

Minor Changes

#830 e9d1bc2 Thanks @Crunchyman-ralph! - Can now configure baseURL of provider with <PROVIDER>_BASE_URL
- For example:
  - OPENAI_BASE_URL
#460 a09a2d0 Thanks @joedanz! - Added comprehensive rule profile management:

New Profile Support: Added comprehensive IDE profile support with eight specialized profiles: Claude Code, Cline, Codex, Cursor, Roo, Trae, VS Code, and Windsurf. Each profile is optimized for its respective IDE with appropriate mappings and configuration. Initialization: You can now specify which rule profiles to include at project initialization using --rules <profiles> or -r <profiles> (e.g., task-master init -r cursor,roo). Only the selected profiles and configuration are included. Add/Remove Commands: task-master rules add <profiles> and task-master rules remove <profiles> let you manage specific rule profiles and MCP config after initialization, supporting multiple profiles at once. Interactive Setup: task-master rules setup launches an interactive prompt to select which rule profiles to add to your project. This does not re-initialize your project or affect shell aliases; it only manages rules. Selective Removal: Rules removal intelligently preserves existing non-Task Master rules and files and only removes Task Master-specific rules. Profile directories are only removed when completely empty and all conditions are met (no existing rules, no other files/folders, MCP config completely removed). Safety Features: Confirmation messages clearly explain that only Task Master-specific rules and MCP configurations will be removed, while preserving existing custom rules and other files. Robust Validation: Includes comprehensive checks for array types in MCP config processing and error handling throughout the rules management system.

This enables more flexible, rule-specific project setups with intelligent cleanup that preserves user customizations while safely managing Task Master components.
- Resolves #338
#804 1b8c320 Thanks @ejones40! - Add better support for python projects by adding pyproject.toml as a projectRoot marker
#743 a2a3229 Thanks @joedanz! - - Git Worktree Detection:
- Now properly skips Git initialization when inside existing Git worktree
- Prevents accidental nested repository creation
- Flag System Overhaul:
  - --git/--no-git controls repository initialization
  - --aliases/--no-aliases consistently manages shell alias creation
  - --git-tasks/--no-git-tasks controls whether task files are stored in Git
  - --dry-run accurately previews all initialization behaviors
- GitTasks Functionality:
  - New --git-tasks flag includes task files in Git (comments them out in .gitignore)
  - New --no-git-tasks flag excludes task files from Git (default behavior)
  - Supports both CLI and MCP interfaces with proper parameter passing
Implementation Details:
- Added explicit Git worktree detection before initialization
- Refactored flag processing to ensure consistent behavior
- Fixes #734
#829 4b0c9d9 Thanks @Crunchyman-ralph! - Add Claude Code provider support

Introduces a new provider that enables using Claude models (Opus and Sonnet) through the Claude Code CLI without requiring an API key.

Key features:
- New claude-code provider with support for opus and sonnet models
- No API key required - uses local Claude Code CLI installation
- Optional dependency - won't affect users who don't need Claude Code
- Lazy loading ensures the provider only loads when requested
- Full integration with existing Task Master commands and workflows
- Comprehensive test coverage for reliability
- New --claude-code flag for the models command
Users can now configure Claude Code models with: task-master models --set-main sonnet --claude-code task-master models --set-research opus --claude-code

The @anthropic-ai/claude-code package is optional and won't be installed unless explicitly needed.

Patch Changes

#827 5da5b59 Thanks @Crunchyman-ralph! - Fix expand command preserving tagged task structure and preventing data corruption
- Enhance E2E tests with comprehensive tag-aware expand testing to verify tag corruption fix
- Add new test section for feature-expand tag creation and testing during expand operations
- Verify tag preservation during expand, force expand, and expand --all operations
- Test that master tag remains intact while feature-expand tag receives subtasks correctly
- Fix file path references to use correct .taskmaster/config.json and .taskmaster/tasks/tasks.json locations
- All tag corruption verification tests pass successfully, confirming the expand command tag corruption bug fix works as expected
#833 cf2c066 Thanks @joedanz! - Call rules interactive setup during init
#826 7811227 Thanks @Crunchyman-ralph! - Improves Amazon Bedrock support
#834 6483537 Thanks @Crunchyman-ralph! - Fix issues with task creation/update where subtasks are being created like id: <parent_task>. instead if just id:
#835 727f1ec Thanks @joedanz! - Store tasks in Git by default
#822 1bd6d4f Thanks @Crunchyman-ralph! - Improve provider validation system with clean constants structure
- Fixed "Invalid provider hint" errors: Resolved validation failures for Azure, Vertex, and Bedrock providers
- Improved search UX: Integrated search for better model discovery with real-time filtering
- Better organization: Moved custom provider options to bottom of model selection with clear section separators
This change ensures all custom providers (Azure, Vertex, Bedrock, OpenRouter, Ollama) work correctly in task-master models --setup
#633 3a2325a Thanks @nmarley! - Fix weird task-master init bug when using in certain environments
#831 b592dff Thanks @joedanz! - Rename Roo Code Boomerang role to Orchestrator
#830 e9d1bc2 Thanks @Crunchyman-ralph! - Improve mcp keys check in cursor

0.17.1

Patch Changes

#789 8cde6c2 Thanks @Crunchyman-ralph! - Fix contextGatherer bug when adding a task Cannot read properties of undefined (reading 'forEach')

0.18.0-rc.0

Minor Changes

#830 e9d1bc2 Thanks @Crunchyman-ralph! - Can now configure baseURL of provider with <PROVIDER>_BASE_URL
- For example:
  - OPENAI_BASE_URL
#460 a09a2d0 Thanks @joedanz! - Added comprehensive rule profile management:

New Profile Support: Added comprehensive IDE profile support with eight specialized profiles: Claude Code, Cline, Codex, Cursor, Roo, Trae, VS Code, and Windsurf. Each profile is optimized for its respective IDE with appropriate mappings and configuration. Initialization: You can now specify which rule profiles to include at project initialization using --rules <profiles> or -r <profiles> (e.g., task-master init -r cursor,roo). Only the selected profiles and configuration are included. Add/Remove Commands: task-master rules add <profiles> and task-master rules remove <profiles> let you manage specific rule profiles and MCP config after initialization, supporting multiple profiles at once. Interactive Setup: task-master rules setup launches an interactive prompt to select which rule profiles to add to your project. This does not re-initialize your project or affect shell aliases; it only manages rules. Selective Removal: Rules removal intelligently preserves existing non-Task Master rules and files and only removes Task Master-specific rules. Profile directories are only removed when completely empty and all conditions are met (no existing rules, no other files/folders, MCP config completely removed). Safety Features: Confirmation messages clearly explain that only Task Master-specific rules and MCP configurations will be removed, while preserving existing custom rules and other files. Robust Validation: Includes comprehensive checks for array types in MCP config processing and error handling throughout the rules management system.

This enables more flexible, rule-specific project setups with intelligent cleanup that preserves user customizations while safely managing Task Master components.
- Resolves #338
#804 1b8c320 Thanks @ejones40! - Add better support for python projects by adding pyproject.toml as a projectRoot marker
#743 a2a3229 Thanks @joedanz! - - Git Worktree Detection:
- Now properly skips Git initialization when inside existing Git worktree
- Prevents accidental nested repository creation
- Flag System Overhaul:
  - --git/--no-git controls repository initialization
  - --aliases/--no-aliases consistently manages shell alias creation
  - --git-tasks/--no-git-tasks controls whether task files are stored in Git
  - --dry-run accurately previews all initialization behaviors
- GitTasks Functionality:
  - New --git-tasks flag includes task files in Git (comments them out in .gitignore)
  - New --no-git-tasks flag excludes task files from Git (default behavior)
  - Supports both CLI and MCP interfaces with proper parameter passing
Implementation Details:
- Added explicit Git worktree detection before initialization
- Refactored flag processing to ensure consistent behavior
- Fixes #734
#829 4b0c9d9 Thanks @Crunchyman-ralph! - Add Claude Code provider support

Introduces a new provider that enables using Claude models (Opus and Sonnet) through the Claude Code CLI without requiring an API key.

Key features:
- New claude-code provider with support for opus and sonnet models
- No API key required - uses local Claude Code CLI installation
- Optional dependency - won't affect users who don't need Claude Code
- Lazy loading ensures the provider only loads when requested
- Full integration with existing Task Master commands and workflows
- Comprehensive test coverage for reliability
- New --claude-code flag for the models command
Users can now configure Claude Code models with: task-master models --set-main sonnet --claude-code task-master models --set-research opus --claude-code

The @anthropic-ai/claude-code package is optional and won't be installed unless explicitly needed.

Patch Changes

#827 5da5b59 Thanks @Crunchyman-ralph! - Fix expand command preserving tagged task structure and preventing data corruption
- Enhance E2E tests with comprehensive tag-aware expand testing to verify tag corruption fix
- Add new test section for feature-expand tag creation and testing during expand operations
- Verify tag preservation during expand, force expand, and expand --all operations
- Test that master tag remains intact while feature-expand tag receives subtasks correctly
- Fix file path references to use correct .taskmaster/config.json and .taskmaster/tasks/tasks.json locations
- All tag corruption verification tests pass successfully, confirming the expand command tag corruption bug fix works as expected
#833 cf2c066 Thanks @joedanz! - Call rules interactive setup during init
#826 7811227 Thanks @Crunchyman-ralph! - Improves Amazon Bedrock support
#834 6483537 Thanks @Crunchyman-ralph! - Fix issues with task creation/update where subtasks are being created like id: <parent_task>. instead if just id:
#835 727f1ec Thanks @joedanz! - Store tasks in Git by default
#822 1bd6d4f Thanks @Crunchyman-ralph! - Improve provider validation system with clean constants structure
- Fixed "Invalid provider hint" errors: Resolved validation failures for Azure, Vertex, and Bedrock providers
- Improved search UX: Integrated search for better model discovery with real-time filtering
- Better organization: Moved custom provider options to bottom of model selection with clear section separators
This change ensures all custom providers (Azure, Vertex, Bedrock, OpenRouter, Ollama) work correctly in task-master models --setup
#633 3a2325a Thanks @nmarley! - Fix weird task-master init bug when using in certain environments
#831 b592dff Thanks @joedanz! - Rename Roo Code Boomerang role to Orchestrator
#830 e9d1bc2 Thanks @Crunchyman-ralph! - Improve mcp keys check in cursor

0.17.1

Patch Changes

#789 8cde6c2 Thanks @Crunchyman-ralph! - Fix contextGatherer bug when adding a task Cannot read properties of undefined (reading 'forEach')

0.17.0

Minor Changes

#779 c0b3f43 Thanks @eyaltoledano! - Add comprehensive AI-powered research command with intelligent context gathering and interactive follow-ups.

The new research command provides AI-powered research capabilities that automatically gather relevant project context to answer your questions. The command intelligently selects context from multiple sources and supports interactive follow-up questions in CLI mode.

Key Features:
- Intelligent Task Discovery: Automatically finds relevant tasks and subtasks using fuzzy search based on your query keywords, supplementing any explicitly provided task IDs
- Multi-Source Context: Gathers context from tasks, files, project structure, and custom text to provide comprehensive answers
- Interactive Follow-ups: CLI users can ask follow-up questions that build on the conversation history while allowing fresh context discovery for each question
- Flexible Detail Levels: Choose from low (concise), medium (balanced), or high (comprehensive) response detail levels
- Token Transparency: Displays detailed token breakdown showing context size, sources, and estimated costs
- Enhanced Display: Syntax-highlighted code blocks and structured output with clear visual separation
Usage Examples:
```
# Basic research with auto-discovered context
task-master research "How should I implement user authentication?"

# Research with specific task context
task-master research "What's the best approach for this?" --id=15,23.2

# Research with file context and project tree
task-master research "How does the current auth system work?" --files=src/auth.js,config/auth.json --tree

# Research with custom context and low detail
task-master research "Quick implementation steps?" --context="Using JWT tokens" --detail=low
```
Context Sources:
- Tasks: Automatically discovers relevant tasks/subtasks via fuzzy search, plus any explicitly specified via --id
- Files: Include specific files via --files for code-aware responses
- Project Tree: Add --tree to include project structure overview
- Custom Context: Provide additional context via --context for domain-specific information
Interactive Features (CLI only):
- Follow-up questions that maintain conversation history
- Fresh fuzzy search for each follow-up to discover newly relevant tasks
- Cumulative context building across the conversation
- Clean visual separation between exchanges
- Save to Tasks: Save entire research conversations (including follow-ups) directly to task or subtask details with timestamps
- Clean Menu Interface: Streamlined inquirer-based menu for follow-up actions without redundant UI elements
Save Functionality:

The research command now supports saving complete conversation threads to tasks or subtasks:
- Save research results and follow-up conversations to any task (e.g., "15") or subtask (e.g., "15.2")
- Automatic timestamping and formatting of conversation history
- Validation of task/subtask existence before saving
- Appends to existing task details without overwriting content
- Supports both CLI interactive mode and MCP programmatic access via --save-to flag
Enhanced CLI Options:
```
# Auto-save research results to a task
task-master research "Implementation approach?" --save-to=15

# Combine auto-save with context gathering
task-master research "How to optimize this?" --id=23 --save-to=23.1
```
MCP Integration:
- saveTo parameter for automatic saving to specified task/subtask ID
- Structured response format with telemetry data
- Silent operation mode for programmatic usage
- Full feature parity with CLI except interactive follow-ups
The research command integrates with the existing AI service layer and supports all configured AI providers. Both CLI and MCP interfaces provide comprehensive research capabilities with intelligent context gathering and flexible output options.
#779 c0b3f43 Thanks @eyaltoledano! - Enhance update-task with --append flag for timestamped task updates

Adds the --append flag to update-task command, enabling it to behave like update-subtask with timestamped information appending. This provides more flexible task updating options:

CLI Enhancement:
- task-master update-task --id=5 --prompt="New info" - Full task update (existing behavior)
- task-master update-task --id=5 --append --prompt="Progress update" - Append timestamped info to task details
Full MCP Integration:
- MCP tool update_task now supports append parameter
- Seamless integration with Cursor and other MCP clients
- Consistent behavior between CLI and MCP interfaces
Instead of requiring separate subtask creation for progress tracking, you can now append timestamped information directly to parent tasks while preserving the option for comprehensive task updates.
#779 c0b3f43 Thanks @eyaltoledano! - Add --tag flag support to core commands for multi-context task management. Commands like parse-prd, analyze-complexity, and others now support targeting specific task lists, enabling rapid prototyping and parallel development workflows.

Key features:
- parse-prd --tag=feature-name: Parse PRDs into separate task contexts on the fly
- analyze-complexity --tag=branch: Generate tag-specific complexity reports
- All task operations can target specific contexts while preserving other lists
- Non-existent tags are created automatically for seamless workflow
#779 c0b3f43 Thanks @eyaltoledano! - Introduces Tagged Lists: AI Multi-Context Task Management System

This major feature release introduces Tagged Lists, a comprehensive system that transforms Taskmaster into a multi-context task management powerhouse. You can now organize tasks into completely isolated contexts, enabling parallel (agentic) development workflows, team collaboration, and project experimentation without conflicts.

🏷️ Tagged Task Lists Architecture:

The new tagged system fundamentally improves how tasks are organized:
- Legacy Format: { "tasks": [...] }
- New Tagged Format: { "master": { "tasks": [...], "metadata": {...} }, "feature-xyz": { "tasks": [...], "metadata": {...} } }
- Automatic Migration: Existing projects will seamlessly migrate to tagged format with zero user intervention
- State Management: New .taskmaster/state.json tracks current tag, last switched time, migration status and more.
- Configuration Integration: Enhanced .taskmaster/config.json with tag-specific settings and defaults.
By default, your existing task list will be migrated to the master tag.

🚀 Complete Tag Management Suite:

Core Tag Commands:
- task-master tags [--show-metadata] - List all tags with task counts, completion stats, and metadata
- task-master add-tag <name> [options] - Create new tag contexts with optional task copying
- task-master delete-tag <name> [--yes] - Delete tags (and attached tasks) with double confirmation protection
- task-master use-tag <name> - Switch contexts and immediately see next available task
- task-master rename-tag <old> <new> - Rename tags with automatic current tag reference updates
- task-master copy-tag <source> <target> [options] - Duplicate tag contexts for experimentation
🤖 Full MCP Integration for Tag Management:

Task Master's multi-context capabilities are now fully exposed through the MCP server, enabling powerful agentic workflows:
- list_tags: List all available tag contexts.
- add_tag: Programmatically create new tags.
- delete_tag: Remove tag contexts.
- use_tag: Switch the agent's active task context.
- rename_tag: Rename existing tags.
- copy_tag: Duplicate entire task contexts for experimentation.
Tag Creation Options:
- --copy-from-current - Copy tasks from currently active tag
- --copy-from=<tag> - Copy tasks from specific tag
- --from-branch - Creates a new tag using the active git branch name (for add-tag only)
- --description="<text>" - Add custom tag descriptions
- Empty tag creation for fresh contexts
🎯 Universal --tag Flag Support:

Every task operation now supports tag-specific execution:
- task-master list --tag=feature-branch - View tasks in specific context
- task-master add-task --tag=experiment --prompt="..." - Create tasks in specific tag
- task-master parse-prd document.txt --tag=v2-redesign - Parse PRDs into dedicated contexts
- task-master analyze-complexity --tag=performance-work - Generate tag-specific reports
- task-master set-status --tag=hotfix --id=5 --status=done - Update tasks in specific contexts
- task-master expand --tag=research --id=3 - Break down tasks within tag contexts
This way you or your agent can store out of context tasks into the appropriate tags for later, allowing you to maintain a groomed and scoped master list. Focus on value, not chores.

📊 Enhanced Workflow Features:

Smart Context Switching:
- use-tag command shows immediate next task after switching
- Automatic tag creation when targeting non-existent tags
- Current tag persistence across terminal sessions
- Branch-tag mapping for future Git integration
Intelligent File Management:
- Tag-specific complexity reports: task-complexity-report_tagname.json
- Master tag uses default filenames: task-complexity-report.json
- Automatic file isolation prevents cross-tag contamination
Advanced Confirmation Logic:
- Commands only prompt when target tag has existing tasks
- Empty tags allow immediate operations without confirmation
- Smart append vs overwrite detection
🔄 Seamless Migration & Compatibility:

Zero-Disruption Migration:
- Existing tasks.json files automatically migrate on first command
- Master tag receives proper metadata (creation date, description)
- Migration notice shown once with helpful explanation
- All existing commands work identically to before
State Management:
- .taskmaster/state.json tracks current tag and migration status
- Automatic state creation and maintenance
- Branch-tag mapping foundation for Git integration
- Migration notice tracking to avoid repeated notifications
- Grounds for future context additions
Backward Compatibility:
- All existing workflows continue unchanged
- Legacy commands work exactly as before
- Gradual adoption - users can ignore tags entirely if desired
- No breaking changes to existing tasks or file formats
💡 Real-World Use Cases:

Team Collaboration:
- task-master add-tag alice --copy-from-current - Create teammate-specific contexts
- task-master add-tag bob --copy-from=master - Onboard new team members
- task-master use-tag alice - Switch to teammate's work context
Feature Development:
- task-master parse-prd feature-spec.txt --tag=user-auth - Dedicated feature planning
- task-master add-tag experiment --copy-from=user-auth - Safe experimentation
- task-master analyze-complexity --tag=user-auth - Feature-specific analysis
Release Management:
- task-master add-tag v2.0 --description="Next major release" - Version-specific planning
- task-master copy-tag master v2.1 - Release branch preparation
- task-master use-tag hotfix - Emergency fix context
Project Phases:
- task-master add-tag research --description="Discovery phase" - Research tasks
- task-master add-tag implementation --copy-from=research - Development phase
- task-master add-tag testing --copy-from=implementation - QA phase
🛠️ Technical Implementation:

Data Structure:
- Tagged format with complete isolation between contexts
- Rich metadata per tag (creation date, description, update tracking)
- Automatic metadata enhancement for existing tags
- Clean separation of tag data and internal state
Performance Optimizations:
- Dynamic task counting without stored counters
- Efficient tag resolution and caching
- Minimal file I/O with smart data loading
- Responsive table layouts adapting to terminal width
Error Handling:
- Comprehensive validation for tag names (alphanumeric, hyphens, underscores)
- Reserved name protection (master, main, default)
- Graceful handling of missing tags and corrupted data
- Detailed error messages with suggested corrections
This release establishes the foundation for advanced multi-context workflows while maintaining the simplicity and power that makes Task Master effective for individual developers.
#779 c0b3f43 Thanks @eyaltoledano! - Research Save-to-File Feature & Critical MCP Tag Corruption Fix

🔬 New Research Save-to-File Functionality:

Added comprehensive save-to-file capability to the research command, enabling users to preserve research sessions for future reference and documentation.

CLI Integration:
- New --save-file flag for task-master research command
- Consistent with existing --save and --save-to flags for intuitive usage
- Interactive "Save to file" option in follow-up questions menu
MCP Integration:
- New saveToFile boolean parameter for the research MCP tool
- Enables programmatic research saving for AI agents and integrated tools
File Management:
- Automatically creates .taskmaster/docs/research/ directory structure
- Generates timestamped, slugified filenames (e.g., 2025-01-13_what-is-typescript.md)
- Comprehensive Markdown format with metadata headers including query, timestamp, and context sources
- Clean conversation history formatting without duplicate information
#779 c0b3f43 Thanks @eyaltoledano! - No longer automatically creates individual task files as they are not used by the applicatoin. You can still generate them anytime using the generate command.
#779 c0b3f43 Thanks @eyaltoledano! - Enhanced get-task/show command to support comma-separated task IDs for efficient batch operations

New Features:
- Multiple Task Retrieval: Pass comma-separated IDs to get/show multiple tasks at once (e.g., task-master show 1,3,5 or MCP get_task with id: "1,3,5")
- Smart Display Logic: Single ID shows detailed view, multiple IDs show compact summary table with interactive options
- Batch Action Menu: Interactive menu for multiple tasks with copy-paste ready commands for common operations (mark as done/in-progress, expand all, view dependencies, etc.)
- MCP Array Response: MCP tool returns structured array of task objects for efficient AI agent context gathering
Benefits:
- Faster Context Gathering: AI agents can collect multiple tasks/subtasks in one call instead of iterating
- Improved Workflow: Interactive batch operations reduce repetitive command execution
- Better UX: Responsive layout adapts to terminal width, maintains consistency with existing UI patterns
- API Efficiency: RESTful array responses in MCP format enable more sophisticated integrations
This enhancement maintains full backward compatibility while significantly improving efficiency for both human users and AI agents working with multiple tasks.
#779 c0b3f43 Thanks @eyaltoledano! - Adds support for filtering tasks by multiple statuses at once using comma-separated statuses.

Example: cancelled,deferred
#779 c0b3f43 Thanks @eyaltoledano! - Adds tag to CLI and MCP outputs/responses so you know which tag you are performing operations on.

Patch Changes

#779 5ec1f61 Thanks @eyaltoledano! - Fix Cursor deeplink installation by providing copy-paste instructions for GitHub compatibility
#779 c0b3f43 Thanks @eyaltoledano! - Fix critical bugs in task move functionality:
- Fixed moving tasks to become subtasks of empty parents: When moving a task to become a subtask of a parent that had no existing subtasks (e.g., task 89 → task 98.1), the operation would fail with validation errors.
- Fixed moving subtasks between parents: Subtasks can now be properly moved between different parent tasks, including to parents that previously had no subtasks.
- Improved comma-separated batch moves: Multiple tasks can now be moved simultaneously using comma-separated IDs (e.g., "88,90" → "92,93") with proper error handling and atomic operations.
These fixes enables proper task hierarchy reorganization for corner cases that were previously broken.
#779 d76bea4 Thanks @eyaltoledano! - Update o3 model price
#779 0849c0c Thanks @eyaltoledano! - Fixes issue with expand CLI command "Complexity report not found"
- Closes #735
- Closes #728

#779 c0b3f43 Thanks @eyaltoledano! - Fix issue with generate command which was creating tasks in the legacy tasks location.

- No longer creates individual task files automatically. You can still use `generate` if you need to create our update your task files.

#779 c0b3f43 Thanks @eyaltoledano! - Improves dependency management when moving tasks by updating subtask dependencies that reference sibling subtasks by their old parent-based ID
Updated dependencies [c0b3f43, 5ec1f61, c0b3f43, c0b3f43, d76bea4, c0b3f43, 0849c0c, c0b3f43, c0b3f43, c0b3f43, c0b3f43, c0b3f43, c0b3f43, c0b3f43, c0b3f43]:
- task-master-ai@0.17.0

0.16.2

Patch Changes

#695 1ece6f1 Thanks @Crunchyman-ralph! - improve findTasks algorithm for resolving tasks path
#695 ee0be04 Thanks @Crunchyman-ralph! - Fix update tool on MCP giving No valid tasks found
#699 27edbd8 Thanks @eyaltoledano! - Enhanced add-task fuzzy search intelligence and improved user experience

Smarter Task Discovery:
- Remove hardcoded category system that always matched "Task management"
- Eliminate arbitrary limits on fuzzy search results (5→25 high relevance, 3→10 medium relevance, 8→20 detailed tasks)
- Improve semantic weighting in Fuse.js search (details=3, description=2, title=1.5) for better relevance
- Generate context-driven task recommendations based on true semantic similarity
Enhanced Terminal Experience:
- Fix duplicate banner display issue that was "eating" terminal history (closes #553)
- Remove console.clear() and redundant displayBanner() calls from UI functions
- Preserve command history for better development workflow
- Streamline banner display across all commands (list, next, show, set-status, clear-subtasks, dependency commands)
Visual Improvements:
- Replace emoji complexity indicators with clean filled circle characters (●) for professional appearance
- Improve consistency and readability of task complexity display
AI Provider Compatibility:
- Change generateObject mode from 'tool' to 'auto' for better cross-provider compatibility
- Add qwen3-235n-a22b:free model support (closes #687)
- Add smart warnings for free OpenRouter models with limitations (rate limits, restricted context, no tool_use)
Technical Improvements:
- Enhanced context generation in add-task to rely on semantic similarity rather than rigid pattern matching
- Improved dependency analysis and common pattern detection
- Better handling of task relationships and relevance scoring
- More intelligent task suggestion algorithms
The add-task system now provides truly relevant task context based on semantic understanding rather than arbitrary categories and limits, while maintaining a cleaner and more professional terminal experience.
#655 edaa5fe Thanks @Crunchyman-ralph! - Fix double .taskmaster directory paths in file resolution utilities
- Closes #636
#671 86ea6d1 Thanks @joedanz! - Add one-click MCP server installation for Cursor
#699 2e55757 Thanks @eyaltoledano! - Add sync-readme command for a task export to GitHub README

Introduces a new sync-readme command that exports your task list to your project's README.md file.

Features:
- Flexible filtering: Supports --status filtering (e.g., pending, done) and --with-subtasks flag
- Smart content management: Automatically replaces existing exports or appends to new READMEs
- Metadata display: Shows export timestamp, subtask inclusion status, and filter settings
Usage:
- task-master sync-readme - Export tasks without subtasks
- task-master sync-readme --with-subtasks - Include subtasks in export
- task-master sync-readme --status=pending - Only export pending tasks
- task-master sync-readme --status=done --with-subtasks - Export completed tasks with subtasks
Perfect for showcasing project progress on GitHub. Experimental. Open to feedback.

0.16.2

Patch Changes

#695 1ece6f1 Thanks @Crunchyman-ralph! - improve findTasks algorithm for resolving tasks path
#695 ee0be04 Thanks @Crunchyman-ralph! - Fix update tool on MCP giving No valid tasks found
#699 27edbd8 Thanks @eyaltoledano! - Enhanced add-task fuzzy search intelligence and improved user experience

Smarter Task Discovery:
- Remove hardcoded category system that always matched "Task management"
- Eliminate arbitrary limits on fuzzy search results (5→25 high relevance, 3→10 medium relevance, 8→20 detailed tasks)
- Improve semantic weighting in Fuse.js search (details=3, description=2, title=1.5) for better relevance
- Generate context-driven task recommendations based on true semantic similarity
Enhanced Terminal Experience:
- Fix duplicate banner display issue that was "eating" terminal history (closes #553)
- Remove console.clear() and redundant displayBanner() calls from UI functions
- Preserve command history for better development workflow
- Streamline banner display across all commands (list, next, show, set-status, clear-subtasks, dependency commands)
Visual Improvements:
- Replace emoji complexity indicators with clean filled circle characters (●) for professional appearance
- Improve consistency and readability of task complexity display
AI Provider Compatibility:
- Change generateObject mode from 'tool' to 'auto' for better cross-provider compatibility
- Add qwen3-235n-a22b:free model support (closes #687)
- Add smart warnings for free OpenRouter models with limitations (rate limits, restricted context, no tool_use)
Technical Improvements:
- Enhanced context generation in add-task to rely on semantic similarity rather than rigid pattern matching
- Improved dependency analysis and common pattern detection
- Better handling of task relationships and relevance scoring
- More intelligent task suggestion algorithms
The add-task system now provides truly relevant task context based on semantic understanding rather than arbitrary categories and limits, while maintaining a cleaner and more professional terminal experience.
#655 edaa5fe Thanks @Crunchyman-ralph! - Fix double .taskmaster directory paths in file resolution utilities
- Closes #636
#671 86ea6d1 Thanks @joedanz! - Add one-click MCP server installation for Cursor
#699 2e55757 Thanks @eyaltoledano! - Add sync-readme command for a task export to GitHub README

Introduces a new sync-readme command that exports your task list to your project's README.md file.

Features:
- Flexible filtering: Supports --status filtering (e.g., pending, done) and --with-subtasks flag
- Smart content management: Automatically replaces existing exports or appends to new READMEs
- Metadata display: Shows export timestamp, subtask inclusion status, and filter settings
Usage:
- task-master sync-readme - Export tasks without subtasks
- task-master sync-readme --with-subtasks - Include subtasks in export
- task-master sync-readme --status=pending - Only export pending tasks
- task-master sync-readme --status=done --with-subtasks - Export completed tasks with subtasks
Perfect for showcasing project progress on GitHub. Experimental. Open to feedback.

0.16.2-rc.0

Patch Changes

#655 edaa5fe Thanks @Crunchyman-ralph! - Fix double .taskmaster directory paths in file resolution utilities
- Closes #636
#671 86ea6d1 Thanks @joedanz! - Add one-click MCP server installation for Cursor

0.16.1

Patch Changes

#641 ad61276 Thanks @Crunchyman-ralph! - Fix bedrock issues
#648 9b4168b Thanks @Crunchyman-ralph! - Fix MCP tool calls logging errors
#641 ad61276 Thanks @Crunchyman-ralph! - Update rules for new directory structure
#648 9b4168b Thanks @Crunchyman-ralph! - Fix bug in expand_all mcp tool
#641 ad61276 Thanks @Crunchyman-ralph! - Fix MCP crashing after certain commands due to console logs

0.16.0

Minor Changes

#607 6a8a68e Thanks @Crunchyman-ralph! - Add AWS bedrock support
#607 6a8a68e Thanks @Crunchyman-ralph! - # Add Google Vertex AI Provider Integration
- Implemented VertexAIProvider class extending BaseAIProvider
- Added authentication and configuration handling for Vertex AI
- Updated configuration manager with Vertex-specific getters
- Modified AI services unified system to integrate the provider
- Added documentation for Vertex AI setup and configuration
- Updated environment variable examples for Vertex AI support
- Implemented specialized error handling for Vertex-specific issues
#607 6a8a68e Thanks @Crunchyman-ralph! - Add support for Azure
#612 669b744 Thanks @Crunchyman-ralph! - Increased minimum required node version to > 18 (was > 14)
#607 6a8a68e Thanks @Crunchyman-ralph! - Renamed baseUrl to baseURL
#604 80735f9 Thanks @Crunchyman-ralph! - Add TASK_MASTER_PROJECT_ROOT env variable supported in mcp.json and .env for project root resolution
- Some users were having issues where the MCP wasn't able to detect the location of their project root, you can now set the TASK_MASTER_PROJECT_ROOT environment variable to the root of your project.
#619 3f64202 Thanks @Crunchyman-ralph! - Consolidate Task Master files into unified .taskmaster directory structure

This release introduces a new consolidated directory structure that organizes all Task Master files under a single .taskmaster/ directory for better project organization and cleaner workspace management.

New Directory Structure:
- .taskmaster/tasks/ - Task files (previously tasks/)
- .taskmaster/docs/ - Documentation including PRD files (previously scripts/)
- .taskmaster/reports/ - Complexity analysis reports (previously scripts/)
- .taskmaster/templates/ - Template files like example PRD
- .taskmaster/config.json - Configuration (previously .taskmasterconfig)
Migration & Backward Compatibility:
- Existing projects continue to work with legacy file locations
- New projects use the consolidated structure automatically
- Run task-master migrate to move existing projects to the new structure
- All CLI commands and MCP tools automatically detect and use appropriate file locations
Benefits:
- Cleaner project root with Task Master files organized in one location
- Reduced file scatter across multiple directories
- Improved project navigation and maintenance
- Consistent file organization across all Task Master projects
This change maintains full backward compatibility while providing a migration path to the improved structure.

Patch Changes

#607 6a8a68e Thanks @Crunchyman-ralph! - Fix max_tokens error when trying to use claude-sonnet-4 and claude-opus-4
#625 2d520de Thanks @Crunchyman-ralph! - Fix add-task MCP command causing an error

0.16.0-rc.0

Minor Changes

#607 6a8a68e Thanks @Crunchyman-ralph! - Add AWS bedrock support
#607 6a8a68e Thanks @Crunchyman-ralph! - # Add Google Vertex AI Provider Integration
- Implemented VertexAIProvider class extending BaseAIProvider
- Added authentication and configuration handling for Vertex AI
- Updated configuration manager with Vertex-specific getters
- Modified AI services unified system to integrate the provider
- Added documentation for Vertex AI setup and configuration
- Updated environment variable examples for Vertex AI support
- Implemented specialized error handling for Vertex-specific issues
#607 6a8a68e Thanks @Crunchyman-ralph! - Add support for Azure
#612 669b744 Thanks @Crunchyman-ralph! - Increased minimum required node version to > 18 (was > 14)
#607 6a8a68e Thanks @Crunchyman-ralph! - Renamed baseUrl to baseURL
#604 80735f9 Thanks @Crunchyman-ralph! - Add TASK_MASTER_PROJECT_ROOT env variable supported in mcp.json and .env for project root resolution
- Some users were having issues where the MCP wasn't able to detect the location of their project root, you can now set the TASK_MASTER_PROJECT_ROOT environment variable to the root of your project.
#619 3f64202 Thanks @Crunchyman-ralph! - Consolidate Task Master files into unified .taskmaster directory structure

This release introduces a new consolidated directory structure that organizes all Task Master files under a single .taskmaster/ directory for better project organization and cleaner workspace management.

New Directory Structure:
- .taskmaster/tasks/ - Task files (previously tasks/)
- .taskmaster/docs/ - Documentation including PRD files (previously scripts/)
- .taskmaster/reports/ - Complexity analysis reports (previously scripts/)
- .taskmaster/templates/ - Template files like example PRD
- .taskmaster/config.json - Configuration (previously .taskmasterconfig)
Migration & Backward Compatibility:
- Existing projects continue to work with legacy file locations
- New projects use the consolidated structure automatically
- Run task-master migrate to move existing projects to the new structure
- All CLI commands and MCP tools automatically detect and use appropriate file locations
Benefits:
- Cleaner project root with Task Master files organized in one location
- Reduced file scatter across multiple directories
- Improved project navigation and maintenance
- Consistent file organization across all Task Master projects
This change maintains full backward compatibility while providing a migration path to the improved structure.

Patch Changes

#607 6a8a68e Thanks @Crunchyman-ralph! - Fix max_tokens error when trying to use claude-sonnet-4 and claude-opus-4
#597 2d520de Thanks @eyaltoledano! - Fix add-task MCP command causing an error

0.15.0

Minor Changes

#567 09add37 Thanks @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/tags endpoint
- Configurable Endpoints: Uses the ollamaBaseUrl from .taskmasterconfig (with role-specific baseUrl overrides 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
#567 4c83526 Thanks @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 70f4054 Thanks @eyaltoledano! - Add --research flag 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 5e9bc28 Thanks @eyaltoledano! - This change significantly enhances the add-task command'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 34c769b Thanks @eyaltoledano! - Enhance analyze-complexity to support analyzing specific task IDs. - You can now analyze individual tasks or selected task groups by using the new --id option with comma-separated IDs, or --from and --to options to specify a range of tasks. - The feature intelligently merges analysis results with existing reports, allowing incremental analysis while preserving previous results.
#558 86d8f00 Thanks @ShreyPaharia! - Add next task to set task status response Status: DONE
#567 04af16d Thanks @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_task with 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 --from and --to parameters. 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

Patch Changes

#567 231e569 Thanks @eyaltoledano! - Adjusts default main model model to Claude Sonnet 4. Adjusts default fallback to Claude Sonney 3.7"
#567 b371808 Thanks @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 a59dd03 Thanks @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 e0e1155 Thanks @eyaltoledano! - Fixes issue with force/append flag combinations for parse-prd.
#567 34df2c8 Thanks @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 d2e6431 Thanks @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 09add37 Thanks @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/tags endpoint
- Configurable Endpoints: Uses the ollamaBaseUrl from .taskmasterconfig (with role-specific baseUrl overrides 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
#567 4c83526 Thanks @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 70f4054 Thanks @eyaltoledano! - Add --research flag 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 5e9bc28 Thanks @eyaltoledano! - This change significantly enhances the add-task command'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 34c769b Thanks @eyaltoledano! - Enhance analyze-complexity to support analyzing specific task IDs. - You can now analyze individual tasks or selected task groups by using the new --id option with comma-separated IDs, or --from and --to options to specify a range of tasks. - The feature intelligently merges analysis results with existing reports, allowing incremental analysis while preserving previous results.
#558 86d8f00 Thanks @ShreyPaharia! - Add next task to set task status response Status: DONE
#567 04af16d Thanks @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_task with 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 --from and --to parameters. 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

Patch Changes

#567 231e569 Thanks @eyaltoledano! - Adjusts default main model model to Claude Sonnet 4. Adjusts default fallback to Claude Sonney 3.7"
#567 b371808 Thanks @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 a59dd03 Thanks @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 e0e1155 Thanks @eyaltoledano! - Fixes issue with force/append flag combinations for parse-prd.
#567 34df2c8 Thanks @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 d2e6431 Thanks @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 ed17cb0 Thanks @Crunchyman-ralph! - .taskmasterconfig now supports a baseUrl field per model role (main, research, fallback), allowing endpoint overrides for any provider.
#536 f4a83ec Thanks @Crunchyman-ralph! - Add Ollama as a supported AI provider.
- You can now add it by running task-master models --setup and selecting it.
- Ollama is a local model provider, so no API key is required.
- Ollama models are available at http://localhost:11434/api by default.
- You can change the default URL by setting the OLLAMA_BASE_URL environment variable or by adding a baseUrl property to the ollama model role in .taskmasterconfig.
  - If you want to use a custom API key, you can set it in the OLLAMA_API_KEY environment variable.
#528 58b417a Thanks @Crunchyman-ralph! - Display task complexity scores in task lists, next task, and task details views.

Patch Changes

#402 01963af Thanks @Crunchyman-ralph! - Resolve all issues related to MCP
#478 4117f71 Thanks @joedanz! - Fix CLI --force flag for parse-prd command

Previously, 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 17294ff Thanks @Crunchyman-ralph! - Task Master no longer tells you to update when you're already up to date
#442 2b3ae8b Thanks @eyaltoledano! - Adds costs information to AI commands using input/output tokens and model costs.
#402 01963af Thanks @Crunchyman-ralph! - Fix ERR_MODULE_NOT_FOUND when trying to run MCP Server
#402 01963af Thanks @Crunchyman-ralph! - Add src directory to exports
#523 da317f2 Thanks @Crunchyman-ralph! - Fix the error handling of task status settings
#527 a8dabf4 Thanks @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 a1f8d52 Thanks @ksylvan! - Fix for issue #409 LOG_LEVEL Pydantic validation error
#442 0288311 Thanks @eyaltoledano! - Small fixes - next command no longer incorrectly suggests that subtasks be broken down into subtasks in the CLI - fixes the append flag so it properly works in the CLI
#501 0a61184 Thanks @Crunchyman-ralph! - Fix initial .env.example to work out of the box
- Closes #419
#435 a96215a Thanks @lebsral! - Fix default fallback model and maxTokens in Taskmaster initialization
#517 e96734a Thanks @Crunchyman-ralph! - Fix bug when updating tasks on the MCP server (#412)
#496 efce374 Thanks @joedanz! - Fix duplicate output on CLI help screen
- Prevent the Task Master CLI from printing the help screen more than once when using -h or --help.
- Removed redundant manual event handlers and guards for help output; now only the Commander .helpInformation override 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

0.14.0-rc.1

Minor Changes

#536 f4a83ec Thanks @Crunchyman-ralph! - Add Ollama as a supported AI provider.
- You can now add it by running task-master models --setup and selecting it.
- Ollama is a local model provider, so no API key is required.
- Ollama models are available at http://localhost:11434/api by default.
- You can change the default URL by setting the OLLAMA_BASE_URL environment variable or by adding a baseUrl property to the ollama model role in .taskmasterconfig.
  - If you want to use a custom API key, you can set it in the OLLAMA_API_KEY environment variable.

Patch Changes

#442 2b3ae8b Thanks @eyaltoledano! - Adds costs information to AI commands using input/output tokens and model costs.
#442 0288311 Thanks @eyaltoledano! - Small fixes - next command no longer incorrectly suggests that subtasks be broken down into subtasks in the CLI - fixes the append flag so it properly works in the CLI

0.14.0-rc.0

Minor Changes

#521 ed17cb0 Thanks @Crunchyman-ralph! - .taskmasterconfig now supports a baseUrl field per model role (main, research, fallback), allowing endpoint overrides for any provider.
#528 58b417a Thanks @Crunchyman-ralph! - Display task complexity scores in task lists, next task, and task details views.

Patch Changes

#478 4117f71 Thanks @joedanz! - Fix CLI --force flag for parse-prd command

Previously, 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 17294ff Thanks @Crunchyman-ralph! - Task Master no longer tells you to update when you're already up to date
#523 da317f2 Thanks @Crunchyman-ralph! - Fix the error handling of task status settings
#527 a8dabf4 Thanks @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 a1f8d52 Thanks @ksylvan! - Fix for issue #409 LOG_LEVEL Pydantic validation error
#501 0a61184 Thanks @Crunchyman-ralph! - Fix initial .env.example to work out of the box
- Closes #419
#435 a96215a Thanks @lebsral! - Fix default fallback model and maxTokens in Taskmaster initialization
#517 e96734a Thanks @Crunchyman-ralph! - Fix bug when updating tasks on the MCP server (#412)
#496 efce374 Thanks @joedanz! - Fix duplicate output on CLI help screen
- Prevent the Task Master CLI from printing the help screen more than once when using -h or --help.
- Removed redundant manual event handlers and guards for help output; now only the Commander .helpInformation override 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

0.13.1

Patch Changes

#399 734a4fd Thanks @Crunchyman-ralph! - Fix ERR_MODULE_NOT_FOUND when trying to run MCP Server

0.13.0

Minor Changes

#240 ef782ff Thanks @eyaltoledano! - feat(expand): Enhance expand and expand-all commands
- Integrate task-complexity-report.json to 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 run task-master update --id=[id of task] --research and it will use that prompt automatically. No extra prompt needed.
- Change default behavior to append new subtasks to existing ones. Use the --force flag 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.
#240 87d97bb Thanks @eyaltoledano! - Adds support for the OpenRouter AI provider. Users can now configure models available through OpenRouter (requiring an OPENROUTER_API_KEY) via the task-master models command, 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 1ab836f Thanks @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 c8722b0 Thanks @eyaltoledano! - Adds custom model ID support for Ollama and OpenRouter providers.
- Adds the --ollama and --openrouter flags to task-master models --set-<role> command to set models for those providers outside of the support models list.
- Updated task-master models --setup interactive 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.
#240 2517bc1 Thanks @eyaltoledano! - Integrate OpenAI as a new AI provider. - Enhance models command/tool to display API key status. - Implement model-specific maxTokens override based on supported-models.json to save you if you use an incorrect max token value.
#240 9a48278 Thanks @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 842eaf7 Thanks @eyaltoledano! - - Add support for Google Gemini models via Vercel AI SDK integration.
#240 ed79d4f Thanks @eyaltoledano! - Add xAI provider and Grok models support
#378 ad89253 Thanks @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 2acba94 Thanks @neno-is-ooo! - Add integration for Roo Code
#378 d63964a Thanks @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 5f504fa Thanks @eyaltoledano! - Improve and adjust init command 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 their package.json for out-of-the-box AI feature compatibility. Remove unnecessary dependencies (e.g., uuid) from the init template.
- Silence npm install during init: Prevent npm install output from interfering with non-interactive/MCP initialization by suppressing its stdio in silent mode.
- Improve Conditional Model Setup: Reliably skip interactive models --setup during non-interactive init runs (e.g., init -y or MCP) by checking isSilentMode() instead of passing flags.
- Refactor init.js: Remove internal isInteractive flag logic.
- Update init Instructions: Tweak the "Getting Started" text displayed after init.
- Fix MCP Server Launch: Update .cursor/mcp.json template to use node ./mcp-server/server.js instead of npx task-master-mcp.
- Update Default Model: Change the default main model in the .taskmasterconfig template.
#240 96aeeff Thanks @eyaltoledano! - Fixes an issue with add-task which did not use the manually defined properties and still needlessly hit the AI endpoint.
#240 5aea93d Thanks @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 66ac9ab Thanks @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 ca7b045 Thanks @eyaltoledano! - Add --status flag to show command to filter displayed subtasks.
#328 5a2371b Thanks @knoxgraeme! - Fix --task to --num-tasks in ui + related tests - issue #324
#240 6cb213e Thanks @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 models shows the current models config. Using the --setup flag launches an interactive set up that allows you to easily select the models you want to use for each of the three roles. Use q during 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 the models tool with different arguments, including listAvailableModels to 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 run task-master to include missing commands and .taskmasterconfig information. - Adds --research flag to add-task so 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 2829194 Thanks @Crunchyman-ralph! - Fix add_dependency tool crashing the MCP Server

0.12.0

Minor Changes

#253 b2ccd60 Thanks @Crunchyman-ralph! - Add npx task-master-ai that runs mcp instead of using `task-master-mcp``
#267 c17d912 Thanks @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 454a1d9 Thanks @Crunchyman-ralph! - - Fixes shebang issue not allowing task-master to run on certain windows operating systems
- Resolves #241 #211 #184 #193
#268 3e872f8 Thanks @Crunchyman-ralph! - Fix remove-task command to handle multiple comma-separated task IDs
#239 6599cb0 Thanks @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 3aee9bc Thanks @Crunchyman-ralph! - Enhance the parsePRD to include --append flag. 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 ff8e75c Thanks @joedanz! - Add quotes around numeric env vars in mcp.json (Windsurf, etc.)
#248 d99fa00 Thanks @Crunchyman-ralph! - - Fix task-master init polluting codebase with new packages inside package.json and modifying project README
- Now only initializes with cursor rules, windsurf rules, mcp.json, scripts/example_prd.txt, .gitignore modifications, and README-task-master.md
#266 41b979c Thanks @Crunchyman-ralph! - Fixed a bug that prevented the task-master from running in a Linux container
#265 0eb16d5 Thanks @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 7141062 Thanks @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_project capability.
- 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-task command 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.mdc reference 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).
- 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-all command that could cause NaN errors or JSON formatting issues (especially when using --research).
  - Fixed issues with parameter validation in the analyze-complexity command (specifically related to the threshold parameter).
  - Made the add-task command more consistent by adding standard flags like --title, --description for manual task creation so you don't have to use --prompt and 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-tasks is now get_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 init and parse-prd steps). This ensures the AI doesn't go on a tangent deciding its own workflow, and follows the exact process outlined in the Taskmaster workflow.
- 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 (.env file) or an integrated tool (.cursor/mcp.json file).
  - 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.
- 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-20250219 and Perplexity sonar-pro by default.
    - More granular breakdown: Increased the default number of subtasks generated by expand to 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.
- Documentation Clarity:
  - Clarified in documentation that Markdown files (.md) can be used for Product Requirements Documents (parse_prd).
  - Improved the description for the numTasks option in parse_prd for better guidance.
- 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 (show command) 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.

0.10.1

Patch Changes

#80 aa185b2 Thanks @Crunchyman-ralph! - Remove non-existent package @model-context-protocol/sdk
#45 757fd47 Thanks @Crunchyman-ralph! - Add license to repo

0.10.0

Minor Changes

#44 eafdb47 Thanks @Crunchyman-ralph! - add github actions to automate github and npm releases
#20 4eed269 Thanks @Crunchyman-ralph! - Implement MCP server for all commands using tools.

Patch Changes

#44 44db895 Thanks @Crunchyman-ralph! - Added changeset config #39
#50 257160a Thanks @Crunchyman-ralph! - Fix addTask tool projectRoot not defined
#57 9fd42ee Thanks @github-actions! - fix mcp server not connecting to cursor
#48 5ec3651 Thanks @Crunchyman-ralph! - Fix workflows

211 KiB Raw Blame History

task-master-ai

0.28.0-rc.1

Patch Changes

0.28.0-rc.0

Minor Changes

Key Changes:

Technical Improvements:

Bug Fixes:

Patch Changes

0.27.3

Patch Changes

0.27.2

Patch Changes

0.27.1

Patch Changes

0.27.1-rc.1

Patch Changes

0.27.1-rc.0

Patch Changes

0.27.0

Minor Changes

Setup Instructions

Key Features

Available Models

Credits

0.27.0-rc.2

Minor Changes

0.27.0-rc.1

Minor Changes

0.27.0-rc.0

Minor Changes

Patch Changes

0.26.0

Minor Changes

Patch Changes

0.26.0-rc.1

Minor Changes

0.26.0-rc.0

Minor Changes

Patch Changes

0.25.1

Patch Changes

0.25.0

Minor Changes

CLI Usage Examples

Patch Changes

0.25.0-rc.0

Minor Changes

CLI Usage Examples

Patch Changes

0.24.0

Minor Changes

New Claude Code Agents

task-orchestrator

task-executor

task-checker

Installation

Usage Example

Benefits

Patch Changes

0.24.0-rc.2

Minor Changes

0.24.0-rc.1

Minor Changes

New Claude Code Agents

task-orchestrator

task-executor

task-checker

Installation

Usage Example

Benefits

Patch Changes

0.23.1-rc.0

Patch Changes

0.23.0

Minor Changes

Patch Changes

0.23.0-rc.2

Minor Changes

211 KiB

Raw Blame History