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

bash

curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/main/install-remote.sh | bash

Method 2: Manual Installation

bash

# 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:

bash

# From the claude-code-flow directory
npm pack
npm install -g ./claude-flow-*.tgz
claude-flow --version

Verification

Test that everything works:

bash

# 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

bash

npm cache clean --force
rm -rf ~/.npm/_npx

Permission Issues

bash

sudo npm install -g claude-flow@alpha
# or use nvm to avoid sudo

Binary Not Found

bash

# 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@alpha instead of specific versions
Clear cache first: Always run npm cache clean --force before 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