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

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

  Original commit: Merge pull request #1231 from eyaltoledano/ralph/merge.from.main\n\n\n

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

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

@@ -206,4 +206,25 @@ sidebarTitle: "CLI Commands"
     task-master init
     ```
   </Accordion>
+
+  <Accordion title="Start Working on Tasks">
+    ```bash
+    # Start working on a specific task with Claude Code
+    task-master start <task-id>
+
+    # Start working on the next available task automatically
+    task-master start
+
+    # Example: Start working on task 1.2
+    task-master start 1.2
+    ```
+
+    The `start` command automatically launches Claude Code with a comprehensive prompt containing:
+    - Complete task details and context
+    - Implementation guidelines and best practices
+    - Relevant codebase information
+    - Dependencies and requirements
+
+    When no task ID is provided, it automatically detects and starts the next available task.
+  </Accordion>
 </AccordionGroup>

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

@@ -30,7 +30,8 @@ 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",
-				"GITHUB_API_KEY": "GITHUB_API_KEY_HERE"
+				"GITHUB_API_KEY": "GITHUB_API_KEY_HERE",
+				"GROK_CLI_API_KEY": "GROK_CLI_API_KEY_HERE"
 			}
 		}
 	}
@@ -62,8 +63,50 @@ PERPLEXITY_API_KEY=pplx-your-key-here
 
 # Google Vertex AI Configuration (Required if using 'vertex' provider)
 # VERTEX_PROJECT_ID=your-gcp-project-id
+
+# Grok CLI Configuration (Required if using 'grok-cli' provider)
+# GROK_CLI_API_KEY=your-grok-api-key-here
+
+# Codebase Analysis Feature Control
+# TASKMASTER_ENABLE_CODEBASE_ANALYSIS=true  # Enable codebase analysis features (default: true)
 ```
 
+## Grok Provider Setup
+
+Task Master now supports Grok models from xAI with full codebase context awareness. This is especially useful for AI operations that benefit from understanding your entire project structure.
+
+### Getting Started with Grok
+
+1. **Get your Grok API key** from [console.x.ai](https://console.x.ai)
+2. **Set the environment variable**:
+   ```bash
+   export GROK_CLI_API_KEY="your-api-key-here"
+   ```
+3. **Configure Task Master to use Grok**:
+   ```bash
+   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
+
+<Note>
+The Grok CLI provider integrates with xAI's Grok models via [grok-cli](https://github.com/superagent-ai/grok-cli) by Superagent AI and can also use the local Grok CLI configuration file (`~/.grok/user-settings.json`) if available.
+</Note>
+
 ## What Else Can Be Configured?
 
 The main configuration file (`.taskmaster/config.json`) allows you to control nearly every aspect of Task Master’s behavior. Here’s a high-level look at what you can customize:
@@ -89,6 +132,13 @@ You don’t need to configure everything up front. Most settings can be left as
 - `defaultSubtasks`: Number of subtasks to auto-generate
 - `defaultPriority`: Priority level for new tasks
 
+### Codebase Analysis Control
+- `TASKMASTER_ENABLE_CODEBASE_ANALYSIS`: Control whether codebase analysis features are enabled
+  - Can be set via environment variables, MCP configuration, or project config files
+  - Priority order: `.env` > MCP session env > `.taskmaster/config.json`
+  - Default: `true`
+  - When enabled, allows providers like Claude Code and Gemini CLI to analyze your project structure for more contextual task generation
+
 ### API Endpoint Overrides
 - `ollamaBaseURL`: Custom Ollama server URL
 - `azureBaseURL`: Global Azure endpoint

apps/docs/whats-new.mdx

@@ -3,4 +3,78 @@ title: "What's New"
 sidebarTitle: "What's New"
 ---
 
-An easy way to see the latest releases
+## Version 0.27.0 - Latest Release
+
+### New Features
+
+#### `task-master start` Command
+- **Automated Task Execution**: New command that automatically launches Claude Code with comprehensive task context
+- **Smart Task Detection**: When no task ID is provided, automatically detects and starts the next available task
+- **Rich Context**: Provides complete task details, implementation guidelines, and codebase information to Claude Code
+
+#### Grok Provider Integration
+- **Full Codebase Context**: Grok models can now analyze your entire project when generating tasks or parsing PRDs
+- **xAI Model Support**: Access to latest Grok models (grok-2, grok-3, grok-4, etc.) via the grok-cli integration
+- **Code-Aware Generation**: More accurate and contextual task creation based on your actual codebase structure
+- **Available Models**: 
+  - `grok-beta` - Latest Grok model with codebase context
+  - `grok-vision-beta` - Grok with vision capabilities and codebase context
+
+### Improvements
+
+#### Enhanced Provider Defaults
+- **Main Model**: Upgraded from Claude 3.5 Sonnet to **Claude Sonnet 4** for better performance
+- **Fallback Model**: Improved from Claude 3.5 Sonnet to **Claude 3.7** for enhanced reliability
+
+#### MCP Server Simplification
+- **No More --package Flag**: Removed the need for `--package=task-master-ai` in MCP server configuration
+- **Bundled Package**: The entire package is now bundled, eliminating common configuration issues
+
+#### Auto-Update Functionality
+- **CLI Auto-Updates**: Every CLI command now includes auto-update functionality to keep you on the latest version
+
+#### Codebase Analysis Feature Control
+- **Configurable Analysis**: New `TASKMASTER_ENABLE_CODEBASE_ANALYSIS` environment variable to control codebase analysis features
+- **Multiple Configuration Sources**: Can be set via `.env`, MCP configuration, or project config files
+- **Priority System**: Environment variables > MCP session env > `.taskmaster/config.json`
+
+### TypeScript Migration
+- **Improved Development**: Moving from JavaScript to TypeScript environment for better development experience
+- **Gradual Migration**: JavaScript commands are being incrementally moved to TypeScript
+
+## Getting Started with New Features
+
+### Using the Start Command
+```bash
+# Start working on a specific task
+task-master start 1.2
+
+# Auto-detect and start next available task  
+task-master start
+```
+
+### Setting up Grok
+```bash
+# Set your API key
+export GROK_CLI_API_KEY="your-api-key-here"
+
+# Configure Grok as your main provider
+task-master models --set-main grok-beta
+```
+
+### Simplified MCP Configuration
+```json
+{
+  "mcpServers": {
+    "task-master-ai": {
+      "command": "npx",
+      "args": ["-y", "task-master-ai"],
+      "env": {
+        "ANTHROPIC_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+For detailed setup instructions and configuration options, see our [Configuration Guide](/docs/getting-started/quick-start/configuration-quick).