admin/ruflo

0 Fork 0

mirror of https://github.com/ruvnet/ruflo.git synced 2026-11-09 14:04:06 +09:00

Files

T

rUvandClaude 7895a490c4 🔧 Fix plugin structure and repository references

## Changes

### Repository References
- Fixed all references from `ruvnet/claude-code-flow` to `ruvnet/claude-flow`
- Updated 6 files in `.claude-plugin/`:
  - plugin.json
  - README.md
  - docs/STRUCTURE.md
  - docs/PLUGIN_SUMMARY.md
  - docs/INSTALLATION.md
  - docs/QUICKSTART.md

### Added marketplace.json
- Created `.claude-plugin/marketplace.json` with complete marketplace metadata
- Includes plugin features, requirements, and MCP server configuration
- Follows official Claude Code marketplace specification

### Fixed hooks structure
- Created `hooks/hooks.json` at root level (correct location per docs)
- Implements 7 hook events:
  - PreToolUse (Task, Write|Edit)
  - PostToolUse (Task, Write|Edit, Bash)
  - UserPromptSubmit
  - SessionStart
  - SessionEnd
  - Notification
  - SubagentStop
- Integrates with claude-flow coordination system

## Plugin Structure (Now Correct)
```
claude-flow/
├── .claude-plugin/
│   ├── plugin.json          ✓ Plugin metadata
│   ├── marketplace.json     ✓ Marketplace distribution
│   ├── README.md            ✓ Documentation
│   └── docs/                ✓ Additional docs
├── commands/                 ✓ Slash commands (root)
├── agents/                   ✓ Custom agents (root)
└── hooks/                    ✓ Event handlers (root)
    └── hooks.json
```

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-09 20:53:19 +00:00

2.1 KiB

Raw Blame History

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

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

2.1 KiB Raw Blame History