chore: update docs to remove --package refs

2025-09-18 23:35:52 +02:00
17 changed files with 32 additions and 30 deletions
--- a/.changeset/clever-spies-obey.md
+++ b/.changeset/clever-spies-obey.md
@@ -0,0 +1,8 @@
+---
+"task-master-ai": minor
+---
+
+No longer need --package=task-master-ai in mcp server
+
+- A lot of users were having issues with Taskmaster and usually a simple fix was to remove --package from your mcp.json
+- we now bundle our whole package, so we no longer need the --package
--- a/.kiro/settings/mcp.json
+++ b/.kiro/settings/mcp.json
@@ -2,7 +2,7 @@
 	"mcpServers": {
 		"task-master-ai": {
 			"command": "npx",
-			"args": ["-y", "--package=task-master-ai", "task-master-ai"],
+			"args": ["-y", "task-master-ai"],
 			"env": {
 				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
 				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
--- a/.taskmaster/CLAUDE.md
+++ b/.taskmaster/CLAUDE.md
@@ -85,7 +85,7 @@ Task Master provides an MCP server that Claude Code can connect to. Configure in
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here",
        "PERPLEXITY_API_KEY": "your_key_here",
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,12 +6,6 @@

 - [#1217](https://github.com/eyaltoledano/claude-task-master/pull/1217) [`e6de285`](https://github.com/eyaltoledano/claude-task-master/commit/e6de285ceacb0a397e952a63435cd32a9c731515) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - @tm/cli: add auto-update functionality to every command

-## 1.0.0-rc.2
-
-### Major Changes
-
- [#1217](https://github.com/eyaltoledano/claude-task-master/pull/1217) [`e6de285`](https://github.com/eyaltoledano/claude-task-master/commit/e6de285ceacb0a397e952a63435cd32a9c731515) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - @tm/cli: add auto-update functionality to every command
-
 ## 0.27.0-rc.1

 ### Minor Changes
--- a/README.md
+++ b/README.md
@@ -102,7 +102,7 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor.
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
@@ -122,7 +122,7 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor.

 > 🔑 Replace `YOUR_…_KEY_HERE` with your real API keys. You can remove keys you don't use.

-> **Note**: If you see `0 tools enabled` in the MCP settings, try removing the `--package=task-master-ai` flag from `args`.
+> **Note**: If you see `0 tools enabled` in the MCP settings, restart your editor and check that your API keys are correctly configured.

 ###### VS Code (`servers` + `type`)

@@ -131,7 +131,7 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor.
  "servers": {
    "task-master-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
--- a/apps/docs/archive/Installation.mdx
+++ b/apps/docs/archive/Installation.mdx
@@ -19,7 +19,7 @@ description: "This guide walks you through setting up Task Master in your develo
        	"mcpServers": {
        		"taskmaster-ai": {
        			"command": "npx",
-        			"args": ["-y", "--package", "task-master-ai", "task-master-mcp"],
+        			"args": ["-y", "task-master-ai"],
        			"env": {
        				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
--- a/apps/docs/archive/cursor-setup.mdx
+++ b/apps/docs/archive/cursor-setup.mdx
@@ -48,7 +48,7 @@ description: "Learn how to set up and use Task Master with Cursor AI"
      <Step title="Configure with the following details:">
        - Name: "Task Master"
        - Type: "Command"
-        - Command: "npx -y --package task-master-ai task-master-mcp"
+        - Command: "npx -y task-master-ai"
      </Step>
      <Step title="Save Settings">
        
--- a/apps/docs/getting-started/quick-start/installation.mdx
+++ b/apps/docs/getting-started/quick-start/installation.mdx
@@ -56,7 +56,7 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor.
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
@@ -75,7 +75,7 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor.

 > 🔑 Replace `YOUR_…_KEY_HERE` with your real API keys. You can remove keys you don't use.

-> **Note**: If you see `0 tools enabled` in the MCP settings, try removing the `--package=task-master-ai` flag from `args`.
+> **Note**: If you see `0 tools enabled` in the MCP settings, restart your editor and check that your API keys are correctly configured.

 ### VS Code (`servers` + `type`)

@@ -84,7 +84,7 @@ MCP (Model Control Protocol) lets you run Task Master directly from your editor.
  "servers": {
    "taskmaster-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
--- a/apps/extension/README.md
+++ b/apps/extension/README.md
@@ -109,7 +109,7 @@ Access settings via **File → Preferences → Settings** and search for "Taskma

 ### **MCP Connection Settings**
 - **MCP Server Command** - Path to task-master-ai executable (default: `npx`)
- **MCP Server Args** - Arguments for the server command (default: `-y`, `--package=task-master-ai`, `task-master-ai`)
+- **MCP Server Args** - Arguments for the server command (default: `-y`, `task-master-ai`)
 - **Connection Timeout** - Server response timeout (default: 30s)
 - **Auto Refresh** - Enable automatic task updates (default: enabled)

--- a/apps/extension/package.publish.json
+++ b/apps/extension/package.publish.json
@@ -95,7 +95,7 @@
 					"items": {
 						"type": "string"
 					},
-					"default": ["-y", "--package=task-master-ai", "task-master-ai"],
+					"default": ["-y", "task-master-ai"],
 					"description": "An array of arguments to pass to the MCP server command."
 				},
 				"taskmaster.mcp.cwd": {
--- a/docs/tutorial.md
+++ b/docs/tutorial.md
@@ -23,7 +23,7 @@ npm i -g task-master-ai
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
@@ -145,7 +145,7 @@ You can also set up the MCP server in Cursor settings:
 4. Configure with the following details:
   - Name: "Task Master"
   - Type: "Command"
-   - Command: "npx -y --package=task-master-ai task-master-ai"
+   - Command: "npx -y task-master-ai"
 5. Save the settings

 Once configured, you can interact with Task Master's task management commands directly through Cursor's interface, providing a more integrated experience.
--- a/llms-install.md
+++ b/llms-install.md
@@ -17,7 +17,7 @@ Add the following configuration to the user's MCP settings file (`.cursor/mcp.js
 	"mcpServers": {
 		"taskmaster-ai": {
 			"command": "npx",
-			"args": ["-y", "--package=task-master-ai", "task-master-ai"],
+			"args": ["-y", "task-master-ai"],
 			"env": {
 				"ANTHROPIC_API_KEY": "user_will_add_their_key_here",
 				"PERPLEXITY_API_KEY": "user_will_add_their_key_here",
--- a/public/assets/AGENTS.md
+++ b/public/assets/AGENTS.md
@@ -85,7 +85,7 @@ Task Master provides an MCP server that Claude Code can connect to. Configure in
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
-      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
+      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here",
        "PERPLEXITY_API_KEY": "your_key_here",
--- a/src/utils/create-mcp-config.js
+++ b/src/utils/create-mcp-config.js
@@ -45,7 +45,7 @@ export function setupMCPConfiguration(projectRoot, mcpConfigPath) {
 	const newMCPServer = {
 		'task-master-ai': {
 			command: 'npx',
-			args: ['-y', '--package=task-master-ai', 'task-master-ai'],
+			args: ['-y', 'task-master-ai'],
 			env: {
 				ANTHROPIC_API_KEY: 'YOUR_ANTHROPIC_API_KEY_HERE',
 				PERPLEXITY_API_KEY: 'YOUR_PERPLEXITY_API_KEY_HERE',
--- a/tests/integration/profiles/amp-init-functionality.test.js
+++ b/tests/integration/profiles/amp-init-functionality.test.js
@@ -141,7 +141,7 @@ describe('Amp Profile Init Functionality', () => {
 				mcpServers: {
 					'task-master-ai': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					}
 				}
 			};
@@ -181,7 +181,7 @@ describe('Amp Profile Init Functionality', () => {
 				'amp.mcpServers': {
 					'task-master-ai': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					}
 				}
 			};
@@ -266,7 +266,7 @@ describe('Amp Profile Init Functionality', () => {
 				'amp.mcpServers': {
 					'task-master-ai': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					}
 				},
 				'other.setting': 'value'
@@ -300,7 +300,7 @@ describe('Amp Profile Init Functionality', () => {
 				'amp.mcpServers': {
 					'task-master-ai': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					}
 				}
 			};
--- a/tests/unit/profiles/amp-integration.test.js
+++ b/tests/unit/profiles/amp-integration.test.js
@@ -153,7 +153,7 @@ describe('Amp Profile Integration', () => {
 				mcpServers: {
 					'task-master-ai': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					}
 				},
 				'workbench.colorTheme': 'Dark+'
@@ -215,7 +215,7 @@ describe('Amp Profile Integration', () => {
 				'amp.mcpServers': {
 					'task-master-ai': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					}
 				}
 			};
--- a/tests/unit/profiles/selective-profile-removal.test.js
+++ b/tests/unit/profiles/selective-profile-removal.test.js
@@ -526,7 +526,7 @@ describe('Selective Rules Removal', () => {
 				mcpServers: {
 					'taskmaster-wrapper': {
 						command: 'npx',
-						args: ['-y', '--package=task-master-ai', 'task-master-ai']
+						args: ['-y', 'task-master-ai']
 					},
 					'other-server': {
 						command: 'node',