github/claude-task-master

Fork 0

mirror of https://github.com/eyaltoledano/claude-task-master.git synced 2026-04-03 00:09:22 -06:00

bug: Task Master Claude Code Integration - Incorrect Path Resolution for CLI Executable #132

New issue

Closed

opened 2025-10-14 15:43:18 -06:00 by navan · 0 comments

navan commented

2025-10-14 15:43:18 -06:00

Owner

Originally created by @chansearrington on 9/1/2025

Summary

Task Master CLI fails to create tasks when configured to use the claude-code provider for AI models due to an incorrect path resolution in the @anthropic-ai/claude-code npm package (v1.0.98). The package attempts to locate the CLI executable at a non-existent path (entrypoints/cli.js) when the actual file is in the package root directory.

Description

Task Master CLI fails to create tasks when configured to use the claude-code provider for AI models. The error indicates that the @anthropic-ai/claude-code npm package (v1.0.98) is looking for a file at an incorrect path (entrypoints/cli.js), when the actual CLI executable is located directly in the package root (cli.js). This appears to be a bug in the @anthropic-ai/claude-code package itself, where the SDK code at line 6515 of sdk.mjs is constructing an incorrect path.

Steps to Reproduce

Install Task Master globally: npm install -g task-master-ai
Initialize Task Master in a project: task-master init
Configure models to use claude-code provider (this is the default configuration)
Attempt to create a task with AI: task-master add-task --prompt="Test task"
Observe the error about Claude Code executable not found

Expected Behavior

Task Master should successfully create a task using the Claude Code integration when the @anthropic-ai/claude-code package is installed as an optional dependency.

Actual Behavior

The command fails with the following error:

Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?

The actual location of the CLI file is:

/opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/claude-code/cli.js

Error Logs

Full Error Output

✖ AI generation failed
Error: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?
Error adding task: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?

🏷️ tag: master
Creating task with AI using prompt: "Test task: Verify Task Master CLI functionality"
Priority: medium
[INFO] Adding new task with prompt: "Test task: Verify Task Master CLI functionality", Priority: medium, Dependencies: None, Research: false, ProjectRoot: /Users/chansearrington/GitHub/byfca-raffle
[INFO] Using tag context: master

╭──────────────────────────╮
│                          │
│   Creating New Task #1   │
│                          │
╰──────────────────────────╯

[INFO] Generating task data with AI with prompt:
Test task: Verify Task Master CLI functionality
[ERROR] Claude Code object generation failed: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? {"error":{"name":"AI_APICallError","url":"claude-code-cli://command","requestBodyValues":{"prompt":"You are a helpful assistant that creates well-structured tasks for a software development project. Generate a single new task based on the user's description, adhering strictly to the provided JSON sc"},"isRetryable":false,"data":{"promptExcerpt":"You are a helpful assistant that creates well-structured tasks for a software development project. Generate a single new task based on the user's description, adhering strictly to the provided JSON sc"}}}
[WARN] Attempt 1 failed for role main (generateObject / claude-code): Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?
[ERROR] Something went wrong on the provider side. Max retries reached for role main (generateObject / claude-code).
[ERROR] Service call failed for role main (Provider: claude-code, Model: opus): Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?
[ERROR] All roles in the sequence [main, fallback, research] failed.
[ERROR] Error generating task with AI: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?
[ERROR] Error adding task: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set?

Environment

Task Master version: 0.25.1
Node.js version: v24.3.0
npm version: 11.4.2
Operating system: macOS Darwin 24.6.0 (ARM64, Apple Silicon M1 Max)
IDE: Claude Code (current session)
@anthropic-ai/claude-code version: 1.0.98
Claude executable location: /opt/homebrew/bin/claude (installed and working)
Task Master installation path: /opt/homebrew/lib/node_modules/task-master-ai

Root Cause Analysis

Package Structure Issue

The @anthropic-ai/claude-code package has the following structure:

/opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/claude-code/
├── cli.js          # <-- Actual CLI executable location
├── LICENSE.md
├── package.json
├── README.md
├── sdk-tools.d.ts
├── sdk.d.ts
├── sdk.mjs         # <-- Contains the path resolution bug
├── vendor/
└── yoga.wasm

Code Analysis

Evidence of the issue in the claude-code package at line 6515 of sdk.mjs:

// Line 6515 in /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/claude-code/sdk.mjs
return join(dirname, "entrypoints", "cli.js");

This code attempts to find the CLI at:

.../node_modules/@anthropic-ai/entrypoints/cli.js  # Incorrect path

When it should be looking at:

.../node_modules/@anthropic-ai/claude-code/cli.js  # Correct path

Task Master Configuration

Current .taskmaster/config.json:

{
  "models": {
    "main": {
      "provider": "claude-code",
      "modelId": "opus",
      "maxTokens": 32000,
      "temperature": 0.2
    },
    "research": {
      "provider": "claude-code",
      "modelId": "opus",
      "maxTokens": 32000,
      "temperature": 0.1
    },
    "fallback": {
      "provider": "claude-code",
      "modelId": "sonnet",
      "maxTokens": 64000,
      "temperature": 0.2
    }
  }
}

Additional Context

The @anthropic-ai/claude-code package is properly installed as an optional dependency in Task Master's package.json
The Claude CLI executable is available globally at /opt/homebrew/bin/claude and works correctly when invoked directly
The issue is specifically in the sdk.mjs file of the claude-code package, which constructs an incorrect path
All Task Master model roles (main, research, fallback) are configured to use the claude-code provider, causing complete failure
No .env file exists in the project directory, so API keys aren't being used as an alternative

Potential Solutions

Solution 1: Fix in @anthropic-ai/claude-code Package (Preferred)

The @anthropic-ai/claude-code package needs to be updated to correctly resolve the CLI path:

// Current (incorrect):
return join(dirname, "entrypoints", "cli.js");

// Should be:
return join(dirname, "cli.js");

Solution 2: Task Master Workaround

Task Master could potentially work around this by:

Setting options.pathToClaudeCodeExecutable to point to the actual CLI location
Adding path resolution logic to handle this specific case
Implementing a fallback mechanism to search for the CLI in known locations

Solution 3: User Workaround (Immediate)

Users can work around this issue by:

Switching to API key-based providers instead of claude-code integration:

task-master models --set-main claude-3-5-sonnet-20241022
task-master models --set-fallback gpt-4o-mini
task-master models --set-research perplexity-llama-3.1-sonar-large-128k-online

Setting appropriate API keys in .env:

ANTHROPIC_API_KEY=your-key-here
OPENAI_API_KEY=your-key-here
PERPLEXITY_API_KEY=your-key-here

Impact

Affected Users: All Task Master users attempting to use the claude-code provider (default configuration)
Severity: High - Complete failure of AI-powered task creation features when using default configuration
Workaround Available: Yes - Users can switch to API key-based providers

This appears to be primarily an issue with the @anthropic-ai/claude-code npm package rather than Task Master itself
Task Master may want to consider adding clearer documentation about this limitation
Consider defaulting to a different provider until this issue is resolved

Recommendations

Immediate: Add documentation warning users about this issue with claude-code provider
Short-term: Implement a workaround in Task Master to handle the incorrect path
Long-term: Work with Anthropic team to fix the path resolution in the claude-code package
Alternative: Consider changing the default provider from claude-code to a more reliable option

References

Task Master GitHub: https://github.com/eyaltoledano/claude-task-master
Task Master npm package: https://www.npmjs.com/package/task-master-ai
@anthropic-ai/claude-code package: https://www.npmjs.com/package/@anthropic-ai/claude-code

*Originally created by @chansearrington on 9/1/2025* ## Summary Task Master CLI fails to create tasks when configured to use the `claude-code` provider for AI models due to an incorrect path resolution in the `@anthropic-ai/claude-code` npm package (v1.0.98). The package attempts to locate the CLI executable at a non-existent path (`entrypoints/cli.js`) when the actual file is in the package root directory. ## Description Task Master CLI fails to create tasks when configured to use the `claude-code` provider for AI models. The error indicates that the `@anthropic-ai/claude-code` npm package (v1.0.98) is looking for a file at an incorrect path (`entrypoints/cli.js`), when the actual CLI executable is located directly in the package root (`cli.js`). This appears to be a bug in the `@anthropic-ai/claude-code` package itself, where the SDK code at line 6515 of `sdk.mjs` is constructing an incorrect path. ## Steps to Reproduce 1. Install Task Master globally: `npm install -g task-master-ai` 2. Initialize Task Master in a project: `task-master init` 3. Configure models to use `claude-code` provider (this is the default configuration) 4. Attempt to create a task with AI: `task-master add-task --prompt="Test task"` 5. Observe the error about Claude Code executable not found ## Expected Behavior Task Master should successfully create a task using the Claude Code integration when the `@anthropic-ai/claude-code` package is installed as an optional dependency. ## Actual Behavior The command fails with the following error: ``` Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? ``` The actual location of the CLI file is: ``` /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/claude-code/cli.js ``` ## Error Logs ### Full Error Output ``` ✖ AI generation failed Error: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? Error adding task: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? 🏷️ tag: master Creating task with AI using prompt: "Test task: Verify Task Master CLI functionality" Priority: medium [INFO] Adding new task with prompt: "Test task: Verify Task Master CLI functionality", Priority: medium, Dependencies: None, Research: false, ProjectRoot: /Users/chansearrington/GitHub/byfca-raffle [INFO] Using tag context: master ╭──────────────────────────╮ │ │ │ Creating New Task #1 │ │ │ ╰──────────────────────────╯ [INFO] Generating task data with AI with prompt: Test task: Verify Task Master CLI functionality [ERROR] Claude Code object generation failed: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? {"error":{"name":"AI_APICallError","url":"claude-code-cli://command","requestBodyValues":{"prompt":"You are a helpful assistant that creates well-structured tasks for a software development project. Generate a single new task based on the user's description, adhering strictly to the provided JSON sc"},"isRetryable":false,"data":{"promptExcerpt":"You are a helpful assistant that creates well-structured tasks for a software development project. Generate a single new task based on the user's description, adhering strictly to the provided JSON sc"}}} [WARN] Attempt 1 failed for role main (generateObject / claude-code): Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? [ERROR] Something went wrong on the provider side. Max retries reached for role main (generateObject / claude-code). [ERROR] Service call failed for role main (Provider: claude-code, Model: opus): Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? [ERROR] All roles in the sequence [main, fallback, research] failed. [ERROR] Error generating task with AI: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? [ERROR] Error adding task: Claude Code API error during object generation: Claude Code executable not found at /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/entrypoints/cli.js. Is options.pathToClaudeCodeExecutable set? ``` ## Environment - **Task Master version:** 0.25.1 - **Node.js version:** v24.3.0 - **npm version:** 11.4.2 - **Operating system:** macOS Darwin 24.6.0 (ARM64, Apple Silicon M1 Max) - **IDE:** Claude Code (current session) - **@anthropic-ai/claude-code version:** 1.0.98 - **Claude executable location:** `/opt/homebrew/bin/claude` (installed and working) - **Task Master installation path:** `/opt/homebrew/lib/node_modules/task-master-ai` ## Root Cause Analysis ### Package Structure Issue The `@anthropic-ai/claude-code` package has the following structure: ``` /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/claude-code/ ├── cli.js # <-- Actual CLI executable location ├── LICENSE.md ├── package.json ├── README.md ├── sdk-tools.d.ts ├── sdk.d.ts ├── sdk.mjs # <-- Contains the path resolution bug ├── vendor/ └── yoga.wasm ``` ### Code Analysis Evidence of the issue in the claude-code package at line 6515 of `sdk.mjs`: ```javascript // Line 6515 in /opt/homebrew/lib/node_modules/task-master-ai/node_modules/@anthropic-ai/claude-code/sdk.mjs return join(dirname, "entrypoints", "cli.js"); ``` This code attempts to find the CLI at: ``` .../node_modules/@anthropic-ai/entrypoints/cli.js # Incorrect path ``` When it should be looking at: ``` .../node_modules/@anthropic-ai/claude-code/cli.js # Correct path ``` ### Task Master Configuration Current `.taskmaster/config.json`: ```json { "models": { "main": { "provider": "claude-code", "modelId": "opus", "maxTokens": 32000, "temperature": 0.2 }, "research": { "provider": "claude-code", "modelId": "opus", "maxTokens": 32000, "temperature": 0.1 }, "fallback": { "provider": "claude-code", "modelId": "sonnet", "maxTokens": 64000, "temperature": 0.2 } } } ``` ## Additional Context 1. The `@anthropic-ai/claude-code` package is properly installed as an optional dependency in Task Master's `package.json` 2. The Claude CLI executable is available globally at `/opt/homebrew/bin/claude` and works correctly when invoked directly 3. The issue is specifically in the `sdk.mjs` file of the claude-code package, which constructs an incorrect path 4. All Task Master model roles (main, research, fallback) are configured to use the `claude-code` provider, causing complete failure 5. No `.env` file exists in the project directory, so API keys aren't being used as an alternative ## Potential Solutions ### Solution 1: Fix in @anthropic-ai/claude-code Package (Preferred) The `@anthropic-ai/claude-code` package needs to be updated to correctly resolve the CLI path: ```javascript // Current (incorrect): return join(dirname, "entrypoints", "cli.js"); // Should be: return join(dirname, "cli.js"); ``` ### Solution 2: Task Master Workaround Task Master could potentially work around this by: 1. Setting `options.pathToClaudeCodeExecutable` to point to the actual CLI location 2. Adding path resolution logic to handle this specific case 3. Implementing a fallback mechanism to search for the CLI in known locations ### Solution 3: User Workaround (Immediate) Users can work around this issue by: 1. Switching to API key-based providers instead of claude-code integration: ```bash task-master models --set-main claude-3-5-sonnet-20241022 task-master models --set-fallback gpt-4o-mini task-master models --set-research perplexity-llama-3.1-sonar-large-128k-online ``` 2. Setting appropriate API keys in `.env`: ``` ANTHROPIC_API_KEY=your-key-here OPENAI_API_KEY=your-key-here PERPLEXITY_API_KEY=your-key-here ``` ## Impact - **Affected Users:** All Task Master users attempting to use the claude-code provider (default configuration) - **Severity:** High - Complete failure of AI-powered task creation features when using default configuration - **Workaround Available:** Yes - Users can switch to API key-based providers ## Related Issues - This appears to be primarily an issue with the `@anthropic-ai/claude-code` npm package rather than Task Master itself - Task Master may want to consider adding clearer documentation about this limitation - Consider defaulting to a different provider until this issue is resolved ## Recommendations 1. **Immediate:** Add documentation warning users about this issue with claude-code provider 2. **Short-term:** Implement a workaround in Task Master to handle the incorrect path 3. **Long-term:** Work with Anthropic team to fix the path resolution in the claude-code package 4. **Alternative:** Consider changing the default provider from claude-code to a more reliable option ## References - Task Master GitHub: https://github.com/eyaltoledano/claude-task-master - Task Master npm package: https://www.npmjs.com/package/task-master-ai - @anthropic-ai/claude-code package: https://www.npmjs.com/package/@anthropic-ai/claude-code