95c299df64
* 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
117 lines
2.5 KiB
Markdown
117 lines
2.5 KiB
Markdown
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**
|
|
```bash
|
|
# 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**
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
npm install -g task-master-ai
|
|
```
|
|
|
|
4. **Verify Installation**
|
|
```bash
|
|
# Check version
|
|
task-master --version
|
|
|
|
# Verify command is available
|
|
which task-master
|
|
```
|
|
|
|
5. **Initial Setup**
|
|
```bash
|
|
# Initialize in current directory
|
|
task-master init
|
|
```
|
|
|
|
6. **Configure AI Provider**
|
|
Ensure you have at least one AI provider API key set:
|
|
```bash
|
|
# 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**
|
|
```bash
|
|
# 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:**
|
|
```bash
|
|
# 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:**
|
|
```bash
|
|
# Use different registry
|
|
npm install -g task-master-ai --registry https://registry.npmjs.org/
|
|
```
|
|
|
|
**Node Version Issues:**
|
|
```bash
|
|
# 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! |