feat: improve tm init

.changeset/polite-candles-follow.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': minor
----
-
-Add `npx task-master-ai` that runs mcp instead of using `task-master-mcp``

.changeset/witty-jokes-roll.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': patch
----
-
-Remove the need for project name, description, and version. Since we no longer create a package.json for you

README-task-master.md

@@ -146,7 +146,7 @@ To enable enhanced task management capabilities directly within Cursor using the
 4. Configure with the following details:
    - Name: "Task Master"
    - Type: "Command"
-   - Command: "npx -y task-master-ai"
+   - Command: "npx -y task-master-mcp"
 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.

README.md

@@ -20,14 +20,20 @@ A task management system for AI-driven development with Claude, designed to work
 
 MCP (Model Control Protocol) provides the easiest way to get started with Task Master directly in your editor.
 
-1. **Add the MCP config to your editor** (Cursor recommended, but it works with other text editors):
+1. **Install the package**
+
+```bash
+npm i -g task-master-ai
+```
+
+2. **Add the MCP config to your editor** (Cursor recommended, but it works with other text editors):
 
 ```json
 {
 	"mcpServers": {
 		"taskmaster-ai": {
 			"command": "npx",
-			"args": ["-y", "task-master-ai"],
+			"args": ["-y", "task-master-mcp"],
 			"env": {
 				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
 				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",

docs/tutorial.md

@@ -10,14 +10,20 @@ There are two ways to set up Task Master: using MCP (recommended) or via npm ins
 
 MCP (Model Control Protocol) provides the easiest way to get started with Task Master directly in your editor.
 
-1. **Add the MCP config to your editor** (Cursor recommended, but it works with other text editors):
+1. **Install the package**
+
+```bash
+npm i -g task-master-ai
+```
+
+2. **Add the MCP config to your editor** (Cursor recommended, but it works with other text editors):
 
 ```json
 {
 	"mcpServers": {
 		"taskmaster-ai": {
 			"command": "npx",
-			"args": ["-y", "task-master-ai"],
+			"args": ["-y", "task-master-mcp"],
 			"env": {
 				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
 				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",

mcp-server/src/core/direct-functions/initialize-project-direct.js

@@ -10,7 +10,7 @@ import os from 'os'; // Import os module for home directory check
 /**
  * Direct function wrapper for initializing a project.
  * Derives target directory from session, sets CWD, and calls core init logic.
- * @param {object} args - Arguments containing initialization options (addAliases, skipInstall, yes, projectRoot)
+ * @param {object} args - Arguments containing project details and options (projectName, projectDescription, yes, etc.)
  * @param {object} log - The FastMCP logger instance.
  * @param {object} context - The context object, must contain { session }.
  * @returns {Promise<{success: boolean, data?: any, error?: {code: string, message: string}}>} - Standard result object.
@@ -92,8 +92,12 @@ export async function initializeProjectDirect(args, log, context = {}) {
 	try {
 		// Always force yes: true when called via MCP to avoid interactive prompts
 		const options = {
-			aliases: args.addAliases,
+			name: args.projectName,
+			description: args.projectDescription,
+			version: args.projectVersion,
+			author: args.authorName,
 			skipInstall: args.skipInstall,
+			aliases: args.addAliases,
 			yes: true // Force yes mode
 		};
 

mcp-server/src/tools/initialize-project.js

@@ -10,8 +10,32 @@ export function registerInitializeProjectTool(server) {
 	server.addTool({
 		name: 'initialize_project',
 		description:
-			'Initializes a new Task Master project structure by calling the core initialization logic. Creates necessary folders and configuration files for Task Master in the current directory.',
+			"Initializes a new Task Master project structure by calling the core initialization logic. Derives target directory from client session. If project details (name, description, author) are not provided, prompts the user or skips if 'yes' flag is true. DO NOT run without parameters.",
 		parameters: z.object({
+			projectName: z
+				.string()
+				.optional()
+				.describe(
+					'The name for the new project. If not provided, prompt the user for it.'
+				),
+			projectDescription: z
+				.string()
+				.optional()
+				.describe(
+					'A brief description for the project. If not provided, prompt the user for it.'
+				),
+			projectVersion: z
+				.string()
+				.optional()
+				.describe(
+					"The initial version for the project (e.g., '0.1.0'). User input not needed unless user requests to override."
+				),
+			authorName: z
+				.string()
+				.optional()
+				.describe(
+					"The author's name. User input not needed unless user requests to override."
+				),
 			skipInstall: z
 				.boolean()
 				.optional()
@@ -23,13 +47,15 @@ export function registerInitializeProjectTool(server) {
 				.boolean()
 				.optional()
 				.default(false)
-				.describe('Add shell aliases (tm, taskmaster) to shell config file.'),
+				.describe(
+					'Add shell aliases (tm, taskmaster) to shell config file. User input not needed.'
+				),
 			yes: z
 				.boolean()
 				.optional()
-				.default(true)
+				.default(false)
 				.describe(
-					'Skip prompts and use default values. Always set to true for MCP tools.'
+					"Skip prompts and use default values or provided arguments. Use true if you wish to skip details like the project name, etc. If the project information required for the initialization is not available or provided by the user, prompt if the user wishes to provide them (name, description, author) or skip them. If the user wishes to skip, set the 'yes' flag to true and do not set any other parameters."
 				),
 			projectRoot: z
 				.string()

package-lock.json

@@ -31,7 +31,6 @@
 			},
 			"bin": {
 				"task-master": "bin/task-master.js",
-				"task-master-ai": "mcp-server/server.js",
 				"task-master-mcp": "mcp-server/server.js"
 			},
 			"devDependencies": {

package.json

@@ -6,8 +6,7 @@
 	"type": "module",
 	"bin": {
 		"task-master": "bin/task-master.js",
-		"task-master-mcp": "mcp-server/server.js",
-		"task-master-ai": "mcp-server/server.js"
+		"task-master-mcp": "mcp-server/server.js"
 	},
 	"scripts": {
 		"test": "node --experimental-vm-modules node_modules/.bin/jest",

scripts/init.js

@@ -335,11 +335,36 @@ async function initializeProject(options = {}) {
 		console.log('===== DEBUG: INITIALIZE PROJECT OPTIONS RECEIVED =====');
 		console.log('Full options object:', JSON.stringify(options));
 		console.log('options.yes:', options.yes);
+		console.log('options.name:', options.name);
 		console.log('==================================================');
 	}
 
+	// Try to get project name from package.json if not provided
+	if (!options.name) {
+		const packageJsonPath = path.join(process.cwd(), 'package.json');
+		try {
+			if (fs.existsSync(packageJsonPath)) {
+				const packageJson = JSON.parse(
+					fs.readFileSync(packageJsonPath, 'utf8')
+				);
+				if (packageJson.name) {
+					log(
+						'info',
+						`Found project name '${packageJson.name}' in package.json`
+					);
+					options.name = packageJson.name;
+				}
+			}
+		} catch (error) {
+			log(
+				'debug',
+				`Could not read project name from package.json: ${error.message}`
+			);
+		}
+	}
+
 	// Determine if we should skip prompts based on the passed options
-	const skipPrompts = options.yes;
+	const skipPrompts = options.yes || (options.name && options.description);
 	if (!isSilentMode()) {
 		console.log('Skip prompts determined:', skipPrompts);
 	}
@@ -349,24 +374,44 @@ async function initializeProject(options = {}) {
 			console.log('SKIPPING PROMPTS - Using defaults or provided values');
 		}
 
-		// We no longer need these variables
+		// Use provided options or defaults
+		const projectName = options.name || 'task-master-project';
+		const projectDescription =
+			options.description || 'A project managed with Task Master AI';
+		const projectVersion = options.version || '0.1.0'; // Default from commands.js or here
+		const authorName = options.author || 'Vibe coder'; // Default if not provided
 		const dryRun = options.dryRun || false;
 		const addAliases = options.aliases || false;
 
 		if (dryRun) {
 			log('info', 'DRY RUN MODE: No files will be modified');
-			log('info', 'Would initialize Task Master project');
+			log(
+				'info',
+				`Would initialize project: ${projectName} (${projectVersion})`
+			);
+			log('info', `Description: ${projectDescription}`);
+			log('info', `Author: ${authorName || 'Not specified'}`);
 			log('info', 'Would create/update necessary project files');
 			if (addAliases) {
 				log('info', 'Would add shell aliases for task-master');
 			}
 			return {
+				projectName,
+				projectDescription,
+				projectVersion,
+				authorName,
 				dryRun: true
 			};
 		}
 
-		// Create structure using only necessary values
-		createProjectStructure(addAliases);
+		// Create structure using determined values
+		createProjectStructure(
+			projectName,
+			projectDescription,
+			projectVersion,
+			authorName,
+			addAliases
+		);
 	} else {
 		// Prompting logic (only runs if skipPrompts is false)
 		log('info', 'Required options not provided, proceeding with prompts.');
@@ -376,17 +421,41 @@ async function initializeProject(options = {}) {
 		});
 
 		try {
-			// Only prompt for shell aliases
+			// Prompt user for input...
+			const projectName = await promptQuestion(
+				rl,
+				chalk.cyan('Enter project name: ')
+			);
+			const projectDescription = await promptQuestion(
+				rl,
+				chalk.cyan('Enter project description: ')
+			);
+			const projectVersionInput = await promptQuestion(
+				rl,
+				chalk.cyan('Enter project version (default: 1.0.0): ')
+			); // Use a default for prompt
+			const authorName = await promptQuestion(
+				rl,
+				chalk.cyan('Enter your name: ')
+			);
 			const addAliasesInput = await promptQuestion(
 				rl,
-				chalk.cyan(
-					'Add shell aliases for task-master? This lets you type "tm" instead of "task-master" (Y/n): '
-				)
+				chalk.cyan('Add shell aliases for task-master? (Y/n): ')
 			);
 			const addAliasesPrompted = addAliasesInput.trim().toLowerCase() !== 'n';
+			const projectVersion = projectVersionInput.trim()
+				? projectVersionInput
+				: '1.0.0';
 
 			// Confirm settings...
-			console.log('\nTask Master Project settings:');
+			console.log('\nProject settings:');
+			console.log(chalk.blue('Name:'), chalk.white(projectName));
+			console.log(chalk.blue('Description:'), chalk.white(projectDescription));
+			console.log(chalk.blue('Version:'), chalk.white(projectVersion));
+			console.log(
+				chalk.blue('Author:'),
+				chalk.white(authorName || 'Not specified')
+			);
 			console.log(
 				chalk.blue(
 					'Add shell aliases (so you can use "tm" instead of "task-master"):'
@@ -412,18 +481,33 @@ async function initializeProject(options = {}) {
 
 			if (dryRun) {
 				log('info', 'DRY RUN MODE: No files will be modified');
-				log('info', 'Would initialize Task Master project');
+				log(
+					'info',
+					`Would initialize project: ${projectName} (${projectVersion})`
+				);
+				log('info', `Description: ${projectDescription}`);
+				log('info', `Author: ${authorName || 'Not specified'}`);
 				log('info', 'Would create/update necessary project files');
 				if (addAliasesPrompted) {
 					log('info', 'Would add shell aliases for task-master');
 				}
 				return {
+					projectName,
+					projectDescription,
+					projectVersion,
+					authorName,
 					dryRun: true
 				};
 			}
 
-			// Create structure using only necessary values
-			createProjectStructure(addAliasesPrompted);
+			// Create structure using prompted values, respecting initial options where relevant
+			createProjectStructure(
+				projectName,
+				projectDescription,
+				projectVersion,
+				authorName,
+				addAliasesPrompted // Use value from prompt
+			);
 		} catch (error) {
 			rl.close();
 			log('error', `Error during prompting: ${error.message}`); // Use log function
@@ -442,7 +526,13 @@ function promptQuestion(rl, question) {
 }
 
 // Function to create the project structure
-function createProjectStructure(addAliases) {
+function createProjectStructure(
+	projectName,
+	projectDescription,
+	projectVersion,
+	authorName,
+	addAliases
+) {
 	const targetDir = process.cwd();
 	log('info', `Initializing project in ${targetDir}`);
 
@@ -452,10 +542,14 @@ function createProjectStructure(addAliases) {
 	ensureDirectoryExists(path.join(targetDir, 'tasks'));
 
 	// Setup MCP configuration for integration with Cursor
-	setupMCPConfiguration(targetDir);
+	setupMCPConfiguration(targetDir, projectName);
 
 	// Copy template files with replacements
 	const replacements = {
+		projectName,
+		projectDescription,
+		projectVersion,
+		authorName,
 		year: new Date().getFullYear()
 	};
 
@@ -601,7 +695,7 @@ function createProjectStructure(addAliases) {
 }
 
 // Function to setup MCP configuration for Cursor integration
-function setupMCPConfiguration(targetDir) {
+function setupMCPConfiguration(targetDir, projectName) {
 	const mcpDirPath = path.join(targetDir, '.cursor');
 	const mcpJsonPath = path.join(mcpDirPath, 'mcp.json');