ros/claude-task-master
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
74a1abc3b29cca2d116abcd72be038467e45e73f
claude-task-master/assets/claude/commands/tm/setup/install-taskmaster.md
Joe Danziger 95c299df64 Unify and streamline profile system architecture (#853) 
* move claude rules and commands to assets/claude

* update claude profile to copy assets/claude to .claude

* fix formatting

* feat(profiles): Implement unified profile system

- Convert Claude and Codex profiles to use createProfile() factory
- Remove simple vs complex profile distinction in rule transformer
- Unify convertAllRulesToProfileRules() to handle all profiles consistently
- Fix mcpConfigPath construction in base-profile.js for null mcpConfigName
- Update terminology from 'simpleProfiles' to 'assetOnlyProfiles' throughout
- Ensure Claude .claude directory copying works in both CLI and MCP contexts
- All profiles now follow same execution flow with proper lifecycle functions

Changes:
- src/profiles/claude.js: Convert to createProfile() factory pattern
- src/profiles/codex.js: Convert to createProfile() factory pattern
- src/utils/rule-transformer.js: Unified profile handling logic
- src/utils/profiles.js: Remove simple profile categorization
- src/profiles/base-profile.js: Fix mcpConfigPath construction
- scripts/modules/commands.js: Update variable naming
- tests/: Update all tests for unified system and terminology

Fixes Claude profile asset copying issue in MCP context.
All tests passing (617 passed, 11 skipped).

* re-checkin claude files

* fix formatting

* chore: clean up test Claude rules files

* chore: add changeset for unified profile system

* add claude files back

* add changeset

* restore proper gitignore

* remove claude agents file from root

* remove incorrect doc

* simplify profiles and update tests

* update changeset

* update changeset

* remove profile specific code

* streamline profiles with defaults and update tests

* update changeset

* add newline at end of gitignore

* restore changes

* streamline profiles with defaults; update tests and add vscode test

* update rule profile tests

* update wording for clearer profile management

* refactor and clarify terminology

* use original projectRoot var name

* revert param desc

* use updated claude assets from neno

* add "YOUR_" before api key here

* streamline codex profile

* add gemini profile

* update gemini profile

* update tests

* relocate function

* update rules interactive setup Gemini desc

* remove duplicative code

* add comma
2025-07-09 13:22:11 +02:00

2.5 KiB
Raw Blame History

Check if Task Master is installed and install it if needed.

This command helps you get Task Master set up globally on your system.

Detection and Installation Process

  1. Check Current Installation

    # Check if task-master command exists
which task-master || echo "Task Master not found"

# Check npm global packages
npm list -g task-master-ai

  2. System Requirements Check

    # Verify Node.js is installed
node --version

# Verify npm is installed  
npm --version

# Check Node version (need 16+)

  3. Install Task Master Globally If not installed, run:

    npm install -g task-master-ai

  4. Verify Installation

    # Check version
task-master --version

# Verify command is available
which task-master

  5. Initial Setup

    # Initialize in current directory
task-master init

  6. Configure AI Provider Ensure you have at least one AI provider API key set:

    # Check current configuration
task-master models --status

# If no API keys found, guide setup
echo "You'll need at least one API key:"
echo "- ANTHROPIC_API_KEY for Claude"
echo "- OPENAI_API_KEY for GPT models"
echo "- PERPLEXITY_API_KEY for research"
echo ""
echo "Set them in your shell profile or .env file"

  7. Quick Test

    # Create a test PRD
echo "Build a simple hello world API" > test-prd.txt

# Try parsing it
task-master parse-prd test-prd.txt -n 3

Troubleshooting

If installation fails:

Permission Errors:

# Try with sudo (macOS/Linux)
sudo npm install -g task-master-ai

# Or fix npm permissions
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

Network Issues:

# Use different registry
npm install -g task-master-ai --registry https://registry.npmjs.org/

Node Version Issues:

# Install Node 18+ via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

Success Confirmation

Once installed, you should see:

✅ Task Master v0.16.2 (or higher) installed
✅ Command 'task-master' available globally
✅ AI provider configured
✅ Ready to use slash commands!

Try: /project:task-master:init your-prd.md

Next Steps

After installation:

  1. Run /project:utils:check-health to verify setup
  2. Configure AI providers with /project:task-master:models
  3. Start using Task Master commands!