Reported issues for ruv-swarm
Pod holds 10 of 10 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.
Back to ruv-swarm.
Most discussed
[Bug]: Invalid JSON Schema - daa_workflow_create 'steps' array missing 'items' property
Bug Description
The daa_workflow_create MCP tool has an invalid JSON Schema definition that causes errors when used with Claude models. The steps property is defined as an array but is missing the required items property.
Error Message
Invalid schema for function 'ruv-swarm_daa_workflow_create': In context=('properties', 'steps'), array schema missing items.
Root Cause
In ruv-swarm/npm/src/mcp-daa-tools.js, the inputSchema for daa_workflow_create is:
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/182) · 2026-02-01 · open · external user · 0 comments
### Bug: agent_metrics fails with 'neuralNetworks.map is not a function'
## Bug Description
The `agent_metrics` MCP tool fails with error:
MCP error -32603: MCP tool error: neuralNetworks.map is not a function
## Root Cause
In `src/mcp-tools-enhanced.js`, lines 2445 and 2448 call async methods from `SwarmPersistencePooled` **without `await`**:
```javascript
// Line 2445 - Missing await
const dbMetrics = this.persistence.getMetrics('agent', agent.id);
// Line 2448 - Missing await
const neuralNetworks = this.persistence.getAgentNeuralNetworks(agent.id);
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/181) · 2026-01-25 · open · external user · 0 comments
### [BUG] TypeError: agents is not iterable in RUV-Swarm loadSwarms method
# GitHub Issue Content
---
**Title:** [BUG] TypeError: agents is not iterable in RUV-Swarm loadSwarms method
## Bug Description
The RUV-Swarm MCP server crashes with a **TypeError: agents is not iterable** error when attempting to load swarm agents during swarm initialization. This occurs because of a missing `await` keyword when calling the async `getSwarmAgents()` method, causing the code to attempt iteration over a Promise object instead of an array.
## Environment Details
- **Package:*
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/180) · 2025-11-27 · open · external user · 0 comments
### [BUG] `neural_train` MCP tool called without required `agentId` parameter in tests
# Bug: `neural_train` MCP tool called without required `agentId` parameter in tests
## Description
The `neural_train` MCP tool is being called without the required `agentId` parameter in test files, causing validation errors. The MCP handler correctly validates and rejects these calls with error code -32603.
## Error Details
ruv-swarm:neural_train (MCP) (iterations: 15) Error: MCP error -32603: MCP tool error: agentId is required and must be a string
## Root Cause
The `neural_train
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/163) · 2025-07-22 · open · external user · 1 comment
### [BUG]
## 🐛 Bug Report
**Description:**
Unable to use ruv-swarm as an MCP tool inside Claude Code
**Steps to Reproduce:**
1. On MacOS install Claude Code using nvm with node 20.0.0
2. Switch Claude Code to local install
3. Log in using a Claude Max account
4. Use local install of ruv-swarm with --claude option
5. Install ruv-swarm using "claude mcp add ruv-swarm npx ruv-swarm mcp start"
**Expected Behavior:**
Type in /mcp and you see ruv-swarm as connected and ready to go
**Actual Behavior:**
Type
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/142) · 2025-07-11 · open · external user · 35 comments
### [BUG] Swarm Session Lost - Need Recovery and Persistence Improvements
## 🐛 Problem
The swarm session was lost, requiring manual restart and reconfiguration. This indicates issues with swarm persistence and session management.
## 📍 Symptoms
- MCP server showed ruv-swarm was configured but swarm session was inactive
- Had to manually restart swarm with `mcp__ruv-swarm__swarm_init`
- Agent spawning required manual reconfiguration
- No automatic session restoration
## 🔧 Root Cause Analysis
- Swarm sessions are not persistent across disconnections
- No automatic ses
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/137) · 2025-07-10 · open · external user · 2 comments
### DAA Memory Persistence Not Functional - Agents/Workflows Lost Between Sessions
# DAA Memory Persistence Not Functional - Agents/Workflows Lost Between Sessions
## Description
The DAA (Decentralized Autonomous Agents) system's memory persistence feature is not functioning as expected. While agents and workflows operate correctly within a session, all DAA state is lost when the session ends, requiring complete recreation in subsequent sessions.
## Current Behavior
1. `mcp__ruv-swarm__memory_usage` with `action: "store"` returns only memory size info, not confirmation
2.
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/83) · 2025-07-05 · open · external user · 0 comments
### 🐛 Terminal Views Not Displaying Data - WebSocket & API Integration Issues
## 🐛 Bug Report
### Description
Multiple terminal views are not displaying data properly due to WebSocket conflicts and missing API integrations.
### Issues Found
#### 1. **WebSocket Port Conflict (Port 4010)**
- Multiple instances of logger trying to start WebSocket server on same port
- Error: `EADDRINUSE: address already in use :::4010`
- **Fixed**: Modified `log-collector.ts` to not auto-start WebSocket server
#### 2. **Left Side Views Not Working**
- **Meme Launch View**: Shows empty ta
[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/82) · 2025-07-05 · open · external user · 0 comments
## Most recent
### MCP Server stdout pollution prevents JSON-RPC communication
## Issue Description
The `ruv-swarm` MCP server outputs logging messages on stdout, which prevents proper JSON-RPC communication with MCP clients.
## Problem
When running `npx ruv-swarm mcp start`, the server outputs various logs to stdout:
[ERROR] Failed to initialize pooled persistence {...} [ca426a4e...] [INFO] ruv-swarm MCP server starting in stdio mode [ca426a4e...] [INFO] Connection established {...} 🧠 Initializing ruv-swarm with WASM capabilities... ✅ WASM bindings loaded successf
Read the thread · 2025-10-17 · open · external user · 0 comments
[BUG] ruv-swarm MCP server exits or fails after 10s
🐛 Bug Report
Description: ruv-swarm MCP server starts and is supposedly available, but after a short while (less than 30s), it becomes unavailable. it seems like the process exits or stops responding to stdio. Experienced on existing projects, confirmed in isolation on a fresh repo.
Steps to Reproduce:
claude mcp add ruv-swarm npx ruv-swarm mcp start(also tested by building and installing frommainrather thannpx)claude/mcpshows ruv-swarm is connected- wait
Read the thread · 2025-07-12 · closed · external user · 0 comments
The remaining reports are on the project's issue tracker.