docs: add Windows-specific MCP installation instructions #1311
Conversation
- Add cmd /c configuration for Windows users without WSL - Include both .mcp.json configuration and claude mcp add command examples - Update README.md, apps/docs installation guide, and .taskmaster/CLAUDE.md - Addresses issue #1041 feedback from @myvaheed Co-authored-by: Ralph Khreish <[email protected]>
|
WalkthroughAdds Windows-specific MCP configuration and installation instructions across docs and Changes
Sequence Diagram(s)Not applicable — documentation-only changes; no code/control-flow modifications to diagram. Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes Possibly related issues
Possibly related PRs
Suggested reviewers
Pre-merge checks and finishing touches✅ Passed checks (3 passed)
✨ Finishing touches🧪 Generate unit tests (beta)
Comment |
|
@claude instead of having it in the readme, add it to apps/docs. Also, improve the getting started so a user can pick the ai agent he's using, then can see the instructions for that maybe ? with a cool logo and stuff ? |
|
Claude finished @Crunchyman-ralph's task —— View job Tasks:
✅ Enhanced Documentation CompleteI've successfully improved the documentation structure as requested: 🎯 What Was DoneRemoved from README:
Added to Apps/Docs:
Enhanced Getting Started:
🎨 Visual Improvements
🪟 Windows-Specific Enhancements
The documentation now provides a much better user experience where users can pick their preferred AI agent and get tailored setup instructions with visual guidance! |
- 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 <[email protected]>
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 6
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro
📒 Files selected for processing (3)
.taskmaster/CLAUDE.md(1 hunks)README.md(1 hunks)apps/docs/getting-started/quick-start/installation.mdx(1 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
{CLAUDE.md,.taskmaster/CLAUDE.md}
📄 CodeRabbit inference engine (CLAUDE.md)
Import Task Master's development workflow commands and guidelines, treating .taskmaster/CLAUDE.md as if it were included in the main CLAUDE.md
Files:
.taskmaster/CLAUDE.md
🧠 Learnings (13)
📚 Learning: 2025-09-24T15:12:58.855Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: assets/AGENTS.md:0-0
Timestamp: 2025-09-24T15:12:58.855Z
Learning: Applies to assets/**/.mcp.json : Configure the Task Master MCP server in .mcp.json under mcpServers.task-master-ai using npx task-master-ai and provide required API key env vars
Applied to files:
apps/docs/getting-started/quick-start/installation.mdx.taskmaster/CLAUDE.mdREADME.md
📚 Learning: 2025-07-18T17:11:36.732Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/mcp.mdc:0-0
Timestamp: 2025-07-18T17:11:36.732Z
Learning: If an MCP tool fails with unclear errors (like JSON parsing failures), run the equivalent task-master CLI command in the terminal to get more detailed error messages.
Applied to files:
apps/docs/getting-started/quick-start/installation.mdx.taskmaster/CLAUDE.mdREADME.md
📚 Learning: 2025-07-31T22:08:16.039Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to .taskmaster/config.json : Do not manually edit the .taskmaster/config.json file. Use the included commands either in the MCP or CLI format as needed. Always prioritize MCP tools when available and use the CLI as a fallback.
Applied to files:
apps/docs/getting-started/quick-start/installation.mdx.taskmaster/CLAUDE.mdREADME.md
📚 Learning: 2025-10-14T14:30:14.696Z
Learnt from: Crunchyman-ralph
PR: eyaltoledano/claude-task-master#1289
File: mcp-server/server.js:10-12
Timestamp: 2025-10-14T14:30:14.696Z
Learning: In MCP server implementations using stdio transport (like mcp-server/server.js), the TASK_MASTER_MCP environment variable must be forced to 'true' unconditionally to silence console output from tm-core, as any console.log/warn/error would corrupt the JSON-RPC protocol stream. This is not a user preference but a technical requirement for stdio-based MCP servers.
Applied to files:
apps/docs/getting-started/quick-start/installation.mdx.taskmaster/CLAUDE.mdREADME.md
📚 Learning: 2025-07-31T22:08:16.039Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to .taskmaster/config.json : All other Taskmaster settings (model choice, max tokens, temperature, log level, custom endpoints) are managed in .taskmaster/config.json via the task-master models command or models MCP tool.
Applied to files:
apps/docs/getting-started/quick-start/installation.mdx.taskmaster/CLAUDE.mdREADME.md
📚 Learning: 2025-07-31T22:08:16.039Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to .taskmaster/config.json : Do not manually edit the .taskmaster/config.json file; always use the provided CLI or MCP tools for configuration changes.
Applied to files:
apps/docs/getting-started/quick-start/installation.mdx.taskmaster/CLAUDE.mdREADME.md
📚 Learning: 2025-07-31T22:08:16.039Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to {.env,.cursor/mcp.json} : Set API keys for AI providers (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.) in your .env file in the project root (for CLI use) or within the env section of your .cursor/mcp.json file (for MCP/Cursor integration).
Applied to files:
apps/docs/getting-started/quick-start/installation.mdxREADME.md
📚 Learning: 2025-07-18T17:10:02.683Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/dev_workflow.mdc:0-0
Timestamp: 2025-07-18T17:10:02.683Z
Learning: Applies to {.env,.cursor/mcp.json} : Store sensitive API keys and endpoint URLs for Taskmaster in a `.env` file (for CLI usage) or in the `env` section of `.cursor/mcp.json` (for MCP/Cursor integration). Do not store non-API key settings in these files.
Applied to files:
apps/docs/getting-started/quick-start/installation.mdxREADME.md
📚 Learning: 2025-10-07T18:09:26.636Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-07T18:09:26.636Z
Learning: Applies to {CLAUDE.md,.taskmaster/CLAUDE.md} : Import Task Master's development workflow commands and guidelines, treating .taskmaster/CLAUDE.md as if it were included in the main CLAUDE.md
Applied to files:
.taskmaster/CLAUDE.md
📚 Learning: 2025-07-18T17:11:36.732Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/mcp.mdc:0-0
Timestamp: 2025-07-18T17:11:36.732Z
Learning: Applies to mcp-server/src/tools/*.js : MCP tools should always call *Direct wrappers instead of executeTaskMasterCommand, except as a fallback if a direct function is not yet implemented.
Applied to files:
.taskmaster/CLAUDE.md
📚 Learning: 2025-07-18T17:10:53.657Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/glossary.mdc:0-0
Timestamp: 2025-07-18T17:10:53.657Z
Learning: Comprehensive reference for Taskmaster MCP tools and CLI commands with tagged task lists information (taskmaster.mdc).
Applied to files:
.taskmaster/CLAUDE.md
📚 Learning: 2025-07-18T17:10:53.657Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/glossary.mdc:0-0
Timestamp: 2025-07-18T17:10:53.657Z
Learning: Guidelines for implementing and interacting with the Task Master MCP Server (mcp.mdc).
Applied to files:
.taskmaster/CLAUDE.md
📚 Learning: 2025-07-18T17:10:12.881Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/dev_workflow.mdc:0-0
Timestamp: 2025-07-18T17:10:12.881Z
Learning: For CLI usage, install Taskmaster globally with `npm install -g task-master-ai` or use locally via `npx task-master-ai ...`.
Applied to files:
.taskmaster/CLAUDE.md
🪛 LanguageTool
apps/docs/getting-started/quick-start/installation.mdx
[grammar] ~80-~80: Use correct spacing
Context: ...red. ### Windows-specific Configuration For Windows users without WSL, you may n...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~82-~82: Use correct spacing
Context: ...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", "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE", "XAI_API_KEY": "YOUR_XAI_KEY_HERE", "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE" } } } } Alternatively, you can install at the pr...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~105-~105: Use correct spacing
Context: ...l 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) ```json { ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
.taskmaster/CLAUDE.md
[grammar] ~105-~105: Use correct spacing
Context: ...out WSL, use this configuration instead: json { "mcpServers": { "task-master-ai": { "command": "cmd", "args": ["/c", "npx -y --package=task-master-ai task-master-ai"], "env": { "ANTHROPIC_API_KEY": "your_key_here", "PERPLEXITY_API_KEY": "your_key_here", "OPENAI_API_KEY": "OPENAI_API_KEY_HERE", "GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE", "XAI_API_KEY": "XAI_API_KEY_HERE", "OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE", "MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE", "AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE", "OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE" } } } } Or install at the project level with Cla...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~129-~129: Use correct spacing
Context: ...l 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" ### Essential MCP Tools ```javascript help;...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
README.md
[grammar] ~127-~127: Use correct spacing
Context: .... ###### Windows-specific Configuration For Windows users without WSL, you may n...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~129-~129: Use correct spacing
Context: ...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 pr...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~154-~154: There might be a problem here.
Context: ...l 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) ```json { "serv...
(QB_NEW_EN_MERGED_MATCH)
🪛 markdownlint-cli2 (0.18.1)
.taskmaster/CLAUDE.md
130-130: Fenced code blocks should be surrounded by blank lines
(MD031, blanks-around-fences)
README.md
130-130: Fenced code blocks should be surrounded by blank lines
(MD031, blanks-around-fences)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
- GitHub Check: Test
| For Windows users without WSL, use this configuration instead: | ||
|
|
||
| ```json | ||
| { | ||
| "mcpServers": { | ||
| "task-master-ai": { | ||
| "command": "cmd", | ||
| "args": ["/c", "npx -y --package=task-master-ai task-master-ai"], | ||
| "env": { | ||
| "ANTHROPIC_API_KEY": "your_key_here", | ||
| "PERPLEXITY_API_KEY": "your_key_here", | ||
| "OPENAI_API_KEY": "OPENAI_API_KEY_HERE", | ||
| "GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE", | ||
| "XAI_API_KEY": "XAI_API_KEY_HERE", | ||
| "OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE", | ||
| "MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE", | ||
| "AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE", | ||
| "OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` |
There was a problem hiding this comment.
Windows JSON looks good; minor consistency nit
- Placeholders differ from other docs (“your_key_here” vs “YOUR_…_HERE”). Consider unifying for consistency.
- You can note users may remove unused keys.
🧰 Tools
🪛 LanguageTool
[grammar] ~105-~105: Use correct spacing
Context: ...out WSL, use this configuration instead: json { "mcpServers": { "task-master-ai": { "command": "cmd", "args": ["/c", "npx -y --package=task-master-ai task-master-ai"], "env": { "ANTHROPIC_API_KEY": "your_key_here", "PERPLEXITY_API_KEY": "your_key_here", "OPENAI_API_KEY": "OPENAI_API_KEY_HERE", "GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE", "XAI_API_KEY": "XAI_API_KEY_HERE", "OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE", "MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE", "AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE", "OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE" } } } } Or install at the project level with Cla...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
🤖 Prompt for AI Agents
In .taskmaster/CLAUDE.md around lines 105 to 127, the Windows JSON example uses
"your_key_here" placeholders that are inconsistent with other docs' ALL_CAPS
placeholders; update all placeholder values to the same format (e.g.,
"OPENAI_API_KEY_HERE", "ANTHROPIC_API_KEY_HERE", etc.) to match existing
convention and add a short single-line note after the JSON indicating users may
remove unused keys; keep wording consistent and minimal.
| Or 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" | ||
| ``` | ||
|
|
There was a problem hiding this comment.
🧹 Nitpick | 🔵 Trivial
Fix server name and satisfy markdownlint MD031 around fenced block
- Use the same server name everywhere. Elsewhere you reference task-master-ai, but here you add task-master-mcp.
- Add a blank line before the fenced block to satisfy MD031.
Apply:
-Or 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"
-```
+Or install at the project level with Claude Code:
+
+```bash
+claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+```🧰 Tools
🪛 LanguageTool
[grammar] ~129-~129: Use correct spacing
Context: ...l 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" ### Essential MCP Tools ```javascript help;...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
🪛 markdownlint-cli2 (0.18.1)
130-130: Fenced code blocks should be surrounded by blank lines
(MD031, blanks-around-fences)
🤖 Prompt for AI Agents
In .taskmaster/CLAUDE.md around lines 129 to 133, the snippet uses the wrong
server name and violates markdownlint MD031; update the command to use the
consistent server name "task-master-ai" (replace "task-master-mcp"), and insert
a blank line immediately before the fenced code block so there is an empty line
between the preceding paragraph and the ```bash block; ensure the fenced block
remains triple-backticked and the command text itself is unchanged except for
the server name.
| ### 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", | ||
| "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE", | ||
| "XAI_API_KEY": "YOUR_XAI_KEY_HERE", | ||
| "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` |
There was a problem hiding this comment.
🧹 Nitpick | 🔵 Trivial
Add missing OLLAMA key for parity; verify server key name consistency on this page
- Env list here omits OLLAMA_API_KEY; other docs include it. Add for consistency.
- Elsewhere on this page, the non-Windows block uses "taskmaster-ai" (no hyphen) as the server key, while this block uses "task-master-ai". Consider unifying to "task-master-ai" across the page to avoid confusion.
"XAI_API_KEY": "YOUR_XAI_KEY_HERE",
- "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE"
+ "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
+ "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| ### 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", | |
| "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE", | |
| "XAI_API_KEY": "YOUR_XAI_KEY_HERE", | |
| "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE" | |
| } | |
| } | |
| } | |
| } | |
| ``` | |
| "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", | |
| "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE", | |
| "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE" | |
| } |
🧰 Tools
🪛 LanguageTool
[grammar] ~80-~80: Use correct spacing
Context: ...red. ### Windows-specific Configuration For Windows users without WSL, you may n...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~82-~82: Use correct spacing
Context: ...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", "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE", "XAI_API_KEY": "YOUR_XAI_KEY_HERE", "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE" } } } } Alternatively, you can install at the pr...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
🤖 Prompt for AI Agents
In apps/docs/getting-started/quick-start/installation.mdx around lines 80 to
103, the Windows-specific env block is missing OLLAMA_API_KEY and the MCP server
key differs from other blocks ("task-master-ai" here vs "taskmaster-ai"
elsewhere); add an "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE" entry to the env
map and make the server key name consistent across the page by standardizing all
occurrences to "task-master-ai" (or update this block to match whichever
canonical name you choose) so the examples are uniform.
| 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" | ||
| ``` |
There was a problem hiding this comment.
🧹 Nitpick | 🔵 Trivial
Rename server in install command and add blank line before fence (MD031)
- Use task-master-ai to match the JSON key and other docs.
- Add a blank line before the bash fence.
-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"
-```
+Alternatively, you can install at the project level with Claude Code:
+
+```bash
+claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+```🧰 Tools
🪛 LanguageTool
[grammar] ~105-~105: Use correct spacing
Context: ...l 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) ```json { ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
🤖 Prompt for AI Agents
In apps/docs/getting-started/quick-start/installation.mdx around lines 105 to
108, the install command uses the wrong server name and is missing a blank line
before the bash fence; rename the server from task-master-mcp to task-master-ai
to match the JSON key and other docs, and add a blank line before the opening
```bash fence so the code block is properly separated from the preceding
paragraph.
README.md
Outdated
| ###### 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" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` |
There was a problem hiding this comment.
LGTM; consistent with Cursor/Windsurf examples
Windows JSON block matches prior examples and includes GROQ/OLLAMA.
Minor: consider adding a line noting users can remove unused keys.
🧰 Tools
🪛 LanguageTool
[grammar] ~127-~127: Use correct spacing
Context: .... ###### Windows-specific Configuration For Windows users without WSL, you may n...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~129-~129: Use correct spacing
Context: ...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 pr...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
🪛 markdownlint-cli2 (0.18.1)
130-130: Fenced code blocks should be surrounded by blank lines
(MD031, blanks-around-fences)
🤖 Prompt for AI Agents
In README.md around lines 127 to 152, add a brief sentence after the
Windows-specific JSON example stating that users can remove any unused API key
entries from the sample env object (to avoid confusion and clutter); update the
text to be a single-line note clarifying they only need to supply the keys
relevant to their setup.
README.md
Outdated
| 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" | ||
| ``` | ||
|
|
There was a problem hiding this comment.
🧹 Nitpick | 🔵 Trivial
Unify server name and wrap code fence with blank lines (MD031)
- Align server name with the rest of the docs (task-master-ai).
- Add a blank line before the fenced block.
-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"
-```
+Alternatively, you can install at the project level with Claude Code:
+
+```bash
+claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+```🧰 Tools
🪛 LanguageTool
[grammar] ~154-~154: There might be a problem here.
Context: ...l 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) ```json { "serv...
(QB_NEW_EN_MERGED_MATCH)
🤖 Prompt for AI Agents
In README.md around lines 154-158, the code block lacks a blank line above it
and uses the wrong server name; change the prior paragraph so there is a blank
line immediately before the fenced block and update the command to use
task-master-ai instead of task-master-mcp (i.e., replace "claude mcp add
task-master-mcp -s project -- cmd /c \"npx -y --package=task-master-ai
task-master-ai\"" with "claude mcp add task-master-ai -s project -- cmd /c \"npx
-y --package=task-master-ai task-master-ai\"" and ensure the fenced block begins
on its own line after an empty line).
There was a problem hiding this comment.
Actionable comments posted: 2
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro
📒 Files selected for processing (6)
README.md(1 hunks)apps/docs/getting-started/agents/claude-code.mdx(1 hunks)apps/docs/getting-started/agents/cli.mdx(1 hunks)apps/docs/getting-started/agents/cursor.mdx(1 hunks)apps/docs/getting-started/ai-agents.mdx(1 hunks)apps/docs/getting-started/quick-start/quick-start.mdx(1 hunks)
🧰 Additional context used
🧠 Learnings (5)
📚 Learning: 2025-07-31T22:08:16.039Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to .cursor/mcp.json : When using MCP/Cursor integration, ensure that the required API keys are present in the env section of .cursor/mcp.json.
Applied to files:
apps/docs/getting-started/agents/cursor.mdx
📚 Learning: 2025-10-07T18:09:26.636Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-07T18:09:26.636Z
Learning: Applies to {CLAUDE.md,.taskmaster/CLAUDE.md} : Import Task Master's development workflow commands and guidelines, treating .taskmaster/CLAUDE.md as if it were included in the main CLAUDE.md
Applied to files:
apps/docs/getting-started/agents/claude-code.mdx
📚 Learning: 2025-07-18T17:10:53.657Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/glossary.mdc:0-0
Timestamp: 2025-07-18T17:10:53.657Z
Learning: Guidelines for integrating new features into the Task Master CLI with tagged system considerations (new_features.mdc).
Applied to files:
apps/docs/getting-started/agents/cli.mdx
📚 Learning: 2025-07-18T17:10:12.881Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/dev_workflow.mdc:0-0
Timestamp: 2025-07-18T17:10:12.881Z
Learning: For CLI usage, install Taskmaster globally with `npm install -g task-master-ai` or use locally via `npx task-master-ai ...`.
Applied to files:
apps/docs/getting-started/agents/cli.mdxapps/docs/getting-started/quick-start/quick-start.mdx
📚 Learning: 2025-09-24T15:12:12.658Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: assets/.windsurfrules:0-0
Timestamp: 2025-09-24T15:12:12.658Z
Learning: Start new projects with task-master init or parse a PRD via task-master parse-prd --input=<file> to generate an initial tasks.json
Applied to files:
apps/docs/getting-started/agents/cli.mdx
🪛 LanguageTool
apps/docs/getting-started/agents/cursor.mdx
[grammar] ~14-~14: Use correct spacing
Context: ...installation and native MCP integration. ## 🚀 One-Click Install (Recommended) <div...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~16-~16: There might be a mistake here.
Context: .... ## 🚀 One-Click Install (Recommended)
Fastest Setup
(QB_NEW_EN)
[grammar] ~44-~44: There might be a mistake here.
Context: ...replaced. ## 📋 Manual Setup If you prefer manual configuration or th...
(QB_NEW_EN)
[grammar] ~46-~46: Use correct spacing
Context: ...n or the one-click install doesn't work: ### Step 1: Create MCP Configuration Choose...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~48-~48: Use correct spacing
Context: ...k: ### Step 1: Create MCP Configuration Choose your configuration scope: ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~50-~50: Use correct spacing
Context: ...ration 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 Curso...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~124-~124: Use correct spacing
Context: ...> ### Step 2: Enable MCP Server 1. Open Cursor Settings (Ctrl+Shift+J or ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~126-~126: There might be a mistake here.
Context: ...ttings (Ctrl+Shift+J or Cmd+Shift+J) 2. Click the MCP tab in the left sideba...
(QB_NEW_EN_OTHER)
[grammar] ~127-~127: There might be a mistake here.
Context: ...lick the MCP tab in the left sidebar 3. Find task-master-ai and toggle it **ON...
(QB_NEW_EN_OTHER)
[grammar] ~128-~128: Use proper capitalization
Context: ...Find task-master-ai and toggle it ON 4. Restart Cursor if needed ### Step 3: Ve...
(QB_NEW_EN_OTHER_ERROR_IDS_6)
[grammar] ~129-~129: There might be a mistake here.
Context: ...le it ON 4. Restart Cursor if needed ### Step 3: Verify Installation In Cursor's...
(QB_NEW_EN_OTHER)
[grammar] ~131-~131: Use correct spacing
Context: ... needed ### Step 3: Verify Installation In Cursor's chat panel, type: ``` help `...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~133-~133: Use correct spacing
Context: ...tallation In Cursor's chat panel, type: help You should see Task Master commands avai...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~138-~138: There might be a mistake here.
Context: ...commands available. If you see "0 tools enabled", check your API keys and restart Cursor....
(QB_NEW_EN_OTHER)
[grammar] ~138-~138: Use correct spacing
Context: ... check your API keys and restart Cursor. ## 🔧 Configuration ### Add Your API Keys ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~140-~140: There might be a mistake here.
Context: ...and restart Cursor. ## 🔧 Configuration ### Add Your API Keys <Tab title="...
(QB_NEW_EN)
[grammar] ~142-~142: Use correct spacing
Context: ... 🔧 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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~172-~172: Use correct spacing
Context: ... ### Configure Models (Optional) In Cursor's chat, set your preferred mod...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~174-~174: Use correct spacing
Context: ...ursor'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 Ta...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~180-~180: There might be a mistake here.
Context: ...respectively. ``` ## 🎯 Getting Started ### 1. Initialize Task Master In Cursor's c...
(QB_NEW_EN)
[grammar] ~182-~182: Use correct spacing
Context: ...g Started ### 1. Initialize Task Master In Cursor's chat panel: ``` Initialize t...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~184-~184: Use correct spacing
Context: ...ize Task Master In Cursor's chat panel: Initialize taskmaster-ai in my project ### 2. Create Your First Task ``` Can you h...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~189-~189: Use correct spacing
Context: ...oject ### 2. Create Your First Task Can you help me implement user authentication for my web app? ### 3. Start Working What's the next ta...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~195-~195: Use correct spacing
Context: ...or my web app? ### 3. Start Working What's the next task I should work on? ``` ## 🔍 Troubleshooting <Accordion title="0 ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~201-~201: There might be a mistake here.
Context: ...ould 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-specifi...
(QB_NEW_EN)
[grammar] ~223-~223: There might be a mistake here.
Context: ...or 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.
(QB_NEW_EN)
apps/docs/getting-started/ai-agents.mdx
[grammar] ~6-~6: Use correct spacing
Context: ...nt to get customized setup instructions.
AI-powered VS Code fork with built-in MCP support (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~20-~20: There might be a mistake here.
Context: ...rt <Card title="Claude Code" icon="claude" ...
(QB_NEW_EN)
[grammar] ~21-~21: There might be a mistake here.
Context: ...Card> <Card title="Claude Code" icon="claude" href="/getting-starte...
(QB_NEW_EN)
[grammar] ~22-~22: There might be a mistake here.
Context: ... title="Claude Code" icon="claude" href="/getting-started/agents/claude-cod...
(QB_NEW_EN)
[grammar] ~23-~23: Use correct spacing
Context: ...ef="/getting-started/agents/claude-code" >
Anthropic's official CLI for Claude (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~31-~31: There might be a mistake here.
Context: ...de <Card title="Windsurf" icon="windsurf" ...
(QB_NEW_EN)
[grammar] ~32-~32: There might be a mistake here.
Context: ... <Card title="Windsurf" icon="windsurf" href="/getting-star...
(QB_NEW_EN)
[grammar] ~33-~33: There might be a mistake here.
Context: ... title="Windsurf" icon="windsurf" href="/getting-started/agents/windsurf" ...
(QB_NEW_EN)
[grammar] ~34-~34: Use correct spacing
Context: ... href="/getting-started/agents/windsurf" >
Codeium's AI-native IDE (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~42-~42: There might be a mistake here.
Context: ...DE <Card title="VS Code" icon="vscode" ...
(QB_NEW_EN)
[grammar] ~43-~43: There might be a mistake here.
Context: ... <Card title="VS Code" icon="vscode" href="/getting-starte...
(QB_NEW_EN)
[grammar] ~44-~44: There might be a mistake here.
Context: ... title="VS Code" icon="vscode" href="/getting-started/agents/vscode" ...
(QB_NEW_EN)
[grammar] ~45-~45: Use correct spacing
Context: ... href="/getting-started/agents/vscode" >
Microsoft's editor with MCP extensions (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~53-~53: There might be a mistake here.
Context: ...ns <Card title="Command Line" icon="terminal...
(QB_NEW_EN)
[grammar] ~54-~54: There might be a mistake here.
Context: ...ard> <Card title="Command Line" icon="terminal" href="/getting-star...
(QB_NEW_EN)
[grammar] ~55-~55: There might be a mistake here.
Context: ...tle="Command Line" icon="terminal" href="/getting-started/agents/cli" > ...
(QB_NEW_EN)
[grammar] ~56-~56: Use correct spacing
Context: ... href="/getting-started/agents/cli" >
Direct CLI usage without IDE integration (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~64-~64: There might be a mistake here.
Context: ...on <Card title="Other Agents" icon="question...
(QB_NEW_EN)
[grammar] ~65-~65: There might be a mistake here.
Context: ...ard> <Card title="Other Agents" icon="question" href="/getting-star...
(QB_NEW_EN)
[grammar] ~66-~66: There might be a mistake here.
Context: ...tle="Other Agents" icon="question" href="/getting-started/agents/other" >...
(QB_NEW_EN)
[grammar] ~67-~67: Use correct spacing
Context: ... href="/getting-started/agents/other" >
Generic setup for other AI agents (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~76-~76: Use correct spacing
Context: ...> ## Quick Recommendations For beginners: Start with Cursor - it has the most seamless MCP integration and one-click install. For Claude users: Use Claude Code ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[typographical] ~81-~81: To join two clauses or set off examples, consider using an em dash.
Context: ... For Claude users: Use Claude Code - it's Anthropic's official CLI with no API ke...
(QB_NEW_EN_DASH_RULE_EM)
[grammar] ~81-~81: Use correct spacing
Context: ...s official CLI with no API key required. For existing VS Code users: Stick with...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~83-~83: Use correct spacing
Context: ...'re already comfortable with your setup. For advanced users: Try Windsurf f...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[style] ~85-~85: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...already comfortable with your setup. For advanced users: Try Windsurf for ...
(ENGLISH_WORD_REPEAT_BEGINNING_RULE)
[grammar] ~85-~85: Use correct spacing
Context: ...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 <Tab t...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~96-~96: Use correct spacing
Context: ... ## 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 or join our Discord community for personalized recommendations.
(QB_NEW_EN_OTHER_ERROR_IDS_5)
apps/docs/getting-started/agents/claude-code.mdx
[grammar] ~14-~14: Use correct spacing
Context: ...y setup** and direct Claude integration. ## 🎯 Why Choose Claude Code? <div classNa...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~16-~16: There might be a mistake here.
Context: ...egration. ## 🎯 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
(QB_NEW_EN)
[grammar] ~29-~29: There might be a mistake here.
Context: ...
(QB_NEW_EN)
[grammar] ~31-~31: Use correct spacing
Context: ...llation ### Step 1: Install Claude Code Follow the [official Claude Code install...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~33-~33: Use correct spacing
Context: ...ocs/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 ```bas...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~71-~71: Use correct spacing
Context: ...s> ### Step 2: Authenticate with Claude bash # Login to your Claude account claude auth login Follow the prompts to authenticate with ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~78-~78: Use correct spacing
Context: ...uthenticate with your Anthropic account. ## 🔧 Task Master Integration ### Method 1...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~80-~80: There might be a mistake here.
Context: ... account. ## 🔧 Task Master Integration ### Method 1: MCP Integration (Recommended) ...
(QB_NEW_EN)
[grammar] ~82-~82: Use correct spacing
Context: ... Method 1: MCP Integration (Recommended) Add Task Master to your Claude Code MCP ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~84-~84: Use correct spacing
Context: ...r 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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~109-~109: Use correct spacing
Context: ... ### Method 2: Direct CLI Usage You can also use Task Master commands di...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~111-~111: Use correct spacing
Context: ...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 Yo...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~125-~125: There might be a mistake here.
Context: ...r-ai show 1.2 ``` ## 🚀 Getting Started ### 1. Initialize Your Project In your proj...
(QB_NEW_EN)
[grammar] ~127-~127: Use correct spacing
Context: ... Started ### 1. Initialize Your Project In your project directory: ```bash # St...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~129-~129: Use correct spacing
Context: ...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 Cl...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~139-~139: Use correct spacing
Context: ... ``` ### 2. Configure Models (Optional) Since Claude Code doesn't need API keys,...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~141-~141: Use correct spacing
Context: ...keys, you can use it as your main model: Change the main model to claude-code/sonnet Available Claude Code models: - `claude-...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~147-~147: Use correct spacing
Context: ...onnet ``` Available Claude Code models: - claude-code/sonnet - Claude 3.5 Sonnet (recommended) - `cla...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~148-~148: Use correct spacing
Context: ...onnet- Claude 3.5 Sonnet (recommended) -claude-code/opus` - Claude 3 Opus (for complex tasks) ###...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~149-~149: Use correct spacing
Context: ...pus` - Claude 3 Opus (for complex tasks) ### 3. Create Your First Tasks ``` Can you ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~151-~151: Use correct spacing
Context: ...x tasks) ### 3. Create Your First Tasks Can you parse my PRD and create tasks for building a todo app? ## 💡 Advanced Configuration ### Hybrid Se...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~157-~157: There might be a mistake here.
Context: ...o app? ``` ## 💡 Advanced Configuration ### Hybrid Setup Use Claude Code as your ma...
(QB_NEW_EN)
[grammar] ~159-~159: Use correct spacing
Context: ...Advanced Configuration ### Hybrid Setup Use Claude Code as your main model with ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~161-~161: Use correct spacing
Context: ...main model with other APIs for research: Create .env in your project: ```bash #...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~163-~163: Use correct spacing
Context: ...esearch: 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 ma...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~170-~170: Use correct spacing
Context: ...nai_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 exc...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~175-~175: Use correct spacing
Context: ...-online ``` ### Multi-Session Workflows Claude Code excels at parallel developme...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~177-~177: Use correct spacing
Context: ...ude 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 conte...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~190-~190: Use correct spacing
Context: ...ext while allowing focused work streams. ## 🔍 Troubleshooting <Accordion title="Cl...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~192-~192: There might be a mistake here.
Context: ...sed 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...
(QB_NEW_EN)
[grammar] ~222-~222: There might be a mistake here.
Context: ...or 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 Workf...
(QB_NEW_EN)
[grammar] ~236-~236: There might be a mistake here.
Context: ...t sessions. ## 🎯 Best Practices ### Development Workflow ```bash # Morning ...
(QB_NEW_EN)
[grammar] ~238-~238: Use correct spacing
Context: ...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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~252-~252: Use correct spacing
Context: ... 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.
(QB_NEW_EN_OTHER_ERROR_IDS_5)
apps/docs/getting-started/agents/cli.mdx
[grammar] ~14-~14: Use correct spacing
Context: ...ine for maximum flexibility and control. ## 🎯 Why Choose CLI? <div className="grid...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~16-~16: There might be a mistake here.
Context: ...lity 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
(QB_NEW_EN)
[grammar] ~37-~37: There might be a mistake here.
Context: ...
(QB_NEW_EN)
[grammar] ~39-~39: Use correct spacing
Context: ...n ### Global Installation (Recommended) bash # Install Task Master globally npm install -g task-master-ai # Verify installation task-master --version ### Local Installation ```bash # Install in...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~49-~49: Use correct spacing
Context: ...er --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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~59-~59: There might be a mistake here.
Context: ...er-ai --version ``` ## 🔧 Configuration ### Step 1: Set Up API Keys Create a .env...
(QB_NEW_EN)
[grammar] ~61-~61: Use correct spacing
Context: ...nfiguration ### Step 1: Set Up API Keys Create a .env file in your project roo...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~63-~63: Use correct spacing
Context: ...eate 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 # Inte...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~78-~78: Use correct spacing
Context: ...y_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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~90-~90: Use correct spacing
Context: ... ### 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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~100-~100: There might be a mistake here.
Context: ...surf,vscode ## 🚀 Quick Start Guide ### 1. Create Your PRD bash # Create a P...
(QB_NEW_EN)
[grammar] ~102-~102: Use correct spacing
Context: ...uick 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 ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~114-~114: Use correct spacing
Context: .../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 task...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~127-~127: Use correct spacing
Context: ...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 Manageme...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~143-~143: There might be a mistake here.
Context: ...n-progress ## 📋 Essential Commands ### Task Management bash # List all task...
(QB_NEW_EN)
[grammar] ~145-~145: Use correct spacing
Context: ... 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 t...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~167-~167: Use correct spacing
Context: ...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 # Researc...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~180-~180: Use correct spacing
Context: ...s=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 #...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~196-~196: Use correct spacing
Context: ...e ### 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 Aut...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~212-~212: There might be a mistake here.
Context: ...aster generate ``` ## 🎯 Advanced Usage ### Scripting and Automation Create shell s...
(QB_NEW_EN)
[grammar] ~214-~214: Use correct spacing
Context: ...nced Usage ### Scripting and Automation Create shell scripts for common workflow...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~216-~216: Use correct spacing
Context: ...eate 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/wor...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~235-~235: Use correct spacing
Context: ...lexity-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 `.bash...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~262-~262: Use correct spacing
Context: ...task-report.json ``` ### Custom Aliases Add these to your .bashrc or `.zshrc`:...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~264-~264: Use correct spacing
Context: ...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 <Accordion title="Co...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~275-~275: There might be a mistake here.
Context: ...-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` fl...
(QB_NEW_EN)
[grammar] ~309-~309: There might be a mistake here.
Context: ...directory </Accordion> ## 💡 Pro Tips <Tip> **Use--researchflag** with AI commands for more informed and up-to-date task suggestions based on current best practices. </Tip> <Tip> **Create project templates** with pre-configured.taskmasterdirectories for different types of projects (web apps, APIs, mobile apps). </Tip> <Tip> **Combine with other tools** likejqfor parsing JSON outputs:task-master list --json | jq '.[] | select(.status=="pending")'</Tip> <Tip> **Use environment-specific configs** by creating different.env` files (.env.development, .env.production) and symlinking as needed. ## 📚 Integration Examples ### With Git Ho...
(QB_NEW_EN)
[grammar] ~327-~327: There might be a mistake here.
Context: ...eded. ## 📚 Integration Examples ### With Git Hooks ```bash #!/bin/sh # .git...
(QB_NEW_EN)
[grammar] ~329-~329: Use correct spacing
Context: ...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 .PHON...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~342-~342: Use correct spacing
Context: ...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.
(QB_NEW_EN_OTHER_ERROR_IDS_5)
apps/docs/getting-started/quick-start/quick-start.mdx
[grammar] ~8-~8: There might be a mistake here.
Context: ... setup time. ## 🎯 Choose Your AI Agent First, pick your preferred AI developmen...
(QB_NEW_EN)
[grammar] ~10-~10: Use correct spacing
Context: ...ur 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/a...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~24-~24: Use correct spacing
Context: ...ard> View all AI agents → ## 📋 Quick Start Steps After setting up y...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~26-~26: There might be a mistake here.
Context: ...rted/ai-agents) ## 📋 Quick Start Steps After setting up your AI agent, this gui...
(QB_NEW_EN)
[grammar] ~28-~28: There might be a mistake here.
Context: ...er setting up your AI agent, this guide covers: - [Requirements](/docs/getting-started/quick-start/requ...
(QB_NEW_EN_OTHER)
| # Windows-specific command | ||
| claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" | ||
| ``` |
There was a problem hiding this comment.
Use the same MCP server name across all instructions
Here the Windows command adds a server named task-master-mcp, but the surrounding guidance (and other docs) refer to task-master-ai. That mismatch leaves users unable to toggle the server after installation. Please switch the name to task-master-ai.
- claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+ claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| # Windows-specific command | |
| claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" | |
| ``` | |
| # Windows-specific command | |
| claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" |
🤖 Prompt for AI Agents
In apps/docs/getting-started/agents/claude-code.mdx around lines 103 to 105, the
Windows-specific command uses the server name "task-master-mcp" while the rest
of the docs reference "task-master-ai", causing a mismatch; update the Windows
command to use "task-master-ai" as the MCP server name so it matches the other
instructions and allows users to toggle the same server after installation.
| ```bash | ||
| claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" | ||
| ``` |
There was a problem hiding this comment.
Align the Claude command with the documented server name
This Windows command registers the server as task-master-mcp, but everywhere else (including the enable step) expects task-master-ai. Users following this flow won't find the server to toggle, so the setup fails. Please rename the server here to task-master-ai.
- claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+ claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| ```bash | |
| claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" | |
| ``` |
🤖 Prompt for AI Agents
In apps/docs/getting-started/agents/cursor.mdx around lines 117 to 119, the
Windows Claude registration command uses the server name task-master-mcp which
is inconsistent with the rest of the docs that expect task-master-ai; update the
command to register the server as task-master-ai so it matches the enable/toggle
steps and users can find the server.
There was a problem hiding this comment.
Actionable comments posted: 2
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro
📒 Files selected for processing (6)
README.md(1 hunks)apps/docs/getting-started/agents/claude-code.mdx(1 hunks)apps/docs/getting-started/agents/cli.mdx(1 hunks)apps/docs/getting-started/agents/cursor.mdx(1 hunks)apps/docs/getting-started/ai-agents.mdx(1 hunks)apps/docs/getting-started/quick-start/quick-start.mdx(1 hunks)
🧰 Additional context used
🧠 Learnings (7)
📓 Common learnings
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-07T18:09:26.636Z
Learning: Applies to {CLAUDE.md,.taskmaster/CLAUDE.md} : Import Task Master's development workflow commands and guidelines, treating .taskmaster/CLAUDE.md as if it were included in the main CLAUDE.md
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: assets/AGENTS.md:0-0
Timestamp: 2025-09-24T15:12:58.855Z
Learning: Applies to assets/**/.mcp.json : Configure the Task Master MCP server in .mcp.json under mcpServers.task-master-ai using npx task-master-ai and provide required API key env vars
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to .taskmaster/config.json : Do not manually edit the .taskmaster/config.json file. Use the included commands either in the MCP or CLI format as needed. Always prioritize MCP tools when available and use the CLI as a fallback.
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: assets/AGENTS.md:0-0
Timestamp: 2025-09-24T15:12:58.855Z
Learning: Applies to assets/.claude/settings.json : Include the recommended tool allowlist in .claude/settings.json (Edit, Bash(task-master *), Bash(git commit:*), Bash(git add:*), Bash(npm run *), mcp__task_master_ai__*)
📚 Learning: 2025-07-18T17:10:12.881Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/dev_workflow.mdc:0-0
Timestamp: 2025-07-18T17:10:12.881Z
Learning: For CLI usage, install Taskmaster globally with `npm install -g task-master-ai` or use locally via `npx task-master-ai ...`.
Applied to files:
apps/docs/getting-started/agents/cli.mdxapps/docs/getting-started/quick-start/quick-start.mdx
📚 Learning: 2025-09-24T15:12:12.658Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: assets/.windsurfrules:0-0
Timestamp: 2025-09-24T15:12:12.658Z
Learning: Start new projects with task-master init or parse a PRD via task-master parse-prd --input=<file> to generate an initial tasks.json
Applied to files:
apps/docs/getting-started/agents/cli.mdx
📚 Learning: 2025-10-07T18:09:26.636Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-07T18:09:26.636Z
Learning: Applies to {CLAUDE.md,.taskmaster/CLAUDE.md} : Import Task Master's development workflow commands and guidelines, treating .taskmaster/CLAUDE.md as if it were included in the main CLAUDE.md
Applied to files:
apps/docs/getting-started/agents/claude-code.mdx
📚 Learning: 2025-07-31T22:08:16.039Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/taskmaster.mdc:0-0
Timestamp: 2025-07-31T22:08:16.039Z
Learning: Applies to .cursor/mcp.json : When using MCP/Cursor integration, ensure that the required API keys are present in the env section of .cursor/mcp.json.
Applied to files:
apps/docs/getting-started/agents/cursor.mdx
📚 Learning: 2025-07-18T17:12:57.903Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/new_features.mdc:0-0
Timestamp: 2025-07-18T17:12:57.903Z
Learning: Applies to .cursor/rules/*.mdc : Update relevant '.cursor/rules/*.mdc' files and include tagged system considerations in architecture docs when adding new features.
Applied to files:
apps/docs/getting-started/agents/cursor.mdx
📚 Learning: 2025-07-18T17:06:04.909Z
Learnt from: CR
PR: eyaltoledano/claude-task-master#0
File: .cursor/rules/ai_providers.mdc:0-0
Timestamp: 2025-07-18T17:06:04.909Z
Learning: Applies to .cursor/mcp.json.example : Add the new PROVIDER_API_KEY with its placeholder to the env section for taskmaster-ai in .cursor/mcp.json.example.
Applied to files:
apps/docs/getting-started/agents/cursor.mdx
🪛 LanguageTool
apps/docs/getting-started/agents/cli.mdx
[grammar] ~14-~14: Use correct spacing
Context: ...ine for maximum flexibility and control. ## 🎯 Why Choose CLI? <div className="grid...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~16-~16: There might be a mistake here.
Context: ...lity 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
(QB_NEW_EN)
[grammar] ~37-~37: There might be a mistake here.
Context: ...
(QB_NEW_EN)
[grammar] ~39-~39: Use correct spacing
Context: ...n ### Global Installation (Recommended) bash # Install Task Master globally npm install -g task-master-ai # Verify installation task-master --version ### Local Installation ```bash # Install in...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~49-~49: Use correct spacing
Context: ...er --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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~59-~59: There might be a mistake here.
Context: ...er-ai --version ``` ## 🔧 Configuration ### Step 1: Set Up API Keys Create a .env...
(QB_NEW_EN)
[grammar] ~61-~61: Use correct spacing
Context: ...nfiguration ### Step 1: Set Up API Keys Create a .env file in your project roo...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~63-~63: Use correct spacing
Context: ...eate 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 # Inte...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~78-~78: Use correct spacing
Context: ...y_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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~90-~90: Use correct spacing
Context: ... ### 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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~100-~100: There might be a mistake here.
Context: ...surf,vscode ## 🚀 Quick Start Guide ### 1. Create Your PRD bash # Create a P...
(QB_NEW_EN)
[grammar] ~102-~102: Use correct spacing
Context: ...uick 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 ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~114-~114: Use correct spacing
Context: .../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 task...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~127-~127: Use correct spacing
Context: ...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 Manageme...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~143-~143: There might be a mistake here.
Context: ...n-progress ## 📋 Essential Commands ### Task Management bash # List all task...
(QB_NEW_EN)
[grammar] ~145-~145: Use correct spacing
Context: ... 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 t...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~167-~167: Use correct spacing
Context: ...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 # Researc...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~180-~180: Use correct spacing
Context: ...s=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 #...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~196-~196: Use correct spacing
Context: ...e ### 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 Aut...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~212-~212: There might be a mistake here.
Context: ...aster generate ``` ## 🎯 Advanced Usage ### Scripting and Automation Create shell s...
(QB_NEW_EN)
[grammar] ~214-~214: Use correct spacing
Context: ...nced Usage ### Scripting and Automation Create shell scripts for common workflow...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~216-~216: Use correct spacing
Context: ...eate 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/wor...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~235-~235: Use correct spacing
Context: ...lexity-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 `.bash...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~262-~262: Use correct spacing
Context: ...task-report.json ``` ### Custom Aliases Add these to your .bashrc or `.zshrc`:...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~264-~264: Use correct spacing
Context: ...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 <Accordion title="Co...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~275-~275: There might be a mistake here.
Context: ...-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` fl...
(QB_NEW_EN)
[grammar] ~309-~309: There might be a mistake here.
Context: ...directory </Accordion> ## 💡 Pro Tips <Tip> **Use--researchflag** with AI commands for more informed and up-to-date task suggestions based on current best practices. </Tip> <Tip> **Create project templates** with pre-configured.taskmasterdirectories for different types of projects (web apps, APIs, mobile apps). </Tip> <Tip> **Combine with other tools** likejqfor parsing JSON outputs:task-master list --json | jq '.[] | select(.status=="pending")'</Tip> <Tip> **Use environment-specific configs** by creating different.env` files (.env.development, .env.production) and symlinking as needed. ## 📚 Integration Examples ### With Git Ho...
(QB_NEW_EN)
[grammar] ~327-~327: There might be a mistake here.
Context: ...eded. ## 📚 Integration Examples ### With Git Hooks ```bash #!/bin/sh # .git...
(QB_NEW_EN)
[grammar] ~329-~329: Use correct spacing
Context: ...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 .PHON...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~342-~342: Use correct spacing
Context: ...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.
(QB_NEW_EN_OTHER_ERROR_IDS_5)
apps/docs/getting-started/agents/claude-code.mdx
[grammar] ~14-~14: Use correct spacing
Context: ...y setup** and direct Claude integration. ## 🎯 Why Choose Claude Code? <div classNa...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~16-~16: There might be a mistake here.
Context: ...egration. ## 🎯 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
(QB_NEW_EN)
[grammar] ~29-~29: There might be a mistake here.
Context: ...
(QB_NEW_EN)
[grammar] ~31-~31: Use correct spacing
Context: ...llation ### Step 1: Install Claude Code Follow the [official Claude Code install...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~33-~33: Use correct spacing
Context: ...ocs/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 ```bas...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~71-~71: Use correct spacing
Context: ...s> ### Step 2: Authenticate with Claude bash # Login to your Claude account claude auth login Follow the prompts to authenticate with ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~78-~78: Use correct spacing
Context: ...uthenticate with your Anthropic account. ## 🔧 Task Master Integration ### Method 1...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~80-~80: There might be a mistake here.
Context: ... account. ## 🔧 Task Master Integration ### Method 1: MCP Integration (Recommended) ...
(QB_NEW_EN)
[grammar] ~82-~82: Use correct spacing
Context: ... Method 1: MCP Integration (Recommended) Add Task Master to your Claude Code MCP ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~84-~84: Use correct spacing
Context: ...r 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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~109-~109: Use correct spacing
Context: ... ### Method 2: Direct CLI Usage You can also use Task Master commands di...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~111-~111: Use correct spacing
Context: ...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 Yo...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~125-~125: There might be a mistake here.
Context: ...r-ai show 1.2 ``` ## 🚀 Getting Started ### 1. Initialize Your Project In your proj...
(QB_NEW_EN)
[grammar] ~127-~127: Use correct spacing
Context: ... Started ### 1. Initialize Your Project In your project directory: ```bash # St...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~129-~129: Use correct spacing
Context: ...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 Cl...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~139-~139: Use correct spacing
Context: ... ``` ### 2. Configure Models (Optional) Since Claude Code doesn't need API keys,...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~141-~141: Use correct spacing
Context: ...keys, you can use it as your main model: Change the main model to claude-code/sonnet Available Claude Code models: - `claude-...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~147-~147: Use correct spacing
Context: ...onnet ``` Available Claude Code models: - claude-code/sonnet - Claude 3.5 Sonnet (recommended) - `cla...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~148-~148: Use correct spacing
Context: ...onnet- Claude 3.5 Sonnet (recommended) -claude-code/opus` - Claude 3 Opus (for complex tasks) ###...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~149-~149: Use correct spacing
Context: ...pus` - Claude 3 Opus (for complex tasks) ### 3. Create Your First Tasks ``` Can you ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~151-~151: Use correct spacing
Context: ...x tasks) ### 3. Create Your First Tasks Can you parse my PRD and create tasks for building a todo app? ## 💡 Advanced Configuration ### Hybrid Se...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~157-~157: There might be a mistake here.
Context: ...o app? ``` ## 💡 Advanced Configuration ### Hybrid Setup Use Claude Code as your ma...
(QB_NEW_EN)
[grammar] ~159-~159: Use correct spacing
Context: ...Advanced Configuration ### Hybrid Setup Use Claude Code as your main model with ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~161-~161: Use correct spacing
Context: ...main model with other APIs for research: Create .env in your project: ```bash #...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~163-~163: Use correct spacing
Context: ...esearch: 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 ma...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~170-~170: Use correct spacing
Context: ...nai_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 exc...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~175-~175: Use correct spacing
Context: ...-online ``` ### Multi-Session Workflows Claude Code excels at parallel developme...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~177-~177: Use correct spacing
Context: ...ude 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 conte...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~190-~190: Use correct spacing
Context: ...ext while allowing focused work streams. ## 🔍 Troubleshooting <Accordion title="Cl...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~192-~192: There might be a mistake here.
Context: ...sed 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...
(QB_NEW_EN)
[grammar] ~222-~222: There might be a mistake here.
Context: ...or 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 Workf...
(QB_NEW_EN)
[grammar] ~236-~236: There might be a mistake here.
Context: ...t sessions. ## 🎯 Best Practices ### Development Workflow ```bash # Morning ...
(QB_NEW_EN)
[grammar] ~238-~238: Use correct spacing
Context: ...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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~252-~252: Use correct spacing
Context: ... 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.
(QB_NEW_EN_OTHER_ERROR_IDS_5)
apps/docs/getting-started/ai-agents.mdx
[grammar] ~6-~6: Use correct spacing
Context: ...nt to get customized setup instructions.
AI-powered VS Code fork with built-in MCP support (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~20-~20: There might be a mistake here.
Context: ...rt <Card title="Claude Code" icon="claude" ...
(QB_NEW_EN)
[grammar] ~21-~21: There might be a mistake here.
Context: ...Card> <Card title="Claude Code" icon="claude" href="/getting-starte...
(QB_NEW_EN)
[grammar] ~22-~22: There might be a mistake here.
Context: ... title="Claude Code" icon="claude" href="/getting-started/agents/claude-cod...
(QB_NEW_EN)
[grammar] ~23-~23: Use correct spacing
Context: ...ef="/getting-started/agents/claude-code" >
Anthropic's official CLI for Claude (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~31-~31: There might be a mistake here.
Context: ...de <Card title="Windsurf" icon="windsurf" ...
(QB_NEW_EN)
[grammar] ~32-~32: There might be a mistake here.
Context: ... <Card title="Windsurf" icon="windsurf" href="/getting-star...
(QB_NEW_EN)
[grammar] ~33-~33: There might be a mistake here.
Context: ... title="Windsurf" icon="windsurf" href="/getting-started/agents/windsurf" ...
(QB_NEW_EN)
[grammar] ~34-~34: Use correct spacing
Context: ... href="/getting-started/agents/windsurf" >
Codeium's AI-native IDE (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~42-~42: There might be a mistake here.
Context: ...DE <Card title="VS Code" icon="vscode" ...
(QB_NEW_EN)
[grammar] ~43-~43: There might be a mistake here.
Context: ... <Card title="VS Code" icon="vscode" href="/getting-starte...
(QB_NEW_EN)
[grammar] ~44-~44: There might be a mistake here.
Context: ... title="VS Code" icon="vscode" href="/getting-started/agents/vscode" ...
(QB_NEW_EN)
[grammar] ~45-~45: Use correct spacing
Context: ... href="/getting-started/agents/vscode" >
Microsoft's editor with MCP extensions (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~53-~53: There might be a mistake here.
Context: ...ns <Card title="Command Line" icon="terminal...
(QB_NEW_EN)
[grammar] ~54-~54: There might be a mistake here.
Context: ...ard> <Card title="Command Line" icon="terminal" href="/getting-star...
(QB_NEW_EN)
[grammar] ~55-~55: There might be a mistake here.
Context: ...tle="Command Line" icon="terminal" href="/getting-started/agents/cli" > ...
(QB_NEW_EN)
[grammar] ~56-~56: Use correct spacing
Context: ... href="/getting-started/agents/cli" >
Direct CLI usage without IDE integration (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~64-~64: There might be a mistake here.
Context: ...on <Card title="Other Agents" icon="question...
(QB_NEW_EN)
[grammar] ~65-~65: There might be a mistake here.
Context: ...ard> <Card title="Other Agents" icon="question" href="/getting-star...
(QB_NEW_EN)
[grammar] ~66-~66: There might be a mistake here.
Context: ...tle="Other Agents" icon="question" href="/getting-started/agents/other" >...
(QB_NEW_EN)
[grammar] ~67-~67: Use correct spacing
Context: ... href="/getting-started/agents/other" >
Generic setup for other AI agents (QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~76-~76: Use correct spacing
Context: ...> ## Quick Recommendations For beginners: Start with Cursor - it has the most seamless MCP integration and one-click install. For Claude users: Use Claude Code ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[typographical] ~81-~81: To join two clauses or set off examples, consider using an em dash.
Context: ... For Claude users: Use Claude Code - it's Anthropic's official CLI with no API ke...
(QB_NEW_EN_DASH_RULE_EM)
[grammar] ~81-~81: Use correct spacing
Context: ...s official CLI with no API key required. For existing VS Code users: Stick with...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~83-~83: Use correct spacing
Context: ...'re already comfortable with your setup. For advanced users: Try Windsurf f...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[style] ~85-~85: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...already comfortable with your setup. For advanced users: Try Windsurf for ...
(ENGLISH_WORD_REPEAT_BEGINNING_RULE)
[grammar] ~85-~85: Use correct spacing
Context: ...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 <Tab t...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~96-~96: Use correct spacing
Context: ... ## 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 or join our Discord community for personalized recommendations.
(QB_NEW_EN_OTHER_ERROR_IDS_5)
apps/docs/getting-started/quick-start/quick-start.mdx
[grammar] ~8-~8: There might be a mistake here.
Context: ... setup time. ## 🎯 Choose Your AI Agent First, pick your preferred AI developmen...
(QB_NEW_EN)
[grammar] ~10-~10: Use correct spacing
Context: ...ur 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/a...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~24-~24: Use correct spacing
Context: ...ard> View all AI agents → ## 📋 Quick Start Steps After setting up y...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~26-~26: There might be a mistake here.
Context: ...rted/ai-agents) ## 📋 Quick Start Steps After setting up your AI agent, this gui...
(QB_NEW_EN)
[grammar] ~28-~28: There might be a mistake here.
Context: ...er setting up your AI agent, this guide covers: - [Requirements](/docs/getting-started/quick-start/requ...
(QB_NEW_EN_OTHER)
apps/docs/getting-started/agents/cursor.mdx
[grammar] ~14-~14: Use correct spacing
Context: ...installation and native MCP integration. ## 🚀 One-Click Install (Recommended) <div...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~16-~16: There might be a mistake here.
Context: .... ## 🚀 One-Click Install (Recommended)
Fastest Setup
(QB_NEW_EN)
[grammar] ~44-~44: There might be a mistake here.
Context: ...replaced. ## 📋 Manual Setup If you prefer manual configuration or th...
(QB_NEW_EN)
[grammar] ~46-~46: Use correct spacing
Context: ...n or the one-click install doesn't work: ### Step 1: Create MCP Configuration Choose...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~48-~48: Use correct spacing
Context: ...k: ### Step 1: Create MCP Configuration Choose your configuration scope: ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~50-~50: Use correct spacing
Context: ...ration 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 Curso...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~124-~124: Use correct spacing
Context: ...> ### Step 2: Enable MCP Server 1. Open Cursor Settings (Ctrl+Shift+J or ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~126-~126: There might be a mistake here.
Context: ...ttings (Ctrl+Shift+J or Cmd+Shift+J) 2. Click the MCP tab in the left sideba...
(QB_NEW_EN_OTHER)
[grammar] ~127-~127: There might be a mistake here.
Context: ...lick the MCP tab in the left sidebar 3. Find task-master-ai and toggle it **ON...
(QB_NEW_EN_OTHER)
[grammar] ~128-~128: Use proper capitalization
Context: ...Find task-master-ai and toggle it ON 4. Restart Cursor if needed ### Step 3: Ve...
(QB_NEW_EN_OTHER_ERROR_IDS_6)
[grammar] ~129-~129: There might be a mistake here.
Context: ...le it ON 4. Restart Cursor if needed ### Step 3: Verify Installation In Cursor's...
(QB_NEW_EN_OTHER)
[grammar] ~131-~131: Use correct spacing
Context: ... needed ### Step 3: Verify Installation In Cursor's chat panel, type: ``` help `...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~133-~133: Use correct spacing
Context: ...tallation In Cursor's chat panel, type: help You should see Task Master commands avai...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~138-~138: There might be a mistake here.
Context: ...commands available. If you see "0 tools enabled", check your API keys and restart Cursor....
(QB_NEW_EN_OTHER)
[grammar] ~138-~138: Use correct spacing
Context: ... check your API keys and restart Cursor. ## 🔧 Configuration ### Add Your API Keys ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~140-~140: There might be a mistake here.
Context: ...and restart Cursor. ## 🔧 Configuration ### Add Your API Keys <Tab title="...
(QB_NEW_EN)
[grammar] ~142-~142: Use correct spacing
Context: ... 🔧 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...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~172-~172: Use correct spacing
Context: ... ### Configure Models (Optional) In Cursor's chat, set your preferred mod...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~174-~174: Use correct spacing
Context: ...ursor'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 Ta...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~180-~180: There might be a mistake here.
Context: ...respectively. ``` ## 🎯 Getting Started ### 1. Initialize Task Master In Cursor's c...
(QB_NEW_EN)
[grammar] ~182-~182: Use correct spacing
Context: ...g Started ### 1. Initialize Task Master In Cursor's chat panel: ``` Initialize t...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~184-~184: Use correct spacing
Context: ...ize Task Master In Cursor's chat panel: Initialize taskmaster-ai in my project ### 2. Create Your First Task ``` Can you h...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~189-~189: Use correct spacing
Context: ...oject ### 2. Create Your First Task Can you help me implement user authentication for my web app? ### 3. Start Working What's the next ta...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~195-~195: Use correct spacing
Context: ...or my web app? ### 3. Start Working What's the next task I should work on? ``` ## 🔍 Troubleshooting <Accordion title="0 ...
(QB_NEW_EN_OTHER_ERROR_IDS_5)
[grammar] ~201-~201: There might be a mistake here.
Context: ...ould 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-specifi...
(QB_NEW_EN)
[grammar] ~223-~223: There might be a mistake here.
Context: ...or 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.
(QB_NEW_EN)
🔇 Additional comments (1)
apps/docs/getting-started/agents/cli.mdx (1)
52-123: Fixnpxcommand names to match the published CLI binary.The package
task-master-aiexposes thetask-masterexecutable (see existing README instructions), so everynpx task-master-ai …invocation here will fail. Replace them with the workingnpx task-master …form (including the version check and later command examples).- npx task-master-ai --version + npx task-master --version … - npx task-master-ai init + npx task-master init … - npx task-master-ai next + npx task-master next - npx task-master-ai show 1.2 + npx task-master show 1.2Please sweep the remainder of the page for the same correction so readers can follow the workflow without hitting command-not-found errors.
⛔ Skipped due to learnings
Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/dev_workflow.mdc:0-0 Timestamp: 2025-07-18T17:10:12.881Z Learning: For CLI usage, install Taskmaster globally with `npm install -g task-master-ai` or use locally via `npx task-master-ai ...`.Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: assets/.windsurfrules:0-0 Timestamp: 2025-09-24T15:12:12.658Z Learning: Start new projects with task-master init or parse a PRD via task-master parse-prd --input=<file> to generate an initial tasks.jsonLearnt from: CR PR: eyaltoledano/claude-task-master#0 File: assets/.windsurfrules:0-0 Timestamp: 2025-09-24T15:12:12.658Z Learning: Add tasks with task-master add-task using AI with prompt, dependencies, and priority optionsLearnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/tasks.mdc:0-0 Timestamp: 2025-07-18T17:14:29.399Z Learning: Applies to scripts/modules/task-manager.js : Extract tasks from PRD documents using AI, create them in the current tag context (defaulting to 'master'), provide clear prompts to guide AI task generation, and validate/clean up AI-generated tasks.Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/dev_workflow.mdc:0-0 Timestamp: 2025-07-18T17:10:12.881Z Learning: Applies to .taskmaster/config.json : Store Taskmaster configuration settings (AI model selections, parameters, logging level, default subtasks/priority, project name, etc.) in the `.taskmaster/config.json` file located in the project root directory. Do not configure non-API key settings via environment variables.Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/taskmaster.mdc:0-0 Timestamp: 2025-07-31T22:08:16.039Z Learning: After initializing a project with Taskmaster, you must parse a PRD in order to generate tasks. There will be no tasks files until then.Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: assets/AGENTS.md:0-0 Timestamp: 2025-09-24T15:12:58.855Z Learning: Applies to assets/**/.mcp.json : Configure the Task Master MCP server in .mcp.json under mcpServers.task-master-ai using npx task-master-ai and provide required API key env varsLearnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/utilities.mdc:0-0 Timestamp: 2025-07-18T17:18:17.759Z Learning: Applies to .taskmasterconfig : Use `.taskmasterconfig` (JSON) in the project root for storing Taskmaster configuration (excluding API keys), and manage it via the `task-master models --setup` CLI command or the `models` MCP tool.Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/ai_services.mdc:0-0 Timestamp: 2025-07-18T17:06:57.833Z Learning: Ensure `.taskmasterconfig` exists and has valid provider/model IDs for the roles you intend to use (manage via `task-master models --setup`).Learnt from: CR PR: eyaltoledano/claude-task-master#0 File: .cursor/rules/dev_workflow.mdc:0-0 Timestamp: 2025-07-18T17:10:02.683Z Learning: Applies to .taskmaster/config.json : Store Taskmaster configuration settings (AI model selections, parameters, logging level, default subtasks/priority, project name, tag management) in `.taskmaster/config.json` in the project root. Do not configure these via environment variables.
| <Tab title="Windows"> | ||
| ```bash | ||
| # Windows-specific command | ||
| claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" | ||
| ``` | ||
| </Tab> |
There was a problem hiding this comment.
Use task-master-ai as the server identifier in the Windows command.
Our global/project examples add task-master-ai, and later steps tell users to manage that server name. The Windows-specific command here introduces task-master-mcp, which leaves them looking for a non-existent entry. Swap it to task-master-ai to avoid that break.
- claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+ claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"With this change the Windows flow aligns with the rest of the instructions.
📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| <Tab title="Windows"> | |
| ```bash | |
| # Windows-specific command | |
| claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai" | |
| ``` | |
| </Tab> | |
| <Tab title="Windows"> |
🤖 Prompt for AI Agents
In apps/docs/getting-started/agents/claude-code.mdx around lines 101 to 106, the
Windows command registers the server as "task-master-mcp" which mismatches the
rest of the doc; update the server identifier in that Windows-specific claude
mcp add command to "task-master-ai" so it matches global/project examples and
subsequent instructions.
| <Tab title="Windows Native"> | ||
| 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" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| <Note> | ||
| **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" | ||
| ``` | ||
| </Note> | ||
| </Tab> |
There was a problem hiding this comment.
Align the Windows claude mcp add command with the documented server name.
Everywhere else we reference/toggle task-master-ai, but this Windows command registers task-master-mcp, so the follow-up instructions (“find task-master-ai”) won’t match what the user just installed. Rename the server in both the claude mcp add … command and the alternative note to keep the workflow consistent.
- claude mcp add task-master-mcp -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"
+ claude mcp add task-master-ai -s project -- cmd /c "npx -y --package=task-master-ai task-master-ai"Apply the same change to the alternative Windows setup snippet immediately below.
📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| <Tab title="Windows Native"> | |
| 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" | |
| } | |
| } | |
| } | |
| } | |
| ``` | |
| <Note> | |
| **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" | |
| ``` | |
| </Note> | |
| </Tab> | |
| <Tab title="Windows Native"> | |
| For Windows users without WSL: |
🤖 Prompt for AI Agents
In apps/docs/getting-started/agents/cursor.mdx around lines 96 to 121, the
alternative Windows `claude mcp add` command and its Note register the server as
"task-master-mcp" but the rest of the docs reference "task-master-ai"; change
the server name in that command and in the Note to "task-master-ai" so the
installed server name matches examples and subsequent instructions.
Adds Windows-specific installation instructions for Claude Task Master MCP server
Generated with Claude Code
Summary by CodeRabbit