mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-11-09 05:35:21 +09:00
- Reorganize v3/ into implementation/ subfolders: - planning/, architecture/, migration/, integration/ - security/, adrs/, research/, swarm-plans/ - Add 15-agent concurrent swarm implementation plans: - SWARM-OVERVIEW.md: Hierarchical mesh topology, 4 phases - AGENT-SPECIFICATIONS.md: 15 agent configs with capabilities - TDD-LONDON-SCHOOL-PLAN.md: Mock-first TDD methodology - BENCHMARK-OPTIMIZATION.md: Performance targets (2.49x-7.47x) - DEPLOYMENT-PLAN.md: Release strategy, CI/CD, rollback - GITHUB-ISSUE-TRACKING.md: Issue workflow with agent replies - Update .claude/settings.json with proper hooks format - Add bash aliases for claude --dangerously-skip-permissions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
Claude Flow Remote Setup Guide
Problem
When using npx claude-flow@alpha remotely, you may encounter:
ENOTEMPTYnpm cache errors- Version mismatch issues
- Missing
./claude-flow@alphawrapper after init ⭐ FIXED! - Hook functionality not working
Quick Fix
Method 1: One-line Installation
curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/main/install-remote.sh | bash
Method 2: Manual Installation
# Clear npm cache and reinstall
npm cache clean --force
npm uninstall -g claude-flow
npm install -g claude-flow@alpha --no-optional --legacy-peer-deps
# Verify and initialize
claude-flow --version
claude-flow init
Method 3: Local Development Setup
If you're working with the source code:
# From the claude-code-flow directory
npm pack
npm install -g ./claude-flow-*.tgz
claude-flow --version
Verification
Test that everything works:
# Check version
claude-flow --version
# Test hooks
claude-flow hooks notify --message "Setup complete" --level "success"
# Check system status
claude-flow status
# ⭐ NEW: Test wrapper creation
npx claude-flow@alpha init --force
ls -la ./claude-flow*
# Should show: ./claude-flow@alpha (executable)
./claude-flow@alpha --version
Troubleshooting
Cache Issues
npm cache clean --force
rm -rf ~/.npm/_npx
Permission Issues
sudo npm install -g claude-flow@alpha
# or use nvm to avoid sudo
Binary Not Found
# Check global bin directory
npm config get prefix
# Add to PATH if needed
export PATH="$(npm config get prefix)/bin:$PATH"
Remote Usage Tips
- Use stable alpha version:
claude-flow@alphainstead of specific versions - Clear cache first: Always run
npm cache clean --forcebefore installation - Use --legacy-peer-deps: Helps resolve dependency conflicts
- Test hooks immediately: Verify functionality after installation
Success Indicators
✅ claude-flow --version shows current version
✅ claude-flow status shows system running
✅ claude-flow hooks notify works without errors
✅ All commands available globally