Skip to content

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.

fix: task master (tm) custom slash commands w/ proper syntax (#968)

Ralph Khreish4629128943f6
diff --git a/.changeset/ten-glasses-feel.md b/.changeset/ten-glasses-feel.md
new file mode 100644
index 00000000..d91910cd
--- /dev/null
+++ b/.changeset/ten-glasses-feel.md
@@ -0,0 +1,7 @@
+---
+"task-master-ai": patch
+---
+
+Fixed the comprehensive taskmaster system integration via custom slash commands with proper syntax
+
+- Provide claude clode with a complete set of of commands that can trigger task master events directly within Claude Code
diff --git a/.claude/commands/tm/add-dependency/index.md b/.claude/commands/tm/add-dependency/add-dependency.md
similarity index 100%
rename from .claude/commands/tm/add-dependency/index.md
rename to .claude/commands/tm/add-dependency/add-dependency.md
diff --git a/.claude/commands/tm/add-subtask/index.md b/.claude/commands/tm/add-subtask/add-subtask.md
similarity index 100%
rename from .claude/commands/tm/add-subtask/index.md
rename to .claude/commands/tm/add-subtask/add-subtask.md
diff --git a/.claude/commands/tm/add-subtask/from-task.md b/.claude/commands/tm/add-subtask/convert-task-to-subtask.md
similarity index 100%
rename from .claude/commands/tm/add-subtask/from-task.md
rename to .claude/commands/tm/add-subtask/convert-task-to-subtask.md
diff --git a/.claude/commands/tm/add-task/index.md b/.claude/commands/tm/add-task/add-task.md
similarity index 100%
rename from .claude/commands/tm/add-task/index.md
rename to .claude/commands/tm/add-task/add-task.md
diff --git a/.claude/commands/tm/analyze-complexity/index.md b/.claude/commands/tm/analyze-complexity/analyze-complexity.md
similarity index 100%
rename from .claude/commands/tm/analyze-complexity/index.md
rename to .claude/commands/tm/analyze-complexity/analyze-complexity.md
diff --git a/.claude/commands/tm/clear-subtasks/all.md b/.claude/commands/tm/clear-subtasks/clear-all-subtasks.md
similarity index 100%
rename from .claude/commands/tm/clear-subtasks/all.md
rename to .claude/commands/tm/clear-subtasks/clear-all-subtasks.md
diff --git a/.claude/commands/tm/clear-subtasks/index.md b/.claude/commands/tm/clear-subtasks/clear-subtasks.md
similarity index 100%
rename from .claude/commands/tm/clear-subtasks/index.md
rename to .claude/commands/tm/clear-subtasks/clear-subtasks.md
diff --git a/.claude/commands/tm/complexity-report/index.md b/.claude/commands/tm/complexity-report/complexity-report.md
similarity index 100%
rename from .claude/commands/tm/complexity-report/index.md
rename to .claude/commands/tm/complexity-report/complexity-report.md
diff --git a/.claude/commands/tm/expand/all.md b/.claude/commands/tm/expand/expand-all-tasks.md
similarity index 100%
rename from .claude/commands/tm/expand/all.md
rename to .claude/commands/tm/expand/expand-all-tasks.md
diff --git a/.claude/commands/tm/expand/index.md b/.claude/commands/tm/expand/expand-task.md
similarity index 100%
rename from .claude/commands/tm/expand/index.md
rename to .claude/commands/tm/expand/expand-task.md
diff --git a/.claude/commands/tm/fix-dependencies/index.md b/.claude/commands/tm/fix-dependencies/fix-dependencies.md
similarity index 100%
rename from .claude/commands/tm/fix-dependencies/index.md
rename to .claude/commands/tm/fix-dependencies/fix-dependencies.md
diff --git a/.claude/commands/tm/generate/index.md b/.claude/commands/tm/generate/generate-tasks.md
similarity index 100%
rename from .claude/commands/tm/generate/index.md
rename to .claude/commands/tm/generate/generate-tasks.md
diff --git a/.claude/commands/tm/index.md b/.claude/commands/tm/index.md
deleted file mode 100644
index f513bb04..00000000
--- a/.claude/commands/tm/index.md
+++ /dev/null
@@ -1,130 +0,0 @@
-# Task Master Command Reference
-
-Comprehensive command structure for Task Master integration with Claude Code.
-
-## Command Organization
-
-Commands are organized hierarchically to match Task Master's CLI structure while providing enhanced Claude Code integration.
-
-## Project Setup & Configuration
-
-### `/project:tm/init`
-- `index` - Initialize new project (handles PRD files intelligently)
-- `quick` - Quick setup with auto-confirmation (-y flag)
-
-### `/project:tm/models`
-- `index` - View current AI model configuration
-- `setup` - Interactive model configuration
-- `set-main` - Set primary generation model
-- `set-research` - Set research model
-- `set-fallback` - Set fallback model
-
-## Task Generation
-
-### `/project:tm/parse-prd`
-- `index` - Generate tasks from PRD document
-- `with-research` - Enhanced parsing with research mode
-
-### `/project:tm/generate`
-- Create individual task files from tasks.json
-
-## Task Management
-
-### `/project:tm/list`
-- `index` - Smart listing with natural language filters
-- `with-subtasks` - Include subtasks in hierarchical view
-- `by-status` - Filter by specific status
-
-### `/project:tm/set-status`
-- `to-pending` - Reset task to pending
-- `to-in-progress` - Start working on task
-- `to-done` - Mark task complete
-- `to-review` - Submit for review
-- `to-deferred` - Defer task
-- `to-cancelled` - Cancel task
-
-### `/project:tm/sync-readme`
-- Export tasks to README.md with formatting
-
-### `/project:tm/update`
-- `index` - Update tasks with natural language
-- `from-id` - Update multiple tasks from a starting point
-- `single` - Update specific task
-
-### `/project:tm/add-task`
-- `index` - Add new task with AI assistance
-
-### `/project:tm/remove-task`
-- `index` - Remove task with confirmation
-
-## Subtask Management
-
-### `/project:tm/add-subtask`
-- `index` - Add new subtask to parent
-- `from-task` - Convert existing task to subtask
-
-### `/project:tm/remove-subtask`
-- Remove subtask (with optional conversion)
-
-### `/project:tm/clear-subtasks`
-- `index` - Clear subtasks from specific task
-- `all` - Clear all subtasks globally
-
-## Task Analysis & Breakdown
-
-### `/project:tm/analyze-complexity`
-- Analyze and generate expansion recommendations
-
-### `/project:tm/complexity-report`
-- Display complexity analysis report
-
-### `/project:tm/expand`
-- `index` - Break down specific task
-- `all` - Expand all eligible tasks
-- `with-research` - Enhanced expansion
-
-## Task Navigation
-
-### `/project:tm/next`
-- Intelligent next task recommendation
-
-### `/project:tm/show`
-- Display detailed task information
-
-### `/project:tm/status`
-- Comprehensive project dashboard
-
-## Dependency Management
-
-### `/project:tm/add-dependency`
-- Add task dependency
-
-### `/project:tm/remove-dependency`
-- Remove task dependency
-
-### `/project:tm/validate-dependencies`
-- Check for dependency issues
-
-### `/project:tm/fix-dependencies`
-- Automatically fix dependency problems
-
-## Usage Patterns
-
-### Natural Language
-Most commands accept natural language arguments:
-```
-/project:tm/add-task create user authentication system
-/project:tm/update mark all API tasks as high priority
-/project:tm/list show blocked tasks
-```
-
-### ID-Based Commands
-Commands requiring IDs intelligently parse from $ARGUMENTS:
-```
-/project:tm/show 45
-/project:tm/expand 23
-/project:tm/set-status/to-done 67
-```
-
-### Smart Defaults
-Commands provide intelligent defaults and suggestions based on context.
\ No newline at end of file
diff --git a/.claude/commands/tm/init/quick.md b/.claude/commands/tm/init/init-project-quick.md
similarity index 100%
rename from .claude/commands/tm/init/quick.md
rename to .claude/commands/tm/init/init-project-quick.md
diff --git a/.claude/commands/tm/init/index.md b/.claude/commands/tm/init/init-project.md
similarity index 100%
rename from .claude/commands/tm/init/index.md
rename to .claude/commands/tm/init/init-project.md
diff --git a/.claude/commands/tm/list/by-status.md b/.claude/commands/tm/list/list-tasks-by-status.md
similarity index 100%
rename from .claude/commands/tm/list/by-status.md
rename to .claude/commands/tm/list/list-tasks-by-status.md
diff --git a/.claude/commands/tm/list/with-subtasks.md b/.claude/commands/tm/list/list-tasks-with-subtasks.md
similarity index 100%
rename from .claude/commands/tm/list/with-subtasks.md
rename to .claude/commands/tm/list/list-tasks-with-subtasks.md
diff --git a/.claude/commands/tm/list/index.md b/.claude/commands/tm/list/list-tasks.md
similarity index 100%
rename from .claude/commands/tm/list/index.md
rename to .claude/commands/tm/list/list-tasks.md
diff --git a/.claude/commands/tm/models/setup.md b/.claude/commands/tm/models/setup-models.md
similarity index 100%
rename from .claude/commands/tm/models/setup.md
rename to .claude/commands/tm/models/setup-models.md
diff --git a/.claude/commands/tm/models/index.md b/.claude/commands/tm/models/view-models.md
similarity index 100%
rename from .claude/commands/tm/models/index.md
rename to .claude/commands/tm/models/view-models.md
diff --git a/.claude/commands/tm/next/index.md b/.claude/commands/tm/next/next-task.md
similarity index 100%
rename from .claude/commands/tm/next/index.md
rename to .claude/commands/tm/next/next-task.md
diff --git a/.claude/commands/tm/parse-prd/with-research.md b/.claude/commands/tm/parse-prd/parse-prd-with-research.md
similarity index 100%
rename from .claude/commands/tm/parse-prd/with-research.md
rename to .claude/commands/tm/parse-prd/parse-prd-with-research.md
diff --git a/.claude/commands/tm/parse-prd/index.md b/.claude/commands/tm/parse-prd/parse-prd.md
similarity index 100%
rename from .claude/commands/tm/parse-prd/index.md
rename to .claude/commands/tm/parse-prd/parse-prd.md
diff --git a/.claude/commands/tm/remove-dependency/index.md b/.claude/commands/tm/remove-dependency/remove-dependency.md
similarity index 100%
rename from .claude/commands/tm/remove-dependency/index.md
rename to .claude/commands/tm/remove-dependency/remove-dependency.md
diff --git a/.claude/commands/tm/remove-subtask/index.md b/.claude/commands/tm/remove-subtask/remove-subtask.md
similarity index 100%
rename from .claude/commands/tm/remove-subtask/index.md
rename to .claude/commands/tm/remove-subtask/remove-subtask.md
diff --git a/.claude/commands/tm/remove-task/index.md b/.claude/commands/tm/remove-task/remove-task.md
similarity index 100%
rename from .claude/commands/tm/remove-task/index.md
rename to .claude/commands/tm/remove-task/remove-task.md
diff --git a/.claude/commands/tm/setup/install.md b/.claude/commands/tm/setup/install-taskmaster.md
similarity index 100%
rename from .claude/commands/tm/setup/install.md
rename to .claude/commands/tm/setup/install-taskmaster.md
diff --git a/.claude/commands/tm/setup/quick-install.md b/.claude/commands/tm/setup/quick-install-taskmaster.md
similarity index 100%
rename from .claude/commands/tm/setup/quick-install.md
rename to .claude/commands/tm/setup/quick-install-taskmaster.md
diff --git a/.claude/commands/tm/show/index.md b/.claude/commands/tm/show/show-task.md
similarity index 100%
rename from .claude/commands/tm/show/index.md
rename to .claude/commands/tm/show/show-task.md
diff --git a/.claude/commands/tm/status/index.md b/.claude/commands/tm/status/project-status.md
similarity index 100%
rename from .claude/commands/tm/status/index.md
rename to .claude/commands/tm/status/project-status.md
diff --git a/.claude/commands/tm/sync-readme/index.md b/.claude/commands/tm/sync-readme/sync-readme.md
similarity index 100%
rename from .claude/commands/tm/sync-readme/index.md
rename to .claude/commands/tm/sync-readme/sync-readme.md
diff --git a/.claude/commands/tm/tm-main.md b/.claude/commands/tm/tm-main.md
new file mode 100644
index 00000000..92946364
--- /dev/null
+++ b/.claude/commands/tm/tm-main.md
@@ -0,0 +1,146 @@
+# Task Master Command Reference
+
+Comprehensive command structure for Task Master integration with Claude Code.
+
+## Command Organization
+
+Commands are organized hierarchically to match Task Master's CLI structure while providing enhanced Claude Code integration.
+
+## Project Setup & Configuration
+
+### `/project:tm/init`
+- `init-project` - Initialize new project (handles PRD files intelligently)
+- `init-project-quick` - Quick setup with auto-confirmation (-y flag)
+
+### `/project:tm/models`
+- `view-models` - View current AI model configuration
+- `setup-models` - Interactive model configuration
+- `set-main` - Set primary generation model
+- `set-research` - Set research model
+- `set-fallback` - Set fallback model
+
+## Task Generation
+
+### `/project:tm/parse-prd`
+- `parse-prd` - Generate tasks from PRD document
+- `parse-prd-with-research` - Enhanced parsing with research mode
+
+### `/project:tm/generate`
+- `generate-tasks` - Create individual task files from tasks.json
+
+## Task Management
+
+### `/project:tm/list`
+- `list-tasks` - Smart listing with natural language filters
+- `list-tasks-with-subtasks` - Include subtasks in hierarchical view
+- `list-tasks-by-status` - Filter by specific status
+
+### `/project:tm/set-status`
+- `to-pending` - Reset task to pending
+- `to-in-progress` - Start working on task
+- `to-done` - Mark task complete
+- `to-review` - Submit for review
+- `to-deferred` - Defer task
+- `to-cancelled` - Cancel task
+
+### `/project:tm/sync-readme`
+- `sync-readme` - Export tasks to README.md with formatting
+
+### `/project:tm/update`
+- `update-task` - Update tasks with natural language
+- `update-tasks-from-id` - Update multiple tasks from a starting point
+- `update-single-task` - Update specific task
+
+### `/project:tm/add-task`
+- `add-task` - Add new task with AI assistance
+
+### `/project:tm/remove-task`
+- `remove-task` - Remove task with confirmation
+
+## Subtask Management
+
+### `/project:tm/add-subtask`
+- `add-subtask` - Add new subtask to parent
+- `convert-task-to-subtask` - Convert existing task to subtask
+
+### `/project:tm/remove-subtask`
+- `remove-subtask` - Remove subtask (with optional conversion)
+
+### `/project:tm/clear-subtasks`
+- `clear-subtasks` - Clear subtasks from specific task
+- `clear-all-subtasks` - Clear all subtasks globally
+
+## Task Analysis & Breakdown
+
+### `/project:tm/analyze-complexity`
+- `analyze-complexity` - Analyze and generate expansion recommendations
+
+### `/project:tm/complexity-report`
+- `complexity-report` - Display complexity analysis report
+
+### `/project:tm/expand`
+- `expand-task` - Break down specific task
+- `expand-all-tasks` - Expand all eligible tasks
+- `with-research` - Enhanced expansion
+
+## Task Navigation
+
+### `/project:tm/next`
+- `next-task` - Intelligent next task recommendation
+
+### `/project:tm/show`
+- `show-task` - Display detailed task information
+
+### `/project:tm/status`
+- `project-status` - Comprehensive project dashboard
+
+## Dependency Management
+
+### `/project:tm/add-dependency`
+- `add-dependency` - Add task dependency
+
+### `/project:tm/remove-dependency`
+- `remove-dependency` - Remove task dependency
+
+### `/project:tm/validate-dependencies`
+- `validate-dependencies` - Check for dependency issues
+
+### `/project:tm/fix-dependencies`
+- `fix-dependencies` - Automatically fix dependency problems
+
+## Workflows & Automation
+
+### `/project:tm/workflows`
+- `smart-workflow` - Context-aware intelligent workflow execution
+- `command-pipeline` - Chain multiple commands together
+- `auto-implement-tasks` - Advanced auto-implementation with code generation
+
+## Utilities
+
+### `/project:tm/utils`
+- `analyze-project` - Deep project analysis and insights
+
+### `/project:tm/setup`
+- `install-taskmaster` - Comprehensive installation guide
+- `quick-install-taskmaster` - One-line global installation
+
+## Usage Patterns
+
+### Natural Language
+Most commands accept natural language arguments:
+```
+/project:tm/add-task create user authentication system
+/project:tm/update mark all API tasks as high priority
+/project:tm/list show blocked tasks
+```
+
+### ID-Based Commands
+Commands requiring IDs intelligently parse from $ARGUMENTS:
+```
+/project:tm/show 45
+/project:tm/expand 23
+/project:tm/set-status/to-done 67
+```
+
+### Smart Defaults
+Commands provide intelligent defaults and suggestions based on context.
\ No newline at end of file
diff --git a/.claude/commands/tm/update/single.md b/.claude/commands/tm/update/update-single-task.md
similarity index 100%
rename from .claude/commands/tm/update/single.md
rename to .claude/commands/tm/update/update-single-task.md
diff --git a/.claude/commands/tm/update/index.md b/.claude/commands/tm/update/update-task.md
similarity index 100%
rename from .claude/commands/tm/update/index.md
rename to .claude/commands/tm/update/update-task.md
diff --git a/.claude/commands/tm/update/from-id.md b/.claude/commands/tm/update/update-tasks-from-id.md
similarity index 100%
rename from .claude/commands/tm/update/from-id.md
rename to .claude/commands/tm/update/update-tasks-from-id.md
diff --git a/.claude/commands/tm/utils/analyze.md b/.claude/commands/tm/utils/analyze-project.md
similarity index 100%
rename from .claude/commands/tm/utils/analyze.md
rename to .claude/commands/tm/utils/analyze-project.md
diff --git a/.claude/commands/tm/validate-dependencies/index.md b/.claude/commands/tm/validate-dependencies/validate-dependencies.md
similarity index 100%
rename from .claude/commands/tm/validate-dependencies/index.md
rename to .claude/commands/tm/validate-dependencies/validate-dependencies.md
diff --git a/.claude/commands/tm/workflows/auto-implement.md b/.claude/commands/tm/workflows/auto-implement-tasks.md
similarity index 100%
rename from .claude/commands/tm/workflows/auto-implement.md
rename to .claude/commands/tm/workflows/auto-implement-tasks.md
diff --git a/.claude/commands/tm/workflows/pipeline.md b/.claude/commands/tm/workflows/command-pipeline.md
similarity index 100%
rename from .claude/commands/tm/workflows/pipeline.md
rename to .claude/commands/tm/workflows/command-pipeline.md
diff --git a/.claude/commands/tm/workflows/smart-flow.md b/.claude/commands/tm/workflows/smart-workflow.md
similarity index 100%
rename from .claude/commands/tm/workflows/smart-flow.md
rename to .claude/commands/tm/workflows/smart-workflow.md