{"record":{"id":"7ef2b45a9c185f67","repo":"eyaltoledano/claude-task-master","slug":"warning-tm-use-tag-is-deprecated-use-tm-tag","errorCode":null,"errorMessage":"⚠ Warning: \"tm use-tag\" is deprecated. Use \"tm tags use\" instead.","messagePattern":"⚠ Warning: \"tm use-tag\" is deprecated\\. Use \"tm tags use\" instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"scripts/modules/commands.js","lineNumber":5066,"sourceCode":"\t// This command has been replaced by the new CommandRegistry-based TagsCommand\n\t// in apps/cli/src/commands/tags.command.ts\n\t// The old implementation is no longer needed\n\n\t// use-tag command (DEPRECATED - use `tm tags use` instead)\n\tprogramInstance\n\t\t.command('use-tag')\n\t\t.description(\n\t\t\t'[DEPRECATED] Switch to a different tag context (use \"tm tags use\" instead)'\n\t\t)\n\t\t.argument('<tagName>', 'Name of the tag to switch to')\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.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 use-tag\" is deprecated. Use \"tm tags use\" 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":5048,"sourceCodeEnd":5084,"githubUrl":"https://github.com/eyaltoledano/claude-task-master/blob/c0c98d367c55296bfe69e65680625b6db437af02/scripts/modules/commands.js#L5048-L5084","documentation":"`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.","triggerScenarios":"Running `task-master use-tag <name>` or `tm use-tag` in terminal or scripts.","commonSituations":"Old scripts, muscle memory, outdated tutorials or docs.","solutions":["Replace with `tm tags use <name>`","Update scripts/CI/docs to the new command","Ignore if migration is deferred; informational only"],"exampleFix":"// before\ntm use-tag work\n// after\ntm tags use work","handlingStrategy":"validation","validationCode":"if (process.argv.includes('use-tag')) {\n  console.warn('Deprecated: use `tm tags use` instead');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use `tm tags use` everywhere; treat use-tag as alias-only","Update shell aliases/functions that wrap old commands","Keep team docs on the namespaced commands"],"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"}