task-master-ai@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

v.0.23.0

#1064 b82d858 Thanks @Crunchyman-ralph! - 🎉 Introducing TaskMaster Extension!

We're thrilled to launch the first version of our Code extension, bringing the power of TaskMaster directly into your favorite code editor. While this is our initial release and we've kept things focused, it already packs powerful features to supercharge your development workflow.

📋 Visual Task Management

• Kanban Board View: Visualize all your tasks in an intuitive board layout directly in VS Code
• Drag & Drop: Easily change task status by dragging cards between columns
• Real-time Updates: See changes instantly as you work through your project

🏷️ Multi-Context Support

• Tag Switching: Seamlessly switch between different project contexts/tags
• Isolated Workflows: Keep different features or experiments organized separately

🤖 AI-Powered Task Updates

• Smart Updates: Use TaskMaster's AI capabilities to update tasks and subtasks
• Context-Aware: Leverages your existing TaskMaster configuration and models

📊 Rich Task Information

• Complexity Scores: See task complexity ratings at a glance
• Subtask Visualization: Expand tasks to view and manage subtasks
• Dependency Graphs: Understand task relationships and dependencies visually

⚙️ Configuration Management

• Visual Config Editor: View and understand your .taskmaster/config.json settings
• Easy Access: No more manual JSON editing for common configuration tasks

🚀 Quick Actions

• Status Updates: Change task status with a single click
• Task Details: Access full task information without leaving VS Code
• Integrated Commands: All TaskMaster commands available through the command palette

🎯 What's Next?
This is just the beginning! We wanted to get a solid foundation into your hands quickly and this release is mostly experimental but fully usable. The extension will evolve rapidly with your feedback, adding more advanced features, better visualizations, and deeper integration with your development workflow. Please send feedback!

Thank you for being part of the TaskMaster journey. Your workflow has never looked better! 🚀

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.

Extension extension@0.23.0

VS Code Extension Release extension@0.23.0

Marketplaces:

• VS Code Marketplace
• Open VSX Registry

task-master-ai@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.

task-master-ai@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.

task-master-ai@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.

v.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).

v0.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).

v0.21.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

v0.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