eyaltoledano/claude-task-master · warning

⚠ Warning: "tm delete-tag" is deprecated. Use "tm tags remov

Error message

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

What it means

`tm delete-tag` is a legacy alias for `tm tags remove`. Invoking it prints this deprecation warning and a removal-timeline notice, then performs the same deletion behavior.

Source

Thrown at scripts/modules/commands.js:4994

			process.exit(1);
		});

	// delete-tag command (DEPRECATED - use `tm tags remove` instead)
	programInstance
		.command('delete-tag')
		.description(
			'[DEPRECATED] Delete an existing tag and all its tasks (use "tm tags remove" instead)'
		)
		.argument('<tagName>', 'Name of the tag to delete')
		.option(
			'-f, --file <file>',
			'Path to the tasks file',
			TASKMASTER_TASKS_FILE
		)
		.option('-y, --yes', 'Skip confirmation prompts')
		.action(async (tagName, options) => {
			// Show deprecation warning
			console.warn(
				chalk.yellow(
					'⚠ Warning: "tm delete-tag" is deprecated. Use "tm tags remove" 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 remove <name>` (add -y/--yes to skip confirmation in scripts)
  2. Update shell scripts and CI to the new command
  3. Ignore if migration is deferred; purely informational

Example fix

// before
tm delete-tag old-tag -y
// after
tm tags remove old-tag -y
Defensive patterns

Strategy: validation

Validate before calling

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

Prevention

When it happens

Trigger: Running `task-master delete-tag <name>` or `tm delete-tag` directly or from scripts.

Common situations: Legacy automation, old documentation, habit from pre-tags-namespace versions.

Related errors


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