eyaltoledano/claude-task-master · warning

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

Error message

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

What it means

`tm add-tag` has been superseded by the grouped `tm tags add` command. Registering/invoking the legacy alias prints this deprecation warning (plus a note that it will be removed in a future version) before forwarding to the same behavior.

Source

Thrown at scripts/modules/commands.js:4840

			'Path to the tasks file',
			TASKMASTER_TASKS_FILE
		)
		.option(
			'--copy-from-current',
			'Copy tasks from the current tag to the new tag'
		)
		.option(
			'--copy-from <tag>',
			'Copy tasks from the specified tag to the new tag'
		)
		.option(
			'--from-branch',
			'Create tag name from current git branch (ignores tagName argument)'
		)
		.option('-d, --description <text>', 'Optional description for the tag')
		.action(async (tagName, options) => {
			// Show deprecation warning
			console.warn(
				chalk.yellow(
					'⚠ Warning: "tm add-tag" is deprecated. Use "tm tags add" 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 `tm add-tag` with `tm tags add <name>`
2. Add any prior options identically to `tm tags add` (e.g. --from-branch, --description, --copy-from-current)
3. Update scripts/aliases/CI to the new command
4. Ignore the warning if migration must wait; it is informational only

Example fix

// before
tm add-tag release-1 --description='Release 1'
// after
tm tags add release-1 --description='Release 1'

const LEGACY = { 'add-tag': 'tags add', 'delete-tag': 'tags remove', 'use-tag': 'tags use', 'rename-tag': 'tags rename', 'copy-tag': 'tags copy' };
if (LEGACY[cmd]) console.warn(`Use 'tm ${LEGACY[cmd]}' instead`);

When it happens

Trigger: Invoking `task-master add-tag` or `tm add-tag` on the command line, or calling addTag via the legacy command path in scripts/MCP integrations.

Common situations: Old shell scripts, CI pipelines, docs, or muscle memory from earlier task-master versions.

Related errors

• ⚠ Warning: "tm delete-tag" is deprecated. Use "tm tags remov
• ⚠ Warning: "tm use-tag" is deprecated. Use "tm tags use" ins
• ⚠ Warning: "tm rename-tag" is deprecated. Use "tm tags renam
• ⚠ Warning: "tm copy-tag" is deprecated. Use "tm tags copy" i
• MFA_VERIFICATION_FAILED

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