The RuFlo Stack: Turn Claude Code Into a Multi-Agent Powerhouse (Complete Setup Guide)

Apa Itu Ruflo?

Riwayat Security yang Perlu Lu Tahu

• Prompt injection lewat MCP tool descriptions: ada instruksi tersembunyi di deskripsi tool yang bisa mengarahkan Claude melakukan aksi yang user tidak minta.
• Obfuscated preinstall script: versi lama menyertakan script install yang menghapus file dari npm cache di luar package directory.
• SQL injection: ada query database di memory system yang belum diparameterisasi.
• Fake feature implementations: beberapa command seperti deploy, config, swarm, dan security scan dilaporkan mengembalikan data palsu atau hardcoded.

Apa yang Sudah Diperbaiki?

• Prompt injection di MCP tool descriptions sudah dihapus.
• Obfuscated preinstall script sudah dihapus.
• SQL query sudah diparameterisasi.
• npx sudah dihapus dari SafeExecutor allowlist.
• Beberapa stub feature sudah mulai diganti dengan implementasi nyata.

Yang Tetap Perlu Lu Cek

• Auto-attribution di commit: hook bisa menambahkan Co-Authored-By: claude-flow ke commit message.
• --dangerously-skip-permissions: beberapa workflow bisa mencoba menjalankan Claude Code tanpa permission check.
• Permission terlalu luas di .claude/settings.json, terutama Bash(npx:*).
• Wildcard MCP permission seperti mcp__claude-flow__*, mcp__ruv-swarm__*, atau mcp__flow-nexus__*.
• Command yang masih terasa seperti stub atau output yang terlalu “rapi” tapi tidak jelas sumber datanya.

Hardware dan Platform

• Mac Apple Silicon: supported. Kalau install script dimatikan, lu mungkin perlu rebuild SQLite native dependency secara manual.
• Mac Intel: supported.
• Windows: partial. Kalau npm bermasalah dengan native dependency, pertimbangkan pnpm.
• Linux x86 atau ARM: supported.

Safe Installation Steps

Step 1: Pakai Environment Sandbox

# Option A: Docker container (safest)
docker run -it --rm node:20 bash

# Option B: Dedicated project directory with no access to other repos
mkdir ~/ruflo-sandbox && cd ~/ruflo-sandbox

Step 2: Install Tanpa Menjalankan Install Scripts

npm install ruflo@latest --ignore-scripts

# If you need the ARM64 SQLite fix (Apple Silicon only)
npm rebuild better-sqlite3

Step 3: Jangan Jalankan Curl Installer Langsung

# DON'T DO THIS
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

# DO THIS INSTEAD: download and read it first
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh -o install.sh
cat install.sh  # READ IT

# Only run if you're comfortable with the contents

Step 4: Rapikan Generated Settings

// FIND AND REMOVE THIS LINE:
"Bash(npx:*)"

// FIND AND REMOVE OR SCOPE THESE:
"mcp__claude-flow__*",
"mcp__ruv-swarm__*",
"mcp__flow-nexus__*"

// FIND AND DELETE THIS BLOCK:
"attribution": {
  "commit": "Co-Authored-By: claude-flow <ruv@ruv.net>",
  "pr": "🤖 Generated with claude-flow"
}

Step 5: Jangan Pakai Dangerously Skip Permissions

Kalau Lu Sudah Terlanjur Install

• Buka GitHub repo settings dan cek collaborator/access list.
• Review folder .claude/ di project yang pernah lu init.
• Kalau ada perubahan hook atau settings yang lu tidak paham, matikan dulu.

# Check your version
npx ruflo --version

# Update
npm install ruflo@latest --ignore-scripts

# OR full uninstall + cleanup
npx ruflo cleanup --force
npm uninstall -g claude-flow ruflo @claude-flow/cli
rm -rf ~/.npm/_npx
rm -rf .claude/

# Check for unexpected co-author attributions
git log --all --format='%H %s %b' | grep -i "co-authored-by"

# Clean your npm cache
npm cache clean --force

Checklist

• Jangan install di mesin dengan repo sensitif atau production credential.
• Gunakan --ignore-scripts saat install.
• Jangan pipe remote installer langsung ke bash.
• Hapus Bash(npx:*) dan permission wildcard yang tidak perlu.
• Hapus auto-attribution kalau lu tidak mau commit message diubah.
• Jangan pakai --dangerously-skip-permissions untuk repo penting.
• Kalau pernah install versi lama, cek git history dan GitHub collaborators.

Bottom Line