Claude Swarm

SwarmSDK, SwarmCLI & SwarmMemory

[](https://badge.fury.io/rb/swarm_sdk) [](https://badge.fury.io/rb/swarm_cli) [](https://badge.fury.io/rb/swarm_memory) [](https://github.com/parruda/claude-swarm/actions/workflows/ci.yml)

**A Ruby framework for orchestrating multiple AI agents as a collaborative team with persistent memory.**

SwarmSDK is a complete redesign of Claude Swarm that provides a better developer experience and is geared towards general-purpose agentic systems.

✨ Key Features

• 🚀 Decoupled from Claude Code: No more dependency on Claude Code
• ⚡ Single Process Architecture: All agents run in one Ruby process using RubyLLM - no more managing multiple processes
• 🎯 More Efficient: Direct method calls instead of MCP inter-process communication
• 🔧 Richer Features: Node workflows, hooks system, scratchpad/memory tools, and more
• 🎮 Better Control: Fine-grained permissions, cost tracking, structured logging
• 💻 Interactive REPL: Built with TTY toolkit for a nice command-line experience
• 🌐 Multiple LLM Providers: Supports all LLM providers supported by RubyLLM (Claude, OpenAI, Gemini, etc.)
• 🧠 SwarmMemory: Persistent agent knowledge storage with semantic search and FAISS indexing
• 🔌 Plugin System: Extensible architecture for custom integrations

---

🚀 Quick Start

Installation

gem install swarm_cli     # Includes swarm_sdk
swarm --help              # Explore the modern CLI

Your First Swarm

Create a simple swarm configuration file `my_swarm.yml`:

version: 2
agents:
  lead:
    model: claude-3-5-sonnet-20241022
    role: "Lead developer coordinating development efforts"
    tools:
      - Read
      - Write
      - Edit
      - Bash
    delegates_to:
      - frontend
      - backend

  frontend:
    model: claude-3-5-sonnet-20241022
    role: "Frontend specialist handling UI and user experience"
    tools: [Read, Write, Edit]


...