🔧 Troubleshooting

/help--resources/troubleshooting

MCP server won't start

bash

lsof -i :3000
kill -9 <PID>
npx ruflo@latest mcp start

Agent spawn failures

bash

free -m
export CLAUDE_FLOW_MAX_AGENTS=5

Pattern search returning no results

bash

npx ruflo@latest hooks metrics
npx ruflo@latest hooks pretrain

Windows path issues

powershell

$env:CLAUDE_FLOW_MEMORY_PATH = "./data"
$env:CLAUDE_FLOW_MEMORY_PATH = "C:/Users/name/ruflo/data"

Permission denied errors

bash

sudo chown -R $(whoami) ~/.npm

High memory usage

bash

node --expose-gc node_modules/.bin/ruflo
export CLAUDE_FLOW_HNSW_M=8
export CLAUDE_FLOW_HNSW_EF=100