claude_swarm 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d905c9233bd290f36581e1507efcfb081c4c06e25182d84cf7fc1aa5fd167468
-  data.tar.gz: 666090b2014f5b451cb264bf4bffc658a6d543e1d4e074e7ccb0f9ab03e44327
+  metadata.gz: 868bb8a62ddb042e9971915da978ef619051be6ecdee7fb8b9a40678e11e2930
+  data.tar.gz: d8fdc4cbb9c6336a33d6e377b332a7e85511f594491aa1691f54a12ce76748f6
 SHA512:
-  metadata.gz: 6dd8b14d36a9ae772be13170fa28c30e85a93a02b5bfe6793294eca51d34520e02dc9d1ddefd5312cb2682472e6bcaa7dcb36213d28d6adf0b08852889117f36
-  data.tar.gz: d1762b2fd34da13e3262ebf82e3fd3576844c2487154c8b68a35f7e9ff270e96fa61f19a83e8488a8a2f630c96f6a61d78e827b352062cd695d5c656b06b9ca0
+  metadata.gz: f07b9ebdd1378f816d659d26ce68751fe9afd5ef79f98bc025d42e1a7fe88686ec7ca9b4bcd108047dc9e3d1a96b10446693a15f22ade0855c83a465278a5a0b
+  data.tar.gz: b43959ad4effb4c9bcfdd2cec0ac955b02f5303941ae313e0751f7dafb7a7a84ce86bb15d9e08b09cfc857329086473c4f6dcc0a5ebe3b87741721b9cb64997f

data/CHANGELOG.md

@@ -1,5 +1,5 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-05-24
+## [0.1.1] - 2025-05-24
 
 - Initial release

data/CLAUDE.md

@@ -76,14 +76,12 @@ swarm:
   main: lead
   instances:
     lead:
-      role: "Lead Developer"
       directory: .
       model: opus
       connections: [frontend, backend]
       prompt: "You are the lead developer coordinating the team"
       tools: [Read, Edit, Bash]
     frontend:
-      role: "Frontend Developer"
       directory: ./frontend
       model: sonnet
       prompt: "You specialize in frontend development with React"

data/README.md

@@ -1,6 +1,6 @@
 # Claude Swarm
 
-Claude Swarm orchestrates multiple Claude Code instances as a collaborative AI development team. It enables running AI agents with specialized roles, tools, and directory contexts, communicating via MCP (Model Context Protocol). Define your swarm topology in simple YAML and let Claude instances collaborate across codebases. Perfect for complex projects requiring specialized AI agents for frontend, backend, testing, DevOps, or research tasks.
+Claude Swarm orchestrates multiple Claude Code instances as a collaborative AI development team. It enables running AI agents with specialized roles, tools, and directory contexts, communicating via MCP (Model Context Protocol) in a tree-like hierarchy. Define your swarm topology in simple YAML and let Claude instances delegate tasks through connected instances. Perfect for complex projects requiring specialized AI agents for frontend, backend, testing, DevOps, or research tasks.
 
 ## Installation
 
@@ -32,7 +32,7 @@ bundle install
 
 ### Quick Start
 
-1. Create a `claude-swarm.yml` file in your project:
+1. Run `claude-swarm init` or create a `claude-swarm.yml` file in your project:
 
 ```yaml
 version: 1
@@ -41,16 +41,14 @@ swarm:
   main: lead
   instances:
     lead:
-      role: "Lead Developer"
       directory: .
       model: opus
       connections: [frontend, backend]
-      tools:
+      tools: # Tools aren't required if you run it with `--vibe`
         - Read
         - Edit
         - Bash
     frontend:
-      role: "Frontend Developer" 
       directory: ./frontend
       model: sonnet
       tools:
@@ -58,7 +56,6 @@ swarm:
         - Write
         - Bash
     backend:
-      role: "Backend Developer"
       directory: ./backend  
       model: sonnet
       tools:
@@ -72,14 +69,104 @@ swarm:
 ```bash
 claude-swarm
 ```
+or if you are feeling the vibes...
+```bash
+claude-swarm --vibe # That will allow ALL tools for all instances! Be Careful!
+```
 
 This will:
-- Generate MCP configuration files in `.claude-swarm/`
-- Create a shared session timestamp for centralized logging
 - Launch the main instance (lead) with connections to other instances
-- The lead instance can communicate with frontend and backend instances via MCP
+- The lead instance can communicate with the other instances via MCP
 - All instances log to `.claude-swarm/logs/session-{timestamp}/`
 
+#### Multi-Level Swarm Example
+
+Here's a more complex example showing specialized teams working on different parts of a project:
+
+```yaml
+version: 1
+swarm:
+  name: "Multi-Service Development Team"
+  main: architect
+  instances:
+    architect:
+      directory: .
+      model: opus
+      connections: [frontend_lead, backend_lead, mobile_lead, devops]
+      prompt: "You are the system architect coordinating between different service teams"
+      tools: [Read, Edit, WebSearch]
+    
+    frontend_lead:
+      directory: ./web-frontend
+      model: opus
+      connections: [react_dev, css_expert]
+      prompt: "You lead the web frontend team working with React"
+      tools: [Read, Edit, Bash]
+    
+    react_dev:
+      directory: ./web-frontend/src
+      model: sonnet
+      prompt: "You specialize in React components and state management"
+      tools: [Edit, Write, "Bash(npm:*)"]
+    
+    css_expert:
+      directory: ./web-frontend/styles
+      model: sonnet
+      prompt: "You handle all CSS and styling concerns"
+      tools: [Edit, Write, Read]
+    
+    backend_lead:
+      directory: ./api-server
+      model: opus
+      connections: [api_dev, database_expert]
+      prompt: "You lead the API backend team"
+      tools: [Read, Edit, Bash]
+    
+    api_dev:
+      directory: ./api-server/src
+      model: sonnet
+      prompt: "You develop REST API endpoints"
+      tools: [Edit, Write, Bash]
+    
+    database_expert:
+      directory: ./api-server/db
+      model: sonnet
+      prompt: "You handle database schema and migrations"
+      tools: [Edit, Write, "Bash(psql:*, migrate:*)"]
+    
+    mobile_lead:
+      directory: ./mobile-app
+      model: sonnet
+      connections: [ios_dev, android_dev]
+      prompt: "You coordinate mobile development across platforms"
+      tools: [Read, Edit]
+    
+    ios_dev:
+      directory: ./mobile-app/ios
+      model: sonnet
+      prompt: "You develop the iOS application"
+      tools: [Edit, Write, "Bash(xcodebuild:*, pod:*)"]
+    
+    android_dev:
+      directory: ./mobile-app/android
+      model: sonnet
+      prompt: "You develop the Android application"
+      tools: [Edit, Write, "Bash(gradle:*, adb:*)"]
+    
+    devops:
+      directory: ./infrastructure
+      model: sonnet
+      prompt: "You handle CI/CD and infrastructure"
+      tools: [Read, Edit, "Bash(docker:*, kubectl:*)"]
+```
+
+In this setup:
+- The architect (main instance) can delegate tasks to team leads
+- Each team lead can work with their specialized developers
+- Each instance is independent - connections create separate MCP server instances
+- Teams work in isolated directories with role-appropriate tools
+
+
 ### Configuration Format
 
 #### Top Level
@@ -97,7 +184,6 @@ swarm:
 
 Each instance can have:
 
-- **role**: Human-readable role description (defaults to instance name)
 - **directory**: Working directory for this instance (can use ~ for home)
 - **model**: Claude model to use (opus, sonnet, haiku)
 - **connections**: Array of other instances this one can communicate with
@@ -107,7 +193,6 @@ Each instance can have:
 
 ```yaml
 instance_name:
-  role: "Role Description"
   directory: ~/project/path
   model: opus
   connections: [other_instance1, other_instance2]
@@ -188,7 +273,6 @@ swarm:
   main: architect
   instances:
     architect:
-      role: "Software Architect"
       directory: .
       model: opus
       connections: [frontend, backend, devops]
@@ -199,7 +283,6 @@ swarm:
         - WebSearch
         
     frontend:
-      role: "Frontend Developer"
       directory: ./frontend
       model: sonnet
       connections: [architect]
@@ -210,7 +293,6 @@ swarm:
         - Bash
         
     backend:
-      role: "Backend Developer"
       directory: ./backend
       model: sonnet
       connections: [architect, database]
@@ -220,7 +302,6 @@ swarm:
         - Bash
         
     database:
-      role: "Database Administrator"
       directory: ./db
       model: haiku
       tools:
@@ -228,7 +309,6 @@ swarm:
         - Bash
         
     devops:
-      role: "DevOps Engineer"
       directory: .
       model: sonnet
       connections: [architect]
@@ -247,7 +327,6 @@ swarm:
   main: lead_researcher
   instances:
     lead_researcher:
-      role: "Lead Researcher"
       directory: ~/research
       model: opus
       connections: [data_analyst, writer]
@@ -261,7 +340,6 @@ swarm:
           url: "https://arxiv-mcp.example.com"
           
     data_analyst:
-      role: "Data Analyst"
       directory: ~/research/data
       model: sonnet
       tools:
@@ -275,7 +353,6 @@ swarm:
           args: ["--notebook-dir", "."]
           
     writer:
-      role: "Technical Writer"
       directory: ~/research/papers
       model: sonnet
       tools:

data/lib/claude_swarm/cli.rb

@@ -78,6 +78,63 @@ module ClaudeSwarm
       end
     end
 
+    desc "init", "Initialize a new claude-swarm.yml configuration file"
+    method_option :force, aliases: "-f", type: :boolean, default: false,
+                          desc: "Overwrite existing configuration file"
+    def init
+      config_path = "claude-swarm.yml"
+
+      if File.exist?(config_path) && !options[:force]
+        error "Configuration file already exists: #{config_path}"
+        error "Use --force to overwrite"
+        exit 1
+      end
+
+      template = <<~YAML
+        version: 1
+        swarm:
+          name: "Swarm Name"
+          main: lead_developer
+          instances:
+            lead_developer:
+              directory: .
+              model: sonnet
+              prompt: "You are the lead developer coordinating the team"
+              tools: [Read, Edit, Bash, Write]
+              # connections: [frontend_dev, backend_dev]
+
+            # Example instances (uncomment and modify as needed):
+
+            # frontend_dev:
+            #   directory: ./frontend
+            #   model: sonnet
+            #   prompt: "You specialize in frontend development with React, TypeScript, and modern web technologies"
+            #   tools: [Read, Edit, Write, "Bash(npm:*)", "Bash(yarn:*)", "Bash(pnpm:*)"]
+
+            # backend_dev:
+            #   directory: ../other-app/backend
+            #   model: sonnet
+            #   prompt: "You specialize in backend development, APIs, databases, and server architecture"
+            #   tools: [Read, Edit, Write, Bash]
+
+            # devops_engineer:
+            #   directory: .
+            #   model: sonnet
+            #   prompt: "You specialize in infrastructure, CI/CD, containerization, and deployment"
+            #   tools: [Read, Edit, Write, "Bash(docker:*)", "Bash(kubectl:*)", "Bash(terraform:*)"]
+
+            # qa_engineer:
+            #   directory: ./tests
+            #   model: sonnet
+            #   prompt: "You specialize in testing, quality assurance, and test automation"
+            #   tools: [Read, Edit, Write, Bash]
+      YAML
+
+      File.write(config_path, template)
+      say "Created #{config_path}", :green
+      say "Edit this file to configure your swarm, then run 'claude-swarm' to start"
+    end
+
     desc "version", "Show Claude Swarm version"
     def version
       say "Claude Swarm #{VERSION}"

data/lib/claude_swarm/configuration.rb

@@ -74,7 +74,6 @@ module ClaudeSwarm
       config ||= {}
       {
         name: name,
-        role: config["role"] || name.to_s.tr("_", " ").capitalize,
         directory: expand_path(config["directory"] || "."),
         model: config["model"] || "sonnet",
         connections: Array(config["connections"]),

data/lib/claude_swarm/orchestrator.rb

@@ -28,7 +28,7 @@ module ClaudeSwarm
 
       # Launch the main instance
       main_instance = @config.main_instance_config
-      puts "🚀 Launching main instance: #{@config.main_instance} (#{main_instance[:role]})"
+      puts "🚀 Launching main instance: #{@config.main_instance}"
       puts "   Model: #{main_instance[:model]}"
       puts "   Directory: #{main_instance[:directory]}"
       puts "   Tools: #{main_instance[:tools].join(", ")}" if main_instance[:tools].any?

data/lib/claude_swarm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeSwarm
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_swarm
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Paulo Arruda
@@ -57,7 +57,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- claude-swarm.yml
+- example/claude-swarm.yml
 - exe/claude-swarm
 - lib/claude_swarm.rb
 - lib/claude_swarm/claude_code_executor.rb