docs: auto-update documentation based on changes in next branch

This PR was automatically generated to update documentation based on recent changes.

  Original commit: feat: update tm models defaults (#1225)\n\n\n

  Co-authored-by: Claude <claude-assistant@anthropic.com>

.changeset/easy-deer-heal.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": minor
----
-
-Testing one more pre-release iteration

.changeset/moody-oranges-slide.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": minor
----
-
-Test out the RC

.changeset/odd-otters-tan.md

@@ -1,5 +0,0 @@
----
-"@tm/cli": minor
----
-
-testing this stuff out to see how the release candidate works with monorepo

.changeset/pretty-planes-cross.md

@@ -2,7 +2,7 @@
 "task-master-ai": minor
 ---
 
-Add grok-cli as a provider. You can now use Grok models with Task Master by setting the `GROK_CLI_API_KEY` environment variable.
+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
 
@@ -20,11 +20,17 @@ Add grok-cli as a provider. You can now use Grok models with Task Master by sett
    task-master models --set-fallback grok-beta
    ```
 
-## Available Models
-- `grok-beta` - Latest Grok model
-- `grok-vision-beta` - Grok with vision capabilities
+## 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
 
-The Grok CLI provider integrates with xAI's Grok models and can also use the local Grok CLI configuration file (`~/.grok/user-settings.json`) if available.
+## 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](https://github.com/superagent-ai/grok-cli) by Superagent AI for seamless integration with xAI's Grok models.

.changeset/ready-plums-worry.md

@@ -0,0 +1,8 @@
+---
+"task-master-ai": minor
+---
+
+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

.taskmaster/config.json

@@ -1,9 +1,9 @@
 {
 	"models": {
 		"main": {
-			"provider": "grok-cli",
-			"modelId": "grok-4-latest",
-			"maxTokens": 131072,
+			"provider": "anthropic",
+			"modelId": "claude-sonnet-4-20250514",
+			"maxTokens": 64000,
 			"temperature": 0.2
 		},
 		"research": {
@@ -14,8 +14,8 @@
 		},
 		"fallback": {
 			"provider": "anthropic",
-			"modelId": "claude-sonnet-4-20250514",
-			"maxTokens": 64000,
+			"modelId": "claude-3-7-sonnet-20250219",
+			"maxTokens": 120000,
 			"temperature": 0.2
 		}
 	},

apps/docs/archive/Installation.mdx

@@ -23,7 +23,7 @@ description: "This guide walks you through setting up Task Master in your develo
         			"env": {
         				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
         				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
-        				"MODEL": "claude-3-7-sonnet-20250219",
+        				"MODEL": "claude-sonnet-4-20250514",
         				"PERPLEXITY_MODEL": "sonar-pro",
         				"MAX_TOKENS": 128000,
         				"TEMPERATURE": 0.2,

apps/docs/archive/configuration.mdx

@@ -19,7 +19,7 @@ description: "Configure Task Master through environment variables in a .env file
 
 | Variable | Default Value | Description | Example |
 | --- | --- | --- | --- |
-| `MODEL` | `"claude-3-7-sonnet-20250219"` | Claude model to use | `MODEL=claude-3-opus-20240229` |
+| `MODEL` | `"claude-sonnet-4-20250514"` | Claude model to use | `MODEL=claude-3-opus-20240229` |
 | `MAX_TOKENS` | `"4000"` | Maximum tokens for responses | `MAX_TOKENS=8000` |
 | `TEMPERATURE` | `"0.7"` | Temperature for model responses | `TEMPERATURE=0.5` |
 | `DEBUG` | `"false"` | Enable debug logging | `DEBUG=true` |
@@ -38,7 +38,7 @@ description: "Configure Task Master through environment variables in a .env file
 ANTHROPIC_API_KEY=sk-ant-api03-your-api-key
 
 # Optional - Claude Configuration
-MODEL=claude-3-7-sonnet-20250219
+MODEL=claude-sonnet-4-20250514
 MAX_TOKENS=4000
 TEMPERATURE=0.7
 

apps/docs/best-practices/configuration-advanced.mdx

@@ -18,7 +18,7 @@ Taskmaster uses two primary methods for configuration:
         "models": {
           "main": {
             "provider": "anthropic",
-            "modelId": "claude-3-7-sonnet-20250219",
+            "modelId": "claude-sonnet-4-20250514",
             "maxTokens": 64000,
             "temperature": 0.2,
             "baseURL": "https://api.anthropic.com/v1"
@@ -32,7 +32,7 @@ Taskmaster uses two primary methods for configuration:
           },
           "fallback": {
             "provider": "anthropic",
-            "modelId": "claude-3-5-sonnet",
+            "modelId": "claude-3-7-sonnet-20250219",
             "maxTokens": 64000,
             "temperature": 0.2
           }
@@ -75,7 +75,7 @@ Taskmaster uses two primary methods for configuration:
   - `AZURE_OPENAI_API_KEY`: Your Azure OpenAI API key (also requires `AZURE_OPENAI_ENDPOINT`).
   - `OPENROUTER_API_KEY`: Your OpenRouter API key.
   - `XAI_API_KEY`: Your X-AI API key.
-  - `GROK_CLI_API_KEY`: Your Grok API key from console.x.ai.
+  - `GROK_CLI_API_KEY`: Your Grok API key for grok-cli provider.
 - **Optional Endpoint Overrides:**
   - **Per-role `baseURL` in `.taskmasterconfig`:** You can add a `baseURL` property to any model role (`main`, `research`, `fallback`) to override the default API endpoint for that provider. If omitted, the provider's standard endpoint is used.
   - **Environment Variable Overrides (`<PROVIDER>_BASE_URL`):** For greater flexibility, especially with third-party services, you can set an environment variable like `OPENAI_BASE_URL` or `MISTRAL_BASE_URL`. This will override any `baseURL` set in the configuration file for that provider. This is the recommended way to connect to OpenAI-compatible APIs.
@@ -138,6 +138,7 @@ PERPLEXITY_API_KEY=pplx-your-key-here
 # OPENAI_API_KEY=sk-your-key-here
 # GOOGLE_API_KEY=AIzaSy...
 # AZURE_OPENAI_API_KEY=your-azure-openai-api-key-here
+# GROK_CLI_API_KEY=your-grok-api-key-here
 # etc.
 
 # Optional Endpoint Overrides
@@ -319,22 +320,18 @@ Azure OpenAI provides enterprise-grade OpenAI models through Microsoft's Azure c
    - Ensure the model deployment is in a "Succeeded" state in Azure OpenAI Studio
    - Ensure youre not getting rate limited by `maxTokens` maintain appropriate Tokens per Minute Rate Limit (TPM) in your deployment.
 
-### Grok AI Configuration
+### Grok CLI Configuration
 
-Grok AI provides access to xAI's Grok models with enhanced reasoning capabilities and requires minimal configuration:
+The Grok CLI provider integrates with xAI's Grok models and provides full codebase context support for enhanced task generation and analysis.
 
 1. **Prerequisites**:
-   - An xAI account with API access
-   - Grok API key from [console.x.ai](https://console.x.ai)
+   - A Grok API key from [console.x.ai](https://console.x.ai)
+   - The `grok-cli` package will be automatically used when this provider is configured
 
 2. **Authentication**:
    - Set the `GROK_CLI_API_KEY` environment variable with your Grok API key
 
-3. **Available Models**:
-   - `grok-beta`: Latest Grok model with advanced reasoning
-   - `grok-vision-beta`: Grok with vision capabilities for image analysis
-
-4. **Configuration Example**:
+3. **Configuration**:
    ```json
    // In .taskmaster/config.json
    {
@@ -342,43 +339,41 @@ Grok AI provides access to xAI's Grok models with enhanced reasoning capabilitie
        "main": {
          "provider": "grok-cli",
          "modelId": "grok-beta",
-         "maxTokens": 131072,
-         "temperature": 0.3
+         "maxTokens": 64000,
+         "temperature": 0.2
        },
        "research": {
-         "provider": "grok-cli",
+         "provider": "grok-cli", 
          "modelId": "grok-vision-beta",
-         "maxTokens": 131072,
+         "maxTokens": 8700,
          "temperature": 0.1
        }
+     },
+     "grokCli": {
+       "timeout": 120000,
+       "workingDirectory": null,
+       "defaultModel": "grok-4-latest"
      }
    }
    ```
 
-5. **Environment Variables**:
+4. **Available Models**:
+   - `grok-beta`: Latest Grok model with codebase context
+   - `grok-vision-beta`: Grok with vision capabilities and codebase context
+   - `grok-2`, `grok-3`, `grok-4`: Standard Grok models
+
+5. **Key Features**:
+   - **Full codebase context**: Grok models can analyze your entire project when generating tasks or parsing PRDs
+   - **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
+
+6. **Environment Variables**:
    ```bash
    # In .env file
    GROK_CLI_API_KEY=your-grok-api-key-here
    ```
 
-6. **Setup Commands**:
-   ```bash
-   # Set Grok as your main model
-   task-master models --set-main grok-beta
-   
-   # Set Grok as your research model
-   task-master models --set-research grok-beta
-   
-   # Set Grok as your fallback model
-   task-master models --set-fallback grok-beta
-   ```
-
-7. **Integration Features**:
-   - **Local Configuration Support**: The Grok CLI provider can use your local Grok CLI configuration file (`~/.grok/user-settings.json`) if available
-   - **Full Token Capacity**: Supports Grok's full 131K token capacity for large context operations
-   - **Built on Grok CLI**: Uses the [grok-cli](https://github.com/superagent-ai/grok-cli) by Superagent AI for reliable integration
-
-8. **Troubleshooting**:
-   - **API Key Issues**: Verify your `GROK_CLI_API_KEY` is correctly set and valid
-   - **Model Availability**: Ensure you have access to the specified Grok model variant
-   - **Rate Limits**: Grok models have generous rate limits, but large contexts may take longer to process
+7. **Configuration Options**:
+   - `timeout`: Request timeout in milliseconds (default: 120000)
+   - `workingDirectory`: Override working directory for grok-cli (default: null, uses current directory)
+   - `defaultModel`: Default Grok model to use (default: "grok-4-latest")

apps/docs/capabilities/cli-root-commands.mdx

@@ -38,39 +38,6 @@ sidebarTitle: "CLI Commands"
     ```
   </Accordion>
 
-  <Accordion title="Start Working on a Task">
-    ```bash
-    # Start working on a specific task with Claude Code
-    task-master start <id>
-    
-    # Start the next available task automatically
-    task-master start
-    
-    # Show what would be executed without launching Claude Code
-    task-master start <id> --dry-run
-    
-    # Force start even if another task is in-progress
-    task-master start <id> --force
-    
-    # Don't automatically update task status to in-progress
-    task-master start <id> --no-status-update
-    
-    # Specify project root directory
-    task-master start <id> --project /path/to/project
-    
-    # Get results in JSON format
-    task-master start <id> --format json
-    ```
-    
-    The `start` command automatically launches Claude Code with comprehensive context about the task, including:
-    - Task details and requirements
-    - Implementation guidelines
-    - Related subtasks and dependencies
-    - Project-specific context
-    
-    When no task ID is provided, it automatically finds and starts the next available task based on dependencies and status.
-  </Accordion>
-
   <Accordion title="Show Specific Task">
     ```bash
     # Show details of a specific task

apps/docs/getting-started/quick-start/configuration-quick.mdx

@@ -30,6 +30,7 @@ For MCP/Cursor usage: Configure keys in the env section of your .cursor/mcp.json
 				"MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE",
 				"AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE",
 				"OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE",
+				"GROK_CLI_API_KEY": "GROK_CLI_API_KEY_HERE",
 				"GITHUB_API_KEY": "GITHUB_API_KEY_HERE"
 			}
 		}
@@ -50,6 +51,7 @@ PERPLEXITY_API_KEY=pplx-your-key-here
 # OPENAI_API_KEY=sk-your-key-here
 # GOOGLE_API_KEY=AIzaSy...
 # AZURE_OPENAI_API_KEY=your-azure-openai-api-key-here
+# GROK_CLI_API_KEY=your-grok-api-key-here
 # etc.
 
 # Optional Endpoint Overrides

apps/docs/getting-started/quick-start/execute-quick.mdx

@@ -16,24 +16,6 @@ Alternatively you can use the CLI to show the next task
 task-master next
 ```
 
-### Quick Start with `task-master start`
-
-For immediate task execution, you can use the new `start` command to automatically launch Claude Code with full task context:
-
-```bash
-# Start the next available task automatically
-task-master start
-
-# Or start a specific task
-task-master start 1.2
-```
-
-This command will:
-- Find the next available task (if no ID is provided)
-- Update the task status to "in-progress"  
-- Launch Claude Code with comprehensive task context
-- Provide all necessary implementation details and project context
-
 ## Discuss Task
 When you know what task to work on next you can then start chatting with the agent to make sure it understands the plan of action.
 

apps/docs/whats-new.mdx

@@ -3,70 +3,4 @@ title: "What's New"
 sidebarTitle: "What's New"
 ---
 
-## Latest Features (January 2025)
-
-### 🚀 New `task-master start` Command
-
-**Automated Task Execution with Claude Code Integration**
-
-The new `start` command revolutionizes your development workflow by automatically launching Claude Code with comprehensive task context:
-
-```bash
-# Start a specific task
-task-master start 1.2
-
-# Start the next available task automatically
-task-master start
-
-# Preview what would be executed without launching Claude Code
-task-master start 1.2 --dry-run
-```
-
-**Key Features:**
-- **Automatic Task Discovery** - When no ID is provided, finds the next available task based on dependencies and status
-- **Rich Context Injection** - Provides Claude Code with task details, requirements, subtasks, and project context
-- **Status Management** - Automatically updates task status to "in-progress" when starting
-- **Flexible Options** - Support for dry-run, force mode, custom project paths, and JSON output
-
-### 🤖 Grok AI Provider Support
-
-**Enhanced AI Model Options**
-
-Task Master now supports xAI's Grok models with full 131K token capacity:
-
-```bash
-# Configure Grok as your main model
-task-master models --set-main grok-beta
-
-# Use Grok with vision capabilities
-task-master models --set-research grok-vision-beta
-```
-
-**Setup:**
-1. Get your API key from [console.x.ai](https://console.x.ai)
-2. Set `GROK_CLI_API_KEY` environment variable
-3. Configure using `task-master models --setup`
-
-**Available Models:**
-- `grok-beta` - Latest Grok model with advanced reasoning
-- `grok-vision-beta` - Grok with vision capabilities
-
-### 📱 VS Code Extension "Start Task" Button
-
-**Seamless VS Code Integration**
-
-The Task Master VS Code extension now includes a "Start Task" button for one-click task execution:
-
-- **Direct Integration** - Launch Claude Code directly from task cards in VS Code
-- **No Terminal Switching** - Automatic terminal management and command execution
-- **Full Context** - Same rich context injection as the CLI command
-- **Visual Workflow** - Seamless transition from task planning to implementation
-
-### 🔧 Technical Improvements
-
-- **TypeScript Migration** - Core components now use TypeScript for better type safety
-- **Model Configuration Updates** - Upgraded fallback model to Claude Sonnet 4
-- **Token Capacity Fixes** - Grok models now properly support their full 131K token capacity
-- **Enhanced Error Handling** - Improved error messages and debugging capabilities
-
 An easy way to see the latest releases

apps/extension/README.md

@@ -22,7 +22,6 @@ Taskmaster AI is an intelligent task management system designed for AI-assisted
 ![Kanban Board](assets/screenshots/kanban-board.png)
 
 ### 🤖 **AI-Powered Features**
-- **One-Click Task Start** - Launch Claude Code directly from task cards with full context
 - **Task Content Generation** - Regenerate task descriptions using AI
 - **Smart Task Updates** - Append findings and progress notes automatically
 - **MCP Integration** - Seamless connection to Taskmaster AI via Model Context Protocol
@@ -84,7 +83,6 @@ The extension automatically handles the Taskmaster MCP server connection:
 | **View Kanban Board** | `Ctrl/Cmd + Shift + P` → "Taskmaster: Show Board" |
 | **Change Task Status** | Drag task card to different column |
 | **View Task Details** | Click on any task card |
-| **Start Working on Task** | Click "Start Task" button to launch Claude Code automatically |
 | **Edit Task Content** | Click task → Use edit buttons in details panel |
 | **Add Subtasks** | Click the + button on parent task cards |
 | **Use AI Features** | Open task details → Click AI action buttons |

packages/tm-core/src/config/config-manager.spec.ts

@@ -5,6 +5,7 @@
 
 import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
 import { ConfigManager } from './config-manager.js';
+import { DEFAULT_CONFIG_VALUES } from '../interfaces/configuration.interface.js';
 import { ConfigLoader } from './services/config-loader.service.js';
 import { ConfigMerger } from './services/config-merger.service.js';
 import { RuntimeStateManager } from './services/runtime-state-manager.service.js';
@@ -69,8 +70,8 @@ describe('ConfigManager', () => {
 				({
 					loadState: vi.fn().mockResolvedValue({ activeTag: 'master' }),
 					saveState: vi.fn().mockResolvedValue(undefined),
-					getActiveTag: vi.fn().mockReturnValue('master'),
-					setActiveTag: vi.fn().mockResolvedValue(undefined),
+					getCurrentTag: vi.fn().mockReturnValue('master'),
+					setCurrentTag: vi.fn().mockResolvedValue(undefined),
 					getState: vi.fn().mockReturnValue({ activeTag: 'master' }),
 					updateMetadata: vi.fn().mockResolvedValue(undefined),
 					clearState: vi.fn().mockResolvedValue(undefined)
@@ -227,8 +228,8 @@ describe('ConfigManager', () => {
 
 			const models = manager.getModelConfig();
 			expect(models).toEqual({
-				main: 'claude-3-5-sonnet-20241022',
-				fallback: 'gpt-4o-mini'
+				main: DEFAULT_CONFIG_VALUES.MODELS.MAIN,
+				fallback: DEFAULT_CONFIG_VALUES.MODELS.FALLBACK
 			});
 		});
 
@@ -281,7 +282,7 @@ describe('ConfigManager', () => {
 			await manager.setActiveTag('feature-branch');
 
 			const stateManager = (manager as any).stateManager;
-			expect(stateManager.setActiveTag).toHaveBeenCalledWith('feature-branch');
+			expect(stateManager.setCurrentTag).toHaveBeenCalledWith('feature-branch');
 		});
 	});
 

packages/tm-core/src/config/config-manager.ts

@@ -10,6 +10,7 @@ import type {
 	PartialConfiguration,
 	RuntimeStorageConfig
 } from '../interfaces/configuration.interface.js';
+import { DEFAULT_CONFIG_VALUES as DEFAULTS } from '../interfaces/configuration.interface.js';
 import { ConfigLoader } from './services/config-loader.service.js';
 import {
 	ConfigMerger,
@@ -167,8 +168,8 @@ export class ConfigManager {
 	getModelConfig() {
 		return (
 			this.config.models || {
-				main: 'claude-3-5-sonnet-20241022',
-				fallback: 'gpt-4o-mini'
+				main: DEFAULTS.MODELS.MAIN,
+				fallback: DEFAULTS.MODELS.FALLBACK
 			}
 		);
 	}

packages/tm-core/src/interfaces/configuration.interface.ts

@@ -399,8 +399,8 @@ export interface IConfigurationManager {
  */
 export const DEFAULT_CONFIG_VALUES = {
 	MODELS: {
-		MAIN: 'claude-3-5-sonnet-20241022',
-		FALLBACK: 'gpt-4o-mini'
+		MAIN: 'claude-sonnet-4-20250514',
+		FALLBACK: 'claude-3-7-sonnet-20250219'
 	},
 	TASKS: {
 		DEFAULT_PRIORITY: 'medium' as TaskPriority,

scripts/modules/config-manager.js

@@ -27,21 +27,21 @@ const DEFAULTS = {
 	models: {
 		main: {
 			provider: 'anthropic',
-			modelId: 'claude-3-7-sonnet-20250219',
+			modelId: 'claude-sonnet-4-20250514',
 			maxTokens: 64000,
 			temperature: 0.2
 		},
 		research: {
 			provider: 'perplexity',
-			modelId: 'sonar-pro',
+			modelId: 'sonar',
 			maxTokens: 8700,
 			temperature: 0.1
 		},
 		fallback: {
 			// No default fallback provider/model initially
 			provider: 'anthropic',
-			modelId: 'claude-3-5-sonnet',
-			maxTokens: 8192, // Default parameters if fallback IS configured
+			modelId: 'claude-3-7-sonnet-20250219',
+			maxTokens: 120000, // Default parameters if fallback IS configured
 			temperature: 0.2
 		}
 	},

tests/unit/config-manager.test.js

@@ -119,20 +119,20 @@ const DEFAULT_CONFIG = {
 	models: {
 		main: {
 			provider: 'anthropic',
-			modelId: 'claude-3-7-sonnet-20250219',
+			modelId: 'claude-sonnet-4-20250514',
 			maxTokens: 64000,
 			temperature: 0.2
 		},
 		research: {
 			provider: 'perplexity',
-			modelId: 'sonar-pro',
+			modelId: 'sonar',
 			maxTokens: 8700,
 			temperature: 0.1
 		},
 		fallback: {
 			provider: 'anthropic',
-			modelId: 'claude-3-5-sonnet',
-			maxTokens: 8192,
+			modelId: 'claude-3-7-sonnet-20250219',
+			maxTokens: 120000,
 			temperature: 0.2
 		}
 	},