From f961235442aa88e4983b29ab458b6a476fadf370 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 19 Dec 2025 13:14:48 +0100 Subject: [PATCH 1/3] Merge pull request #1540 from eyaltoledano/changeset-release/main --- .changeset/floppy-books-feel.md | 5 ---- .changeset/frank-ears-remain.md | 5 ---- .changeset/gold-tigers-tap.md | 9 -------- .changeset/list-watch-compact.md | 12 ---------- .changeset/pre.json | 23 ------------------- CHANGELOG.md | 23 +++++++++++++++++++ apps/cli/CHANGELOG.md | 7 ++++++ apps/docs/CHANGELOG.md | 2 ++ apps/docs/package.json | 2 +- apps/extension/package.json | 2 +- apps/mcp/CHANGELOG.md | 7 ++++++ package-lock.json | 8 +++---- package.json | 2 +- .../ai-sdk-provider-grok-cli/CHANGELOG.md | 2 ++ packages/build-config/CHANGELOG.md | 2 ++ packages/claude-code-plugin/CHANGELOG.md | 2 ++ packages/claude-code-plugin/package.json | 2 +- packages/tm-bridge/CHANGELOG.md | 7 ++++++ packages/tm-core/CHANGELOG.md | 2 ++ packages/tm-profiles/CHANGELOG.md | 2 ++ 20 files changed, 64 insertions(+), 62 deletions(-) delete mode 100644 .changeset/floppy-books-feel.md delete mode 100644 .changeset/frank-ears-remain.md delete mode 100644 .changeset/gold-tigers-tap.md delete mode 100644 .changeset/list-watch-compact.md delete mode 100644 .changeset/pre.json diff --git a/.changeset/floppy-books-feel.md b/.changeset/floppy-books-feel.md deleted file mode 100644 index 98a6c517d7..0000000000 --- a/.changeset/floppy-books-feel.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"task-master-ai": patch ---- - -Improved model search in `task-master models --setup` to match both display names and model IDs diff --git a/.changeset/frank-ears-remain.md b/.changeset/frank-ears-remain.md deleted file mode 100644 index 870174ac78..0000000000 --- a/.changeset/frank-ears-remain.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"task-master-ai": minor ---- - -Added Gemini 3 Flash Preview model support for Google and Gemini CLI providers diff --git a/.changeset/gold-tigers-tap.md b/.changeset/gold-tigers-tap.md deleted file mode 100644 index e3f1d55bbf..0000000000 --- a/.changeset/gold-tigers-tap.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -"task-master-ai": minor ---- - -Add auto-detection for IDE profiles in rules command - -- `tm rules add` now opens interactive setup with detected IDEs pre-selected -- `tm rules add -y` auto-detects and installs rules without prompting -- Detects 13 IDEs: Cursor, Claude Code, Windsurf, VS Code, Roo, Cline, Kiro, Zed, Kilo, Trae, Gemini, OpenCode, Codex diff --git a/.changeset/list-watch-compact.md b/.changeset/list-watch-compact.md deleted file mode 100644 index 3d273c7feb..0000000000 --- a/.changeset/list-watch-compact.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -"task-master-ai": minor ---- - -Add watch mode and compact output to list command - -- Add `-w/--watch` flag to continuously monitor task changes with real-time updates -- Add `-c/--compact` flag for minimal task output format -- Add `--no-header` flag to hide the command header -- Support file-based watching via fs.watch for local tasks.json -- Support API-based watching via Supabase Realtime for authenticated users -- Display last sync timestamp and source in watch mode diff --git a/.changeset/pre.json b/.changeset/pre.json deleted file mode 100644 index f08e94207f..0000000000 --- a/.changeset/pre.json +++ /dev/null @@ -1,23 +0,0 @@ -{ - "mode": "exit", - "tag": "rc", - "initialVersions": { - "task-master-ai": "0.39.0", - "@tm/cli": "", - "docs": "0.0.15", - "extension": "0.26.0", - "@tm/mcp": "", - "@tm/ai-sdk-provider-grok-cli": "", - "@tm/build-config": "", - "@tm/claude-code-plugin": "0.0.9", - "@tm/bridge": "", - "@tm/core": "", - "@tm/profiles": "" - }, - "changesets": [ - "floppy-books-feel", - "frank-ears-remain", - "gold-tigers-tap", - "list-watch-compact" - ] -} diff --git a/CHANGELOG.md b/CHANGELOG.md index 098e5e5667..2041934fae 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,28 @@ # task-master-ai +## 0.40.0 + +### Minor Changes + +- [#1538](https://github.com/eyaltoledano/claude-task-master/pull/1538) [`a2d5639`](https://github.com/eyaltoledano/claude-task-master/commit/a2d563991dd8ad6b8a9b76d0d43eac7a6156dd97) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Added Gemini 3 Flash Preview model support for Google and Gemini CLI providers + +- [#1535](https://github.com/eyaltoledano/claude-task-master/pull/1535) [`4d1ed20`](https://github.com/eyaltoledano/claude-task-master/commit/4d1ed20345083ab2ec1c7fc268c69379281a68ea) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Add auto-detection for IDE profiles in rules command + - `tm rules add` now opens interactive setup with detected IDEs pre-selected + - `tm rules add -y` auto-detects and installs rules without prompting + - Detects 13 IDEs: Cursor, Claude Code, Windsurf, VS Code, Roo, Cline, Kiro, Zed, Kilo, Trae, Gemini, OpenCode, Codex + +- [#1526](https://github.com/eyaltoledano/claude-task-master/pull/1526) [`38c2c08`](https://github.com/eyaltoledano/claude-task-master/commit/38c2c08af1f8de729d5d2dab586ec4622445f2db) Thanks [@eyaltoledano](https://github.com/eyaltoledano)! - Add watch mode and compact output to list command + - Add `-w/--watch` flag to continuously monitor task changes with real-time updates + - Add `-c/--compact` flag for minimal task output format + - Add `--no-header` flag to hide the command header + - Support file-based watching via fs.watch for local tasks.json + - Support API-based watching via Supabase Realtime for authenticated users + - Display last sync timestamp and source in watch mode + +### Patch Changes + +- [#1538](https://github.com/eyaltoledano/claude-task-master/pull/1538) [`a2d5639`](https://github.com/eyaltoledano/claude-task-master/commit/a2d563991dd8ad6b8a9b76d0d43eac7a6156dd97) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Improved model search in `task-master models --setup` to match both display names and model IDs + ## 0.40.0-rc.0 ### Minor Changes diff --git a/apps/cli/CHANGELOG.md b/apps/cli/CHANGELOG.md index d6d25a906e..ea102e9813 100644 --- a/apps/cli/CHANGELOG.md +++ b/apps/cli/CHANGELOG.md @@ -39,6 +39,13 @@ ### Patch Changes +- Updated dependencies []: + - @tm/core@null + +## null + +### Patch Changes + - [#1396](https://github.com/eyaltoledano/claude-task-master/pull/1396) [`9883e83`](https://github.com/eyaltoledano/claude-task-master/commit/9883e83b78306e55003e960ea072a11048d89ec9) Thanks [@bjcoombs](https://github.com/bjcoombs)! - Fix box title alignment by adding emoji variant selector to warning sign - Updated dependencies []: diff --git a/apps/docs/CHANGELOG.md b/apps/docs/CHANGELOG.md index fa2ad2497d..91145d5b4f 100644 --- a/apps/docs/CHANGELOG.md +++ b/apps/docs/CHANGELOG.md @@ -1,5 +1,7 @@ # docs +## 0.0.16 + ## 0.0.15 ## 0.0.14 diff --git a/apps/docs/package.json b/apps/docs/package.json index ef84b931e7..1fd574867d 100644 --- a/apps/docs/package.json +++ b/apps/docs/package.json @@ -1,6 +1,6 @@ { "name": "docs", - "version": "0.0.15", + "version": "0.0.16", "private": true, "description": "Task Master documentation powered by Mintlify", "scripts": { diff --git a/apps/extension/package.json b/apps/extension/package.json index 018ed92764..09bf01a003 100644 --- a/apps/extension/package.json +++ b/apps/extension/package.json @@ -275,7 +275,7 @@ "tailwindcss": "4.1.11", "typescript": "^5.9.2", "@tm/core": "*", - "task-master-ai": "0.40.0-rc.0" + "task-master-ai": "*" }, "overrides": { "glob@<8": "^10.4.5", diff --git a/apps/mcp/CHANGELOG.md b/apps/mcp/CHANGELOG.md index 7bd388df8b..19e030c4f2 100644 --- a/apps/mcp/CHANGELOG.md +++ b/apps/mcp/CHANGELOG.md @@ -62,3 +62,10 @@ - Updated dependencies []: - @tm/core@null + +## null + +### Patch Changes + +- Updated dependencies []: + - @tm/core@null diff --git a/package-lock.json b/package-lock.json index 1885105741..e422564c2e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "task-master-ai", - "version": "0.39.0", + "version": "0.40.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "task-master-ai", - "version": "0.39.0", + "version": "0.40.0", "license": "MIT WITH Commons-Clause", "workspaces": [ "apps/*", @@ -162,7 +162,7 @@ "license": "MIT" }, "apps/docs": { - "version": "0.0.15", + "version": "0.0.16", "devDependencies": { "mintlify": "^4.2.243" } @@ -36284,7 +36284,7 @@ }, "packages/claude-code-plugin": { "name": "@tm/claude-code-plugin", - "version": "0.0.9", + "version": "0.0.10", "license": "MIT WITH Commons-Clause" }, "packages/tm-bridge": { diff --git a/package.json b/package.json index e20190dcd9..a537e27fa3 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "task-master-ai", - "version": "0.40.0-rc.0", + "version": "0.40.0", "description": "A task management system for ambitious AI-driven development that doesn't overwhelm and confuse Cursor.", "main": "index.js", "type": "module", diff --git a/packages/ai-sdk-provider-grok-cli/CHANGELOG.md b/packages/ai-sdk-provider-grok-cli/CHANGELOG.md index 01d79d3a27..261b0f175f 100644 --- a/packages/ai-sdk-provider-grok-cli/CHANGELOG.md +++ b/packages/ai-sdk-provider-grok-cli/CHANGELOG.md @@ -19,3 +19,5 @@ ## null ## null + +## null diff --git a/packages/build-config/CHANGELOG.md b/packages/build-config/CHANGELOG.md index 08fa0f4d2f..3436b66245 100644 --- a/packages/build-config/CHANGELOG.md +++ b/packages/build-config/CHANGELOG.md @@ -22,4 +22,6 @@ ## null +## null + ## 1.0.1 diff --git a/packages/claude-code-plugin/CHANGELOG.md b/packages/claude-code-plugin/CHANGELOG.md index b8ca7eeb2a..b403bd7359 100644 --- a/packages/claude-code-plugin/CHANGELOG.md +++ b/packages/claude-code-plugin/CHANGELOG.md @@ -1,5 +1,7 @@ # @tm/claude-code-plugin +## 0.0.10 + ## 0.0.9 ## 0.0.8 diff --git a/packages/claude-code-plugin/package.json b/packages/claude-code-plugin/package.json index 9f0cbc6b31..ff9592f7c7 100644 --- a/packages/claude-code-plugin/package.json +++ b/packages/claude-code-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@tm/claude-code-plugin", - "version": "0.0.9", + "version": "0.0.10", "description": "Task Master AI plugin for Claude Code - AI-powered task management with commands, agents, and MCP integration", "type": "module", "private": true, diff --git a/packages/tm-bridge/CHANGELOG.md b/packages/tm-bridge/CHANGELOG.md index ec5983d71c..a0614ac050 100644 --- a/packages/tm-bridge/CHANGELOG.md +++ b/packages/tm-bridge/CHANGELOG.md @@ -48,3 +48,10 @@ - Updated dependencies []: - @tm/core@null + +## null + +### Patch Changes + +- Updated dependencies []: + - @tm/core@null diff --git a/packages/tm-core/CHANGELOG.md b/packages/tm-core/CHANGELOG.md index 13419ae833..b71f5af242 100644 --- a/packages/tm-core/CHANGELOG.md +++ b/packages/tm-core/CHANGELOG.md @@ -22,6 +22,8 @@ ## null +## null + ## 0.26.1 All notable changes to the @task-master/tm-core package will be documented in this file. diff --git a/packages/tm-profiles/CHANGELOG.md b/packages/tm-profiles/CHANGELOG.md index 851a30995e..5f9e127467 100644 --- a/packages/tm-profiles/CHANGELOG.md +++ b/packages/tm-profiles/CHANGELOG.md @@ -3,3 +3,5 @@ ## null ## null + +## null From 8d4ac0b6469c5a7029c1031926e8c12aaee189d4 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 28 Dec 2025 10:04:41 +0100 Subject: [PATCH 2/3] Version Packages (#1551) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Ralph Khreish <35776126+Crunchyman-ralph@users.noreply.github.com> --- .changeset/afraid-rocks-add.md | 8 -------- .changeset/hip-pots-study.md | 5 ----- .changeset/lazy-lies-argue.md | 9 --------- .changeset/new-grapes-accept.md | 7 ------- .changeset/violet-colts-sip.md | 5 ----- CHANGELOG.md | 20 ++++++++++++++++++++ package-lock.json | 4 ++-- package.json | 2 +- 8 files changed, 23 insertions(+), 37 deletions(-) delete mode 100644 .changeset/afraid-rocks-add.md delete mode 100644 .changeset/hip-pots-study.md delete mode 100644 .changeset/lazy-lies-argue.md delete mode 100644 .changeset/new-grapes-accept.md delete mode 100644 .changeset/violet-colts-sip.md diff --git a/.changeset/afraid-rocks-add.md b/.changeset/afraid-rocks-add.md deleted file mode 100644 index 3d1d13c443..0000000000 --- a/.changeset/afraid-rocks-add.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -"task-master-ai": patch ---- - -Codex cli Validate reasoning effort against model capabilities - -- Add provider-level reasoning effort validation for OpenAI models -- Automatically cap unsupported effort levels (e.g., 'xhigh' on gpt-5.1 and gpt-5 becomes 'high') diff --git a/.changeset/hip-pots-study.md b/.changeset/hip-pots-study.md deleted file mode 100644 index ad87130f2e..0000000000 --- a/.changeset/hip-pots-study.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"task-master-ai": patch ---- - -Improve CLI startup speed by 2x diff --git a/.changeset/lazy-lies-argue.md b/.changeset/lazy-lies-argue.md deleted file mode 100644 index 979b7e1e59..0000000000 --- a/.changeset/lazy-lies-argue.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -"task-master-ai": patch ---- - -Smarter project root detection with boundary markers - -- Prevents Task Master from incorrectly detecting `.taskmaster` folders in your home directory when working inside a different project -- Now stops at project boundaries (`.git`, `package.json`, lock files) instead of searching all the way up to the filesystem root -- Adds support for monorepo markers (`lerna.json`, `nx.json`, `turbo.json`) and additional lock files (`bun.lockb`, `deno.lock`) diff --git a/.changeset/new-grapes-accept.md b/.changeset/new-grapes-accept.md deleted file mode 100644 index 28bf604f37..0000000000 --- a/.changeset/new-grapes-accept.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -"task-master-ai": patch ---- - -Improve json schemas for ai-related commands making it more compatible with openai models - -- Fixes #1541 #1542 diff --git a/.changeset/violet-colts-sip.md b/.changeset/violet-colts-sip.md deleted file mode 100644 index 1d67d4e222..0000000000 --- a/.changeset/violet-colts-sip.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"task-master-ai": patch ---- - -Fixed vertex-ai authentication when using service account and vertex location env variable. diff --git a/CHANGELOG.md b/CHANGELOG.md index 2041934fae..513691af88 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,25 @@ # task-master-ai +## 0.40.1 + +### Patch Changes + +- [#1523](https://github.com/eyaltoledano/claude-task-master/pull/1523) [`fc1a79f`](https://github.com/eyaltoledano/claude-task-master/commit/fc1a79f2565b0d8c24f009aec2c473a335262ae2) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Codex cli Validate reasoning effort against model capabilities + - Add provider-level reasoning effort validation for OpenAI models + - Automatically cap unsupported effort levels (e.g., 'xhigh' on gpt-5.1 and gpt-5 becomes 'high') + +- [#1549](https://github.com/eyaltoledano/claude-task-master/pull/1549) [`98087ac`](https://github.com/eyaltoledano/claude-task-master/commit/98087acae91fad7345bdb4c253d4dfd0d584f81e) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Improve CLI startup speed by 2x + +- [#1545](https://github.com/eyaltoledano/claude-task-master/pull/1545) [`a0007a3`](https://github.com/eyaltoledano/claude-task-master/commit/a0007a3575305c367c8561584aa0dbd181f5e1cc) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Smarter project root detection with boundary markers + - Prevents Task Master from incorrectly detecting `.taskmaster` folders in your home directory when working inside a different project + - Now stops at project boundaries (`.git`, `package.json`, lock files) instead of searching all the way up to the filesystem root + - Adds support for monorepo markers (`lerna.json`, `nx.json`, `turbo.json`) and additional lock files (`bun.lockb`, `deno.lock`) + +- [#1523](https://github.com/eyaltoledano/claude-task-master/pull/1523) [`fc1a79f`](https://github.com/eyaltoledano/claude-task-master/commit/fc1a79f2565b0d8c24f009aec2c473a335262ae2) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Improve json schemas for ai-related commands making it more compatible with openai models + - Fixes #1541 #1542 + +- [#1542](https://github.com/eyaltoledano/claude-task-master/pull/1542) [`b817d6f`](https://github.com/eyaltoledano/claude-task-master/commit/b817d6f9f278c84785ec468f9b305e70c47266f6) Thanks [@mdimitrovg](https://github.com/mdimitrovg)! - Fixed vertex-ai authentication when using service account and vertex location env variable. + ## 0.40.0 ### Minor Changes diff --git a/package-lock.json b/package-lock.json index 1888b1cbf0..70929e9d49 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "task-master-ai", - "version": "0.40.0", + "version": "0.40.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "task-master-ai", - "version": "0.40.0", + "version": "0.40.1", "license": "MIT WITH Commons-Clause", "workspaces": [ "apps/*", diff --git a/package.json b/package.json index a537e27fa3..61a4da97fb 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "task-master-ai", - "version": "0.40.0", + "version": "0.40.1", "description": "A task management system for ambitious AI-driven development that doesn't overwhelm and confuse Cursor.", "main": "index.js", "type": "module", From 78115616aebb628c69dd0a1bcdf3f5038568276f Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Fri, 2 Jan 2026 11:57:26 +0000 Subject: [PATCH 3/3] docs: consolidate Claude Code documentation and fix confusion MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixes #1550 This PR addresses the documentation chaos reported in issue #1550 by: 1. Creating a comprehensive Claude Code setup guide at apps/docs/integrations/claude-code.mdx that: - Clearly explains all 3 integration options (MCP Server, Plugin, Provider) - Includes a comparison table to help users choose the right option - Clarifies the naming confusion between task-master-ai (MCP package) and task-master (CLI) - Provides comprehensive troubleshooting for common issues 2. Simplifying README.md: - Consolidated duplicate Claude Code installation sections - Added prominent links to the comprehensive guide - Reduced confusion by pointing to single source of truth 3. Updating documentation navigation: - Added new 'Integrations' section to docs.json - Made Claude Code guide easily discoverable 4. Deprecating redundant documentation: - Added deprecation notices to docs/claude-code-integration.md - Added deprecation notices to docs/examples/claude-code-usage.md - Both files now point to the new consolidated guide 5. Adding context to existing files: - Explained CLAUDE.md auto-load purpose - Clarified CLAUDE_CODE_PLUGIN.md is for plugin users - Added setup guide link to TM_COMMANDS_GUIDE.md This creates a single landing page (docs.task-master.dev/integrations/claude-code) that new users can reference, eliminating the confusion from multiple installation methods scattered across 5+ different files. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Ralph Khreish --- .claude/TM_COMMANDS_GUIDE.md | 4 + CLAUDE.md | 4 + CLAUDE_CODE_PLUGIN.md | 6 +- README.md | 30 ++- apps/docs/docs.json | 4 + apps/docs/integrations/claude-code.mdx | 254 +++++++++++++++++++++++++ docs/claude-code-integration.md | 10 +- docs/examples/claude-code-usage.md | 10 +- 8 files changed, 300 insertions(+), 22 deletions(-) create mode 100644 apps/docs/integrations/claude-code.mdx diff --git a/.claude/TM_COMMANDS_GUIDE.md b/.claude/TM_COMMANDS_GUIDE.md index c88bcb1c26..e21709fcce 100644 --- a/.claude/TM_COMMANDS_GUIDE.md +++ b/.claude/TM_COMMANDS_GUIDE.md @@ -1,5 +1,9 @@ # Task Master Commands for Claude Code +> 📖 **New to Claude Code + Task Master?** See the [Complete Claude Code Setup Guide](https://docs.task-master.dev/integrations/claude-code) for installation options. + +This guide is specifically for users who have installed the **Task Master plugin** and want to use slash commands. + Complete guide to using Task Master through Claude Code's slash commands. ## Overview diff --git a/CLAUDE.md b/CLAUDE.md index 58f3dec95d..528b261274 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,5 +1,9 @@ # Claude Code Instructions +> **What is this file?** This file is auto-loaded by Claude Code to provide context about this project's development guidelines. +> +> 📖 **Setting up Claude Code + Task Master?** See the [Complete Setup Guide](https://docs.task-master.dev/integrations/claude-code) + ## Task Master AI Instructions **Import Task Master's development workflow commands and guidelines, treat as if import is in the main CLAUDE.md file.** diff --git a/CLAUDE_CODE_PLUGIN.md b/CLAUDE_CODE_PLUGIN.md index 8eec073ca7..6e993fe3dd 100644 --- a/CLAUDE_CODE_PLUGIN.md +++ b/CLAUDE_CODE_PLUGIN.md @@ -1,6 +1,8 @@ -# Taskmaster AI - Claude Code Marketplace +# Taskmaster AI - Claude Code Plugin Marketplace -This repository includes a Claude Code plugin marketplace in `.claude-plugin/marketplace.json`. +> 📖 **Looking for Claude Code setup?** See the [Complete Claude Code Setup Guide](https://docs.task-master.dev/integrations/claude-code) for all integration options (MCP, Plugin, Provider). + +This document is specifically for **plugin marketplace** installation. The repository includes a Claude Code plugin marketplace in `.claude-plugin/marketplace.json`. ## Installation diff --git a/README.md b/README.md index 487b30dff8..ffed2dbb88 100644 --- a/README.md +++ b/README.md @@ -60,17 +60,18 @@ The following documentation is also available in the `docs` directory: > **Note:** After clicking the link, you'll still need to add your API keys to the configuration. The link installs the MCP server with placeholder keys that you'll need to replace with your actual API keys. -#### Claude Code Quick Install +#### Claude Code Setup -For Claude Code users: +For Claude Code users, we offer multiple integration options: ```bash +# Quick MCP install claude mcp add taskmaster-ai -- npx -y task-master-ai ``` -Don't forget to add your API keys to the configuration: -- in the root .env of your Project -- in the "env" section of your mcp config for taskmaster-ai +📖 **[Complete Claude Code Setup Guide](https://docs.task-master.dev/integrations/claude-code)** - Learn about MCP server, plugin marketplace, and Claude Code provider options. + +> **Note:** `task-master-ai` is the MCP server package name. The CLI command is `task-master`. ## Requirements @@ -320,20 +321,15 @@ Add `TASK_MASTER_TOOLS` to your MCP configuration file's `env` section: } ``` -#### Method 2: Claude Code CLI (One-Time Setup) +#### Method 2: Claude Code CLI -For Claude Code users, you can set the mode during installation: +For Claude Code users, you can set the mode during installation. See the [Complete Claude Code Setup Guide](https://docs.task-master.dev/integrations/claude-code) for details. ```bash # Core mode example (~70% token reduction) claude mcp add task-master-ai --scope user \ --env TASK_MASTER_TOOLS="core" \ -- npx -y task-master-ai@latest - -# Custom tools example -claude mcp add task-master-ai --scope user \ - --env TASK_MASTER_TOOLS="get_tasks,next_task,set_task_status" \ - -- npx -y task-master-ai@latest ``` ### Tool Sets Details @@ -353,13 +349,13 @@ claude mcp add task-master-ai --scope user \ ## Claude Code Support -Task Master now supports Claude models through the Claude Code CLI, which requires no API key: +Task Master offers comprehensive Claude Code integration: -- **Models**: `claude-code/opus` and `claude-code/sonnet` -- **Requirements**: Claude Code CLI installed -- **Benefits**: No API key needed, uses your local Claude instance +- **MCP Server**: Natural language task management in chat +- **Plugin**: 49 slash commands for quick workflows +- **Provider**: Use Claude Code models (no API key required) -[Learn more about Claude Code setup](docs/examples/claude-code-usage.md) +📖 **[Complete Claude Code Setup Guide](https://docs.task-master.dev/integrations/claude-code)** - Choose the best option for your workflow. ## Troubleshooting diff --git a/apps/docs/docs.json b/apps/docs/docs.json index 3ac77073c5..29560f2745 100644 --- a/apps/docs/docs.json +++ b/apps/docs/docs.json @@ -53,6 +53,10 @@ "capabilities/task-structure" ] }, + { + "group": "Integrations", + "pages": ["integrations/claude-code"] + }, { "group": "AI Providers", "pages": ["providers/azure"] diff --git a/apps/docs/integrations/claude-code.mdx b/apps/docs/integrations/claude-code.mdx new file mode 100644 index 0000000000..ae840ac87a --- /dev/null +++ b/apps/docs/integrations/claude-code.mdx @@ -0,0 +1,254 @@ +--- +title: Claude Code Setup +sidebarTitle: "Claude Code" +description: "Complete guide to using Task Master with Claude Code" +--- + +# Claude Code Integration + +Task Master works seamlessly with Claude Code through multiple integration methods. This guide consolidates all Claude Code setup options in one place. + +## Understanding the Options + +Task Master offers **three ways** to integrate with Claude Code: + +1. **MCP Server** (Recommended) - Use `task-master-ai` MCP server for AI-powered task management +2. **Plugin Marketplace** - Install Task Master plugin with slash commands +3. **Claude Code Provider** - Use Claude Code's local models (no API key needed) + + +**Package naming clarity:** +- `task-master-ai` = The MCP server package (what you install via `npx`) +- `task-master` = The CLI command (what you run in terminal) +- These are the same package, just different names for different contexts + + +--- + +## Option 1: MCP Server (Recommended) + +The MCP server lets Claude Code directly manage your tasks through natural language. + +### Quick Install + +```bash +claude mcp add taskmaster-ai -- npx -y task-master-ai +``` + +### What You Get + +- Direct task management from Claude Code chat +- AI-powered PRD parsing, task expansion, and complexity analysis +- Natural language task queries and updates +- 7-44 MCP tools (configurable) + +### Configuration + +After installation, add your API keys to `.mcp.json`: + +```json +{ + "mcpServers": { + "task-master-ai": { + "command": "npx", + "args": ["-y", "task-master-ai"], + "env": { + "TASK_MASTER_TOOLS": "core", // Options: "core", "standard", "all" + "ANTHROPIC_API_KEY": "YOUR_KEY_HERE", + "PERPLEXITY_API_KEY": "YOUR_KEY_HERE" + } + } + } +} +``` + +### Tool Loading Modes + +Control which tools are loaded to optimize context usage: + +| Mode | Tools | Use Case | +|------|-------|----------| +| `core` | 7 | Daily development workflow | +| `standard` | 15 | Common task management | +| `all` | 44+ | Full feature set | + +See the [MCP Tools documentation](/capabilities/mcp#configurable-tool-loading) for details. + +### Usage Examples + +Once configured, interact with Task Master naturally in Claude Code: + +``` +You: Parse my PRD at .taskmaster/docs/prd.md +You: What's the next task I should work on? +You: Show me task 1.2 details +You: Mark task 1.2 as done +You: Expand task 3 into subtasks +``` + +--- + +## Option 2: Plugin Marketplace + +The plugin provides 49 slash commands and 3 specialized AI agents for comprehensive task management. + +### Installation + +```bash +# Add the marketplace +/plugin marketplace add eyaltoledano/claude-task-master + +# Install the plugin +/plugin install taskmaster@taskmaster +``` + +### What You Get + +- 49 slash commands organized by category +- Quick commands like `/tm:next`, `/tm:list`, `/tm:show` +- Setup commands like `/tm:init`, `/tm:parse-prd` +- Workflow automation with `/tm:workflows/*` + +### Quick Start Commands + +```bash +/tm:init # Initialize project +/tm:parse-prd # Parse requirements +/tm:next # Get next task +/tm:set-status/to-done 1.2 # Mark task complete +``` + +See [Plugin Documentation](https://github.com/eyaltoledano/claude-task-master/blob/main/CLAUDE_CODE_PLUGIN.md) for the complete command list. + +--- + +## Option 3: Claude Code Provider + +Use Claude Code's local models for Task Master AI operations (no API key required). + +### Setup + +1. Install and authenticate Claude Code CLI: +```bash +claude setup-token +``` + +2. Configure Task Master to use Claude Code: +```bash +task-master models --set-main claude-code/sonnet +``` + +Or update `.taskmaster/config.json`: + +```json +{ + "models": { + "main": "claude-code/sonnet", + "fallback": "claude-code/opus" + } +} +``` + +### Available Models + +- `claude-code/sonnet` - Claude 3.5 Sonnet +- `claude-code/opus` - Claude 3 Opus + +### Benefits + +- No API key required (uses your Claude Code authentication) +- Native structured outputs with schema compliance +- Works with all Task Master AI-powered commands + +### Usage + +Once configured, all Task Master commands automatically use Claude Code: + +```bash +task-master parse-prd .taskmaster/docs/prd.md +task-master expand --id=1 --research +task-master analyze-complexity +``` + +See [Claude Code Provider docs](/providers/claude-code) for advanced configuration. + +--- + +## Comparison: Which Option Should I Use? + +| Feature | MCP Server | Plugin | Provider | +|---------|------------|--------|----------| +| **Natural language in chat** | ✅ Yes | Limited | ❌ No | +| **Slash commands** | ❌ No | ✅ 49 commands | ❌ No | +| **No API key needed** | ❌ Requires API key | ❌ Requires API key | ✅ Yes | +| **AI-powered operations** | ✅ Yes | ✅ Yes | ✅ Yes | +| **Context optimization** | ✅ Configurable | ✅ Built-in | N/A | +| **Best for** | Chat-first workflow | Command-first workflow | Cost-conscious users | + + +**Recommended Setup:** Use **MCP Server + Claude Code Provider** together: +- MCP Server for natural language task management in chat +- Claude Code Provider to eliminate API key costs +- Best of both worlds! + + +--- + +## Troubleshooting + +### "0 tools enabled" in MCP settings + +**Solution:** Restart your editor and verify API keys are correctly configured in `.mcp.json`. + +### Confusion between task-master-ai and task-master + +- `task-master-ai` is the **MCP server package name** (used in npx commands) +- `task-master` is the **CLI command name** (used in terminal) +- They're the same package, just different contexts + +### Claude Code authentication failures + +```bash +# Re-authenticate +claude setup-token + +# Verify token +claude setup-token --verify +``` + +### Plugin not appearing + +```bash +# Update marketplace +/plugin marketplace update taskmaster + +# Reinstall +/plugin install taskmaster@taskmaster +``` + +--- + +## Next Steps + + + + Get started with Task Master in minutes + + + Complete MCP tools documentation + + + All CLI commands + + + Customize Task Master + + + +--- + +## Additional Resources + +- [Claude Code CLI Documentation](https://docs.anthropic.com/en/docs/claude-code) +- [Task Master Discord Community](https://discord.gg/taskmasterai) +- [GitHub Issues](https://github.com/eyaltoledano/claude-task-master/issues) diff --git a/docs/claude-code-integration.md b/docs/claude-code-integration.md index 62b6a0f389..ab06e87ceb 100644 --- a/docs/claude-code-integration.md +++ b/docs/claude-code-integration.md @@ -1,6 +1,12 @@ -# TODO: Move to apps/docs inside our documentation website +# ⚠️ DEPRECATED -# Claude Code Integration Guide +**This documentation has been moved and consolidated.** + +📖 **See the new comprehensive guide:** https://docs.task-master.dev/integrations/claude-code + +--- + +# Claude Code Integration Guide (Legacy) This guide covers how to use Task Master with Claude Code AI SDK integration for enhanced AI-powered development workflows. diff --git a/docs/examples/claude-code-usage.md b/docs/examples/claude-code-usage.md index 92349b9ad8..560eba23d6 100644 --- a/docs/examples/claude-code-usage.md +++ b/docs/examples/claude-code-usage.md @@ -1,4 +1,12 @@ -# Claude Code Provider Usage Example +# ⚠️ DEPRECATED + +**This documentation has been moved and consolidated.** + +📖 **See the new comprehensive guide:** https://docs.task-master.dev/integrations/claude-code + +--- + +# Claude Code Provider Usage Example (Legacy) The Claude Code provider allows you to use Claude models through the Claude Code CLI without requiring an API key.