Skip to content

fix: correct CLI command names for expand operations in llms-install.md#1659

Open
withsivram wants to merge 1 commit intoeyaltoledano:mainfrom
withsivram:fix/expand-task-cli-name
Open

fix: correct CLI command names for expand operations in llms-install.md#1659
withsivram wants to merge 1 commit intoeyaltoledano:mainfrom
withsivram:fix/expand-task-cli-name

Conversation

@withsivram
Copy link

@withsivram withsivram commented Mar 20, 2026

Summary

  • Fixes incorrect expand-task and expand-all references in llms-install.md to the actual CLI syntax: task-master expand --id=<id> and task-master expand --all
  • The MCP tool expand_task maps to the CLI expand command (not expand-task) — assets/AGENTS.md already documented this correctly, only llms-install.md had the wrong names

Test plan

  • Verify llms-install.md "Next Steps" section shows correct CLI commands
  • Confirm no other user-facing docs reference expand-task as a CLI command

Fixes #1640

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated CLI command syntax for task expansion operations to use the new task-master expand format with flag-based options.

…md (fixes eyaltoledano#1640)

The llms-install.md "Next Steps" section incorrectly listed `expand-task`
and `expand-all` as CLI command names. These are internal identifiers —
the actual CLI commands are `task-master expand --id=<id>` and
`task-master expand --all`.

The `expand_task` MCP tool maps to the `expand` CLI command (not
`expand-task`), and `expand_all` maps to `expand --all`. The
`assets/AGENTS.md` (which generates `.taskmaster/CLAUDE.md`) already
correctly documented this mapping; only llms-install.md had the wrong
command names in a user-facing context.

No other files contained incorrect CLI command references for these
operations — other occurrences of `expand-task` in the codebase are
internal command identifiers used for telemetry, schema lookup, and
prompt management (via `commandName: 'expand-task'`), not CLI commands.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings March 20, 2026 16:33
@changeset-bot
Copy link

changeset-bot bot commented Mar 20, 2026

⚠️ No Changeset found

Latest commit: 99222a5

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 20, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 46183b59-db1f-4387-ae58-dee1e2ad6e8e

📥 Commits

Reviewing files that changed from the base of the PR and between 2d1211b and 99222a5.

📒 Files selected for processing (1)
  • llms-install.md

📝 Walkthrough

Walkthrough

Documentation update correcting CLI command references in installation instructions. The changes replace outdated command names with the proper task-master expand subcommand syntax, aligning documented commands with actual CLI implementation.

Changes

Cohort / File(s) Summary
Documentation Update
llms-install.md
Updated "Next Steps" usage examples to reference correct task-master expand subcommand with --all and --id flags instead of outdated expand-all and expand-task command names.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and specifically summarizes the main change: correcting CLI command names for expand operations in llms-install.md documentation.
Linked Issues check ✅ Passed The PR successfully addresses issue #1640 by correcting the documented CLI commands from incorrect expand-task/expand-all to the actual correct syntax task-master expand with appropriate flags.
Out of Scope Changes check ✅ Passed The changes are narrowly scoped to documentation updates in llms-install.md as required by issue #1640; no unrelated code modifications are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the LLM installation guide to reflect the correct Task Master CLI syntax for task expansion, aligning the doc with the actual expand command used by the CLI and MCP tooling.

Changes:

  • Replaced incorrect expand-all / expand-task CLI references with task-master expand --all and task-master expand --id=<id> in the “Next Steps” section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Create new tasks with `add-task` or parse a PRD (scripts/prd.txt) into tasks with `parse-prd`
- Set up model preferences with `models` tool
- Expand tasks into subtasks with `expand-all` and `expand-task`
- Expand tasks into subtasks with `task-master expand --all` or `task-master expand --id=<id>`
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the "Next Steps" list, this bullet now uses the fully qualified CLI form (task-master expand ...) while the surrounding bullets use bare subcommand names (add-task, parse-prd, models). For consistency and to avoid confusing users about whether these are CLI subcommands or MCP tool names, please standardize the formatting (either prefix all of them with task-master, or remove the prefix here and keep only the subcommand/flags).

Suggested change
- Expand tasks into subtasks with `task-master expand --all` or `task-master expand --id=<id>`
- Expand tasks into subtasks with `expand --all` or `expand --id=<id>`

Copilot uses AI. Check for mistakes.
- Expand tasks into subtasks with `task-master expand --all` or `task-master expand --id=<id>`
- Explore advanced features like research mode and complexity analysis

For detailed documentation, refer to the Task Master docs directory.``
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There appear to be two stray backticks at the end of the sentence `For detailed documentation, refer to the Task Master docs directory.```. This breaks Markdown formatting; please remove the extra backticks so the paragraph renders correctly.

Suggested change
For detailed documentation, refer to the Task Master docs directory.``
For detailed documentation, refer to the Task Master docs directory.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bug: expand_task MCP tool maps to 'expand-task' but actual CLI command is 'expand'

2 participants