eyaltoledano/claude-task-master · warning

⚠ Warning: "tm rename-tag" is deprecated. Use "tm tags renam

Error message

⚠ Warning: "tm rename-tag" is deprecated. Use "tm tags rename" instead.

What it means

`tm rename-tag` is a legacy alias for `tm tags rename`. It prints this deprecation warning and future-removal notice, then performs the rename.

Source

Thrown at scripts/modules/commands.js:5124

			process.exit(1);
		});

	// rename-tag command (DEPRECATED - use `tm tags rename` instead)
	programInstance
		.command('rename-tag')
		.description(
			'[DEPRECATED] Rename an existing tag (use "tm tags rename" instead)'
		)
		.argument('<oldName>', 'Current name of the tag')
		.argument('<newName>', 'New name for the tag')
		.option(
			'-f, --file <file>',
			'Path to the tasks file',
			TASKMASTER_TASKS_FILE
		)
		.action(async (oldName, newName, options) => {
			// Show deprecation warning
			console.warn(
				chalk.yellow(
					'⚠ Warning: "tm rename-tag" is deprecated. Use "tm tags rename" instead.'
				)
			);
			console.log(
				chalk.gray('  This command will be removed in a future version.\n')
			);

			try {
				// Initialize TaskMaster
				const taskMaster = initTaskMaster({
					tasksPath: options.file || true
				});
				const tasksPath = taskMaster.getTasksPath();

				// Validate tasks file exists
				if (!fs.existsSync(tasksPath)) {
					console.error(

View on GitHub (pinned to c0c98d367c)

Solutions

  1. Replace with `tm tags rename <old> <new>`
  2. Update scripts and CI
  3. Ignore if migration is deferred; informational only

Example fix

// before
tm rename-tag old-tag new-tag
// after
tm tags rename old-tag new-tag
Defensive patterns

Strategy: validation

Validate before calling

if (process.argv.includes('rename-tag')) {
  console.warn('Deprecated: use `tm tags rename` instead');
}

Prevention

When it happens

Trigger: Running `task-master rename-tag <old> <new>` or `tm rename-tag` from scripts.

Common situations: Legacy automation, old docs, pre-namespace command habits.

Related errors

AI-assisted analysis of eyaltoledano/claude-task-master@c0c98d367c (2026-08-29). Data as JSON: /api/errors/3a498eb92812b150. Report an issue: GitHub.