From 73bda5b8d4ed2fac104105c29c57b4d689e29b98 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Tue, 14 Oct 2025 18:36:51 +0000 Subject: [PATCH] feat: enhance docs with AI agent selection and improved getting started - Add AI agent selection page with visual cards and logos - Create dedicated setup guides for Cursor, Claude Code, and CLI - Move Windows-specific MCP config from README to docs - Enhance quick-start page with agent selection flow - Improve user experience with clear visual hierarchy Co-authored-by: Ralph Khreish --- README.md | 31 -- .../getting-started/agents/claude-code.mdx | 275 +++++++++++++ apps/docs/getting-started/agents/cli.mdx | 373 ++++++++++++++++++ apps/docs/getting-started/agents/cursor.mdx | 247 ++++++++++++ apps/docs/getting-started/ai-agents.mdx | 118 ++++++ .../quick-start/quick-start.mdx | 22 +- 6 files changed, 1034 insertions(+), 32 deletions(-) create mode 100644 apps/docs/getting-started/agents/claude-code.mdx create mode 100644 apps/docs/getting-started/agents/cli.mdx create mode 100644 apps/docs/getting-started/agents/cursor.mdx create mode 100644 apps/docs/getting-started/ai-agents.mdx diff --git a/README.md b/README.md index 1a417540..4e698322 100644 --- a/README.md +++ b/README.md @@ -124,37 +124,6 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor. > **Note**: If you see `0 tools enabled` in the MCP settings, restart your editor and check that your API keys are correctly configured. -###### Windows-specific Configuration - -For Windows users without WSL, you may need to use `cmd` to run the MCP server: - -```json -{ - "mcpServers": { - "task-master-ai": { - "command": "cmd", - "args": ["/c", "npx -y --package=task-master-ai task-master-ai"], - "env": { - "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE", - "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE", - "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE", - "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE", - "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE", - "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE", - "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE", - "XAI_API_KEY": "YOUR_XAI_KEY_HERE", - "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE", - "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE" - } - } - } -} -``` - -Alternatively, you can install at the project level with Claude Code: -```bash -claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" -``` ###### VSβ€―Code (`servers` + `type`) diff --git a/apps/docs/getting-started/agents/claude-code.mdx b/apps/docs/getting-started/agents/claude-code.mdx new file mode 100644 index 00000000..56cff166 --- /dev/null +++ b/apps/docs/getting-started/agents/claude-code.mdx @@ -0,0 +1,275 @@ +--- +title: Claude Code Setup +sidebarTitle: "Claude Code" +--- + +
+ Claude Code +
+

Claude Code

+

Anthropic's official CLI for Claude

+
+
+ +Claude Code offers the smoothest Task Master experience with **zero API key setup** and direct Claude integration. + +## 🎯 Why Choose Claude Code? + +
+
+

πŸ”“ No API Keys

+

Uses your existing Claude subscription - no separate API setup needed

+
+
+

⚑ Native Integration

+

Built specifically for Claude - seamless Task Master experience

+
+
+ +## πŸ“¦ Installation + +### Step 1: Install Claude Code + +Follow the [official Claude Code installation guide](https://docs.anthropic.com/en/docs/claude-code) or use our quick setup: + + + + ```bash + # Install via Homebrew (recommended) + brew install claude-code + + # Or download from GitHub releases + curl -L https://github.com/anthropics/claude-code/releases/latest/download/claude-code-macos.tar.gz | tar xz + sudo mv claude-code /usr/local/bin/ + ``` + + + + ```powershell + # Download and install from GitHub releases + # Visit: https://github.com/anthropics/claude-code/releases/latest + # Download: claude-code-windows.exe + + # Or use winget (if available) + winget install Anthropic.ClaudeCode + ``` + + + + ```bash + # Download from GitHub releases + curl -L https://github.com/anthropics/claude-code/releases/latest/download/claude-code-linux.tar.gz | tar xz + sudo mv claude-code /usr/local/bin/ + + # Or install via package manager (if available) + sudo apt install claude-code # Ubuntu/Debian + sudo yum install claude-code # RHEL/CentOS + ``` + + + +### Step 2: Authenticate with Claude + +```bash +# Login to your Claude account +claude auth login +``` + +Follow the prompts to authenticate with your Anthropic account. + +## πŸ”§ Task Master Integration + +### Method 1: MCP Integration (Recommended) + +Add Task Master to your Claude Code MCP configuration: + + + + ```bash + # Add Task Master MCP server globally + claude mcp add task-master-ai -s global -- npx -y task-master-ai + ``` + + + + ```bash + # Add for current project only + claude mcp add task-master-ai -s project -- npx -y task-master-ai + ``` + + + + ```bash + # Windows-specific command + claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" + ``` + + + +### Method 2: Direct CLI Usage + +You can also use Task Master commands directly alongside Claude Code: + +```bash +# Initialize Task Master in your project +npx task-master-ai init + +# Use Claude Code for AI interactions +claude "Help me implement the next task" + +# Use Task Master for task management +npx task-master-ai next +npx task-master-ai show 1.2 +``` + +## πŸš€ Getting Started + +### 1. Initialize Your Project + +In your project directory: + +```bash +# Start Claude Code +claude + +# In the Claude Code chat, initialize Task Master +Initialize taskmaster-ai in my project +``` + +### 2. Configure Models (Optional) + +Since Claude Code doesn't need API keys, you can use it as your main model: + +``` +Change the main model to claude-code/sonnet +``` + +Available Claude Code models: +- `claude-code/sonnet` - Claude 3.5 Sonnet (recommended) +- `claude-code/opus` - Claude 3 Opus (for complex tasks) + +### 3. Create Your First Tasks + +``` +Can you parse my PRD and create tasks for building a todo app? +``` + +## πŸ’‘ Advanced Configuration + +### Hybrid Setup + +Use Claude Code as your main model with other APIs for research: + +Create `.env` in your project: +```bash +# Optional: Add research capabilities +PERPLEXITY_API_KEY=your_perplexity_key_here +OPENAI_API_KEY=your_openai_key_here +``` + +Then configure models: +``` +Change the main model to claude-code/sonnet and research model to perplexity-llama-3.1-sonar-large-128k-online +``` + +### Multi-Session Workflows + +Claude Code excels at parallel development: + +```bash +# Terminal 1: Main development +cd my-project && claude + +# Terminal 2: Testing and validation +cd my-project && claude + +# Terminal 3: Documentation +cd my-project && claude +``` + +Each session maintains Task Master context while allowing focused work streams. + +## πŸ” Troubleshooting + + +- **Check installation**: Run `claude --version` to verify installation +- **Update PATH**: Ensure Claude Code is in your system PATH +- **Reinstall**: Try reinstalling Claude Code from scratch +- **Permissions**: Check file permissions for the claude binary + + + +- **Re-login**: Run `claude auth logout` then `claude auth login` +- **Check account**: Verify your Anthropic account is active +- **Network issues**: Check if you're behind a proxy or firewall +- **Clear cache**: Delete `~/.claude` directory and re-authenticate + + + +- **Check Node.js**: Ensure Node.js 16+ is installed +- **Test manually**: Run `npx task-master-ai` to test the server +- **Clear MCP cache**: Remove and re-add the MCP server +- **Check permissions**: Ensure npm can install packages + + + +- **Verify MCP**: Run `claude mcp list` to see installed servers +- **Re-add server**: Remove and re-add the task-master-ai MCP server +- **Check initialization**: Ensure project is initialized with `Initialize taskmaster-ai` +- **Review logs**: Check Claude Code logs for error messages + + +## πŸ’‘ Pro Tips + + +**Use headless mode** for automation: `claude -p "What's the next task I should work on?"` gives quick answers without opening the full chat interface. + + + +**Create custom commands** using Claude Code's command system for repeated Task Master workflows like "complete task and get next". + + + +**Leverage context persistence** - Claude Code maintains conversation history, making it perfect for long-running development sessions. + + +## 🎯 Best Practices + +### Development Workflow + +```bash +# Morning routine +claude "Show me today's tasks and priorities" + +# During development +claude "Help me implement task 2.1" +claude "Update task 2.1 with implementation notes" + +# End of day +claude "Mark completed tasks as done and show tomorrow's priorities" +``` + +### Team Collaboration + +```bash +# Share task status +claude "Generate a progress report for the team" + +# Review dependencies +claude "Check which tasks are blocked and why" + +# Planning sessions +claude "Analyze complexity of remaining tasks" +``` + +--- + +
+
+ πŸŽ‰ +

You're all set with Claude Code!

+
+

+ Claude Code offers the most seamless Task Master experience. Ready to create your first project? Check out our PRD guide. +

+
\ No newline at end of file diff --git a/apps/docs/getting-started/agents/cli.mdx b/apps/docs/getting-started/agents/cli.mdx new file mode 100644 index 00000000..8b97b865 --- /dev/null +++ b/apps/docs/getting-started/agents/cli.mdx @@ -0,0 +1,373 @@ +--- +title: Command Line Setup +sidebarTitle: "CLI" +--- + +
+ Terminal +
+

Command Line Interface

+

Direct CLI usage without IDE integration

+
+
+ +Use Task Master directly from the command line for maximum flexibility and control. + +## 🎯 Why Choose CLI? + +
+
+

πŸš€ Maximum Performance

+

No IDE overhead - pure command line speed

+
+
+

πŸ”§ Full Control

+

Access to all Task Master features and configurations

+
+
+

πŸ“œ Scriptable

+

Perfect for automation and CI/CD integration

+
+
+

🌐 Universal

+

Works on any system with Node.js

+
+
+ +## πŸ“¦ Installation + +### Global Installation (Recommended) + +```bash +# Install Task Master globally +npm install -g task-master-ai + +# Verify installation +task-master --version +``` + +### Local Installation + +```bash +# Install in your project +npm install task-master-ai + +# Use with npx +npx task-master-ai --version +``` + +## πŸ”§ Configuration + +### Step 1: Set Up API Keys + +Create a `.env` file in your project root: + +```bash +# At least one of these is required +ANTHROPIC_API_KEY=your_anthropic_key_here +PERPLEXITY_API_KEY=your_perplexity_key_here # Recommended for research +OPENAI_API_KEY=your_openai_key_here + +# Optional additional providers +GOOGLE_API_KEY=your_google_key_here +MISTRAL_API_KEY=your_mistral_key_here +OPENROUTER_API_KEY=your_openrouter_key_here +XAI_API_KEY=your_xai_key_here +``` + +### Step 2: Configure Models + +```bash +# Interactive model configuration +task-master models --setup + +# Or set specific models +task-master models --set-main claude-3-5-sonnet-20241022 +task-master models --set-research perplexity-llama-3.1-sonar-large-128k-online +task-master models --set-fallback gpt-4o-mini +``` + +### Step 3: Initialize Your Project + +```bash +# Initialize Task Master in current directory +task-master init + +# Initialize with specific rules +task-master init --rules cursor,windsurf,vscode +``` + +## πŸš€ Quick Start Guide + +### 1. Create Your PRD + +```bash +# Create a Product Requirements Document +touch .taskmaster/docs/prd.txt + +# Edit with your favorite editor +nano .taskmaster/docs/prd.txt +# or +code .taskmaster/docs/prd.txt +``` + +### 2. Generate Tasks + +```bash +# Parse your PRD and create tasks +task-master parse-prd .taskmaster/docs/prd.txt + +# Analyze task complexity +task-master analyze-complexity --research + +# Expand tasks into subtasks +task-master expand --all --research +``` + +### 3. Start Working + +```bash +# See all tasks +task-master list + +# Get next task to work on +task-master next + +# Show specific task details +task-master show 1.2 + +# Mark task as in-progress +task-master set-status --id=1.2 --status=in-progress +``` + +## πŸ“‹ Essential Commands + +### Task Management + +```bash +# List all tasks +task-master list + +# Show specific tasks (comma-separated) +task-master show 1,2,3 + +# Get next available task +task-master next + +# Add a new task +task-master add-task --prompt="Implement user login" --research + +# Update task with notes +task-master update-task --id=1.2 --prompt="Added JWT authentication" + +# Update subtask with implementation notes +task-master update-subtask --id=1.2.1 --prompt="Used bcrypt for password hashing" +``` + +### Task Status Management + +```bash +# Mark task as done +task-master set-status --id=1.2 --status=done + +# Mark as in-progress +task-master set-status --id=1.2 --status=in-progress + +# Mark as blocked +task-master set-status --id=1.2 --status=blocked +``` + +### Analysis and Planning + +```bash +# Research latest information +task-master research "What are the latest React best practices?" + +# Analyze project complexity +task-master analyze-complexity --research + +# View complexity report +task-master complexity-report + +# Expand task into subtasks +task-master expand --id=1.2 --research --force +``` + +### Dependencies and Organization + +```bash +# Add task dependency +task-master add-dependency --id=2.1 --depends-on=1.2 + +# Move task to different position +task-master move --from=3 --to=1 + +# Validate dependencies +task-master validate-dependencies + +# Generate markdown files +task-master generate +``` + +## 🎯 Advanced Usage + +### Scripting and Automation + +Create shell scripts for common workflows: + +```bash +#!/bin/bash +# daily-standup.sh + +echo "=== Today's Tasks ===" +task-master next + +echo -e "\n=== In Progress ===" +task-master list | grep "in-progress" + +echo -e "\n=== Blocked Tasks ===" +task-master list | grep "blocked" + +echo -e "\n=== Complexity Report ===" +task-master complexity-report +``` + +### CI/CD Integration + +```yaml +# .github/workflows/task-validation.yml +name: Task Validation + +on: [push, pull_request] + +jobs: + validate-tasks: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v2 + with: + node-version: '18' + + - name: Install Task Master + run: npm install -g task-master-ai + + - name: Validate task dependencies + run: task-master validate-dependencies + + - name: Generate task report + run: task-master complexity-report > task-report.json +``` + +### Custom Aliases + +Add these to your `.bashrc` or `.zshrc`: + +```bash +# Task Master shortcuts +alias tm="task-master" +alias tmn="task-master next" +alias tml="task-master list" +alias tmr="task-master research" +alias tms="task-master show" +``` + +## πŸ” Troubleshooting + + +**Solutions:** +- Verify Node.js installation: `node --version` +- Reinstall globally: `npm install -g task-master-ai` +- Check npm global path: `npm config get prefix` +- Use npx if global install fails: `npx task-master-ai` + + + +**Solutions:** +- Check `.env` file exists and has correct keys +- Verify API key format and validity +- Test with a single API key first +- Check for typos in environment variable names + + + +**Solutions:** +- Verify PRD file exists and has content +- Check API keys are working: `task-master models` +- Try with different model: `task-master models --set-main gpt-4o-mini` +- Add `--research` flag for better results + + + +**Solutions:** +- Use `sudo` for global installs (not recommended) +- Configure npm to use different directory: `npm config set prefix ~/.local` +- Use local installation: `npm install task-master-ai` +- Check file permissions in `.taskmaster` directory + + +## πŸ’‘ Pro Tips + + +**Use `--research` flag** with AI commands for more informed and up-to-date task suggestions based on current best practices. + + + +**Create project templates** with pre-configured `.taskmaster` directories for different types of projects (web apps, APIs, mobile apps). + + + +**Combine with other tools** like `jq` for parsing JSON outputs: `task-master list --json | jq '.[] | select(.status=="pending")'` + + + +**Use environment-specific configs** by creating different `.env` files (.env.development, .env.production) and symlinking as needed. + + +## πŸ“š Integration Examples + +### With Git Hooks + +```bash +#!/bin/sh +# .git/hooks/pre-commit + +# Check if any tasks are marked as done +if task-master list | grep -q "done"; then + echo "βœ… Tasks completed in this commit:" + task-master list | grep "done" +fi +``` + +### With Make + +```makefile +# Makefile + +.PHONY: tasks next status + +tasks: + @task-master list + +next: + @task-master next + +status: + @echo "=== Task Status ===" + @task-master list | grep -E "(in-progress|blocked)" + @echo "" + @echo "=== Next Task ===" + @task-master next +``` + +--- + +
+
+ ⚑ +

Ready for maximum productivity!

+
+

+ You now have the full power of Task Master at your fingertips. Create your first project with our PRD guide. +

+
\ No newline at end of file diff --git a/apps/docs/getting-started/agents/cursor.mdx b/apps/docs/getting-started/agents/cursor.mdx new file mode 100644 index 00000000..a931e9da --- /dev/null +++ b/apps/docs/getting-started/agents/cursor.mdx @@ -0,0 +1,247 @@ +--- +title: Cursor Setup +sidebarTitle: "Cursor" +--- + +
+ Cursor +
+

Cursor AI Editor

+

AI-powered VS Code fork with built-in MCP support

+
+
+ +Cursor offers the smoothest Task Master experience with one-click installation and native MCP integration. + +## πŸš€ One-Click Install (Recommended) + +
+
+ ⚑ +

Fastest Setup

+
+ + + Add Task Master MCP server to Cursor + Add Task Master MCP server to Cursor + +
+ + +**After one-click install**: You still need to add your actual API keys! The installer uses placeholder keys that must be replaced. + + +## πŸ“‹ Manual Setup + +If you prefer manual configuration or the one-click install doesn't work: + +### Step 1: Create MCP Configuration + +Choose your configuration scope: + + + + Create or edit `~/.cursor/mcp.json` (macOS/Linux) or `%USERPROFILE%\.cursor\mcp.json` (Windows): + + ```json + { + "mcpServers": { + "task-master-ai": { + "command": "npx", + "args": ["-y", "task-master-ai"], + "env": { + "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE", + "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE", + "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE", + "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE", + "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE", + "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE", + "XAI_API_KEY": "YOUR_XAI_KEY_HERE" + } + } + } + } + ``` + + + + Create `.cursor/mcp.json` in your project root: + + ```json + { + "mcpServers": { + "task-master-ai": { + "command": "npx", + "args": ["-y", "task-master-ai"], + "env": { + "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE", + "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE" + } + } + } + } + ``` + + + + For Windows users without WSL: + + ```json + { + "mcpServers": { + "task-master-ai": { + "command": "cmd", + "args": ["/c", "npx -y --package=task-master-ai task-master-ai"], + "env": { + "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE", + "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE", + "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE" + } + } + } + } + ``` + + + **Alternative Windows Setup**: Use Claude Code's project-level installation: + ```bash + claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" + ``` + + + + +### Step 2: Enable MCP Server + +1. Open Cursor Settings (`Ctrl+Shift+J` or `Cmd+Shift+J`) +2. Click the **MCP** tab in the left sidebar +3. Find `task-master-ai` and toggle it **ON** +4. Restart Cursor if needed + +### Step 3: Verify Installation + +In Cursor's chat panel, type: +``` +help +``` + +You should see Task Master commands available. If you see "0 tools enabled", check your API keys and restart Cursor. + +## πŸ”§ Configuration + +### Add Your API Keys + + + + You need **at least one** of these: + - `ANTHROPIC_API_KEY` - For Claude models (recommended) + - `OPENAI_API_KEY` - For GPT models + - `GOOGLE_API_KEY` - For Gemini models + + + + For the best experience, also add: + - `PERPLEXITY_API_KEY` - Enables research features + - `OPENAI_API_KEY` - Fallback option + + + + Full list of supported API keys: + - `ANTHROPIC_API_KEY` + - `PERPLEXITY_API_KEY` + - `OPENAI_API_KEY` + - `GOOGLE_API_KEY` + - `MISTRAL_API_KEY` + - `OPENROUTER_API_KEY` + - `XAI_API_KEY` + - `AZURE_OPENAI_API_KEY` + - `OLLAMA_API_KEY` + + + +### Configure Models (Optional) + +In Cursor's chat, set your preferred models: + +``` +Change the main, research and fallback models to claude-3-5-sonnet-20241022, perplexity-llama-3.1-sonar-large-128k-online and gpt-4o-mini respectively. +``` + +## 🎯 Getting Started + +### 1. Initialize Task Master + +In Cursor's chat panel: +``` +Initialize taskmaster-ai in my project +``` + +### 2. Create Your First Task + +``` +Can you help me implement user authentication for my web app? +``` + +### 3. Start Working + +``` +What's the next task I should work on? +``` + +## πŸ” Troubleshooting + + +- **Check API keys**: Ensure at least one API key is correctly set +- **Restart Cursor**: Close and reopen Cursor completely +- **Check file paths**: Verify your `mcp.json` is in the correct location +- **Test manually**: Run `npx task-master-ai` in terminal to test + + + +- **Update Node.js**: Ensure you have Node.js 16+ installed +- **Clear npm cache**: Run `npm cache clean --force` +- **Try global install**: Run `npm install -g task-master-ai` +- **Check permissions**: Ensure npm has permission to install packages + + + +- **Verify installation**: Type `help` in chat to see available commands +- **Check project initialization**: Run `Initialize taskmaster-ai in my project` +- **Review logs**: Check Cursor's developer console for error messages + + +## πŸ’‘ Pro Tips + + +**Use project-specific configs** for different API keys per project, especially when working with team projects that have shared API limits. + + + +**Enable research mode** with a Perplexity API key to get AI-powered task suggestions based on the latest best practices. + + + +**Set up keyboard shortcuts** in Cursor for common Task Master commands like "What's next?" or "Show task status". + + +--- + +
+
+ βœ… +

Ready to go!

+
+

+ You're all set with Cursor! Head over to our PRD guide to create your first project. +

+
\ No newline at end of file diff --git a/apps/docs/getting-started/ai-agents.mdx b/apps/docs/getting-started/ai-agents.mdx new file mode 100644 index 00000000..da7f7ce7 --- /dev/null +++ b/apps/docs/getting-started/ai-agents.mdx @@ -0,0 +1,118 @@ +--- +title: Choose Your AI Agent +sidebarTitle: "AI Agents" +--- + +Task Master works seamlessly with various AI agents. Choose your preferred agent to get customized setup instructions. + + + +
+ Cursor + AI-powered VS Code fork with built-in MCP support +
+ + + +
+ Claude Code + Anthropic's official CLI for Claude +
+ + + +
+ Windsurf + Codeium's AI-native IDE +
+ + + +
+ VS Code + Microsoft's editor with MCP extensions +
+ + + +
+ Terminal + Direct CLI usage without IDE integration +
+ + + +
+ Other + Generic setup for other AI agents +
+ + + +## Quick Recommendations + + +**For beginners**: Start with **Cursor** - it has the most seamless MCP integration and one-click install. + +**For Claude users**: Use **Claude Code** - it's Anthropic's official CLI with no API key required. + +**For existing VS Code users**: Stick with **VS Code** if you're already comfortable with your setup. + +**For advanced users**: Try **Windsurf** for its AI-native features or use **Command Line** for maximum flexibility. + + + +MCP (Model Control Protocol) allows Task Master to run directly inside your AI agent, giving you: +- πŸ”₯ **Seamless integration** - No switching between tools +- ⚑ **Real-time task management** - Tasks update as you work +- 🧠 **Context awareness** - Your AI knows about your tasks +- 🎯 **Smart suggestions** - AI can recommend next tasks + + +## Platform-Specific Notes + + + + **Important**: Windows users may need special configuration for some agents. We'll provide Windows-specific instructions for each agent. + + Some agents work better with WSL (Windows Subsystem for Linux), while others have native Windows support. + + + + Most agents work seamlessly on macOS. Claude Code and Cursor have the best native macOS integration. + + + + All agents have excellent Linux support. Command Line interface works particularly well in Linux environments. + + + +--- + + +**Need help choosing?** Check our [comparison table](/getting-started/agent-comparison) or join our [Discord community](https://discord.gg/taskmasterai) for personalized recommendations. + \ No newline at end of file diff --git a/apps/docs/getting-started/quick-start/quick-start.mdx b/apps/docs/getting-started/quick-start/quick-start.mdx index c1f44a16..b27ed849 100644 --- a/apps/docs/getting-started/quick-start/quick-start.mdx +++ b/apps/docs/getting-started/quick-start/quick-start.mdx @@ -5,7 +5,27 @@ sidebarTitle: "Quick Start" This guide is for new users who want to start using Task Master with minimal setup time. -It covers: +## 🎯 Choose Your AI Agent + +First, pick your preferred AI development environment: + + + + One-click install with native MCP support + + + No API keys needed - uses your Claude subscription + + + Maximum control and scriptability + + + +[View all AI agents β†’](/getting-started/ai-agents) + +## πŸ“‹ Quick Start Steps + +After setting up your AI agent, this guide covers: - [Requirements](/docs/getting-started/quick-start/requirements): You will need Node.js and an AI model API Key. - [Installation](/docs/getting-started/quick-start/installation): How to Install Task Master. - [Configuration](/docs/getting-started/quick-start/configuration-quick): Setting up your API Key, MCP, and more.