Files
ruflo/v2/docs/setup/remote-setup.md
T
rUvandClaude Opus 4.5 1b6a1971f7 feat(v3): add comprehensive v3 implementation plans and swarm architecture
- 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>
2026-01-04 15:40:51 +00:00

2.1 KiB

Claude Flow Remote Setup Guide

Problem

When using npx claude-flow@alpha remotely, you may encounter:

  • ENOTEMPTY npm cache errors
  • Version mismatch issues
  • Missing ./claude-flow@alpha wrapper 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

  1. Use stable alpha version: claude-flow@alpha instead of specific versions
  2. Clear cache first: Always run npm cache clean --force before installation
  3. Use --legacy-peer-deps: Helps resolve dependency conflicts
  4. 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