eyaltoledano/claude-task-master · warning

⚠ Warning: "tm use-tag" is deprecated. Use "tm tags use" ins

Error message

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

What it means

`tm use-tag` is a legacy alias for `tm tags use`. Calling it prints this deprecation warning plus a future-removal notice, then switches the active tag as before.

Source

Thrown at scripts/modules/commands.js:5066

	// This command has been replaced by the new CommandRegistry-based TagsCommand
	// in apps/cli/src/commands/tags.command.ts
	// The old implementation is no longer needed

	// use-tag command (DEPRECATED - use `tm tags use` instead)
	programInstance
		.command('use-tag')
		.description(
			'[DEPRECATED] Switch to a different tag context (use "tm tags use" instead)'
		)
		.argument('<tagName>', 'Name of the tag to switch to')
		.option(
			'-f, --file <file>',
			'Path to the tasks file',
			TASKMASTER_TASKS_FILE
		)
		.action(async (tagName, options) => {
			// Show deprecation warning
			console.warn(
				chalk.yellow(
					'⚠ Warning: "tm use-tag" is deprecated. Use "tm tags use" 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 use <name>`
  2. Update scripts/CI/docs to the new command
  3. Ignore if migration is deferred; informational only

Example fix

// before
tm use-tag work
// after
tm tags use work
Defensive patterns

Strategy: validation

Validate before calling

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

Prevention

When it happens

Trigger: Running `task-master use-tag <name>` or `tm use-tag` in terminal or scripts.

Common situations: Old scripts, muscle memory, outdated tutorials or docs.

Related errors

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