{"record":{"id":"3727d441dfa6f3e6","repo":"eyaltoledano/claude-task-master","slug":"warning-tm-delete-tag-is-deprecated-use-tm","errorCode":null,"errorMessage":"⚠ Warning: \"tm delete-tag\" is deprecated. Use \"tm tags remove\" instead.","messagePattern":"⚠ Warning: \"tm delete-tag\" is deprecated\\. Use \"tm tags remove\" instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"scripts/modules/commands.js","lineNumber":4994,"sourceCode":"\t\t\tprocess.exit(1);\n\t\t});\n\n\t// delete-tag command (DEPRECATED - use `tm tags remove` instead)\n\tprogramInstance\n\t\t.command('delete-tag')\n\t\t.description(\n\t\t\t'[DEPRECATED] Delete an existing tag and all its tasks (use \"tm tags remove\" instead)'\n\t\t)\n\t\t.argument('<tagName>', 'Name of the tag to delete')\n\t\t.option(\n\t\t\t'-f, --file <file>',\n\t\t\t'Path to the tasks file',\n\t\t\tTASKMASTER_TASKS_FILE\n\t\t)\n\t\t.option('-y, --yes', 'Skip confirmation prompts')\n\t\t.action(async (tagName, options) => {\n\t\t\t// Show deprecation warning\n\t\t\tconsole.warn(\n\t\t\t\tchalk.yellow(\n\t\t\t\t\t'⚠ Warning: \"tm delete-tag\" is deprecated. Use \"tm tags remove\" instead.'\n\t\t\t\t)\n\t\t\t);\n\t\t\tconsole.log(\n\t\t\t\tchalk.gray('  This command will be removed in a future version.\\n')\n\t\t\t);\n\n\t\t\ttry {\n\t\t\t\t// Initialize TaskMaster\n\t\t\t\tconst taskMaster = initTaskMaster({\n\t\t\t\t\ttasksPath: options.file || true\n\t\t\t\t});\n\t\t\t\tconst tasksPath = taskMaster.getTasksPath();\n\n\t\t\t\t// Validate tasks file exists\n\t\t\t\tif (!fs.existsSync(tasksPath)) {\n\t\t\t\t\tconsole.error(","sourceCodeStart":4976,"sourceCodeEnd":5012,"githubUrl":"https://github.com/eyaltoledano/claude-task-master/blob/c0c98d367c55296bfe69e65680625b6db437af02/scripts/modules/commands.js#L4976-L5012","documentation":"`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.","triggerScenarios":"Running `task-master delete-tag <name>` or `tm delete-tag` directly or from scripts.","commonSituations":"Legacy automation, old documentation, habit from pre-tags-namespace versions.","solutions":["Replace with `tm tags remove <name>` (add -y/--yes to skip confirmation in scripts)","Update shell scripts and CI to the new command","Ignore if migration is deferred; purely informational"],"exampleFix":"// before\ntm delete-tag old-tag -y\n// after\ntm tags remove old-tag -y","handlingStrategy":"validation","validationCode":"if (process.argv.includes('delete-tag')) {\n  console.warn('Deprecated: use `tm tags remove` instead');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Replace delete-tag with `tags remove` in all automation","Add -y to scripted tags removal to avoid prompts","Audit scripts after each task-master minor upgrade"],"tags":["cli","deprecation","tag-management"],"backgroundTag":"deprecated-api-usage","analyzedSha":"c0c98d367c55296bfe69e65680625b6db437af02","analyzedAt":"2026-08-29T02:56:26.071Z","schemaVersion":2},"datasetVersion":"2026-08-29T07:17:48.351Z"}