claude_swarm 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d905c9233bd290f36581e1507efcfb081c4c06e25182d84cf7fc1aa5fd167468
-  data.tar.gz: 666090b2014f5b451cb264bf4bffc658a6d543e1d4e074e7ccb0f9ab03e44327
+  metadata.gz: 37bc8baf6ea837fcd1e8936a1ae5a6a13138fad6e6efb3708deca991673e119d
+  data.tar.gz: 1e3d06c4138a42e7ab54a121c4bd3e584db3859e640a5965aac88d04fe0e6132
 SHA512:
-  metadata.gz: 6dd8b14d36a9ae772be13170fa28c30e85a93a02b5bfe6793294eca51d34520e02dc9d1ddefd5312cb2682472e6bcaa7dcb36213d28d6adf0b08852889117f36
-  data.tar.gz: d1762b2fd34da13e3262ebf82e3fd3576844c2487154c8b68a35f7e9ff270e96fa61f19a83e8488a8a2f630c96f6a61d78e827b352062cd695d5c656b06b9ca0
+  metadata.gz: dba5aab927293d3cc5fc4190b0cd84f7addf7ae0f90224df425a166d33c5feb5e062be21c8b915589191a14609f25f6fc68da63402c5295588bd5c4ed1d177ab
+  data.tar.gz: 6a7d5058d8583bd1bf6fec8d148fe62e617535528f49f960412eb6da065db01a0405f4de6cff8963c63c523ce81cbf661dc49fe8840df3d568eaa2fcba853284

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-05-24
+## [0.1.2] - 2025-05-29
+
+### Added
+- Added `-p` / `--prompt` flag to pass prompts directly to the main Claude instance for non-interactive mode
+- Output suppression when running with the `-p` flag for cleaner scripted usage
+
+## [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:
@@ -297,6 +374,10 @@ claude-swarm -c team-config.yml
 # Run with --dangerously-skip-permissions for all instances
 claude-swarm --vibe
 
+# Run in non-interactive mode with a prompt
+claude-swarm -p "Implement the new user authentication feature"
+claude-swarm --prompt "Fix the bug in the payment module"
+
 # Show version
 claude-swarm version
 

data/claude-swarm.yml

@@ -1,36 +1,19 @@
 version: 1
 swarm:
-  name: "Rails Expert Team"
-  main: lead_rails_dev
+  name: "Swarm Name"
+  main: lead_developer
   instances:
-    lead_rails_dev:
-      role: "Lead Rails Developer"
-      directory: .
-      model: opus
-      connections: [backend_dev, frontend_dev, test_engineer]
-      prompt: "You are a senior Ruby on Rails developer with 10+ years of experience. You excel at Rails architecture, performance optimization, and best practices. You coordinate the team and make architectural decisions."
-      
-    backend_dev:
-      role: "Backend Rails Developer"
+    lead_developer:
       directory: .
       model: sonnet
-      connections: [test_engineer]
-      prompt: "You specialize in Rails backend development including models, controllers, services, jobs, and API design. You follow Rails conventions and write clean, maintainable code with a focus on performance and security."
-      mcps:
-        - name: "headless_browser"
-          type: "stdio"
-          command: "bundle"
-          args: ["exec", "hbt", "stdio"]
-    
+      prompt: "You are the lead developer coordinating the team"
+      tools: [Read, Edit, Bash, Write]
+      connections: [frontend_dev]
+
+    # Example instances (uncomment and modify as needed):
+
     frontend_dev:
-      role: "Rails Frontend Developer"
-      directory: .
-      model: sonnet
-      connections: [test_engineer]
-      prompt: "You are a Rails developer specializing in views, partials, helpers, Stimulus/Turbo, and asset pipeline. You excel at creating responsive UIs with Rails' built-in tools and modern CSS/JavaScript integration."
-          
-    test_engineer:
-      role: "Rails Test Engineer"
       directory: .
       model: sonnet
-      prompt: "You are a Rails testing expert specializing in Minitest. You write comprehensive unit tests, integration tests, system tests, and fixtures. You ensure high test coverage and follow Rails testing best practices including proper use of assertions, test helpers, and factories."
+      prompt: "You specialize in frontend development with React, TypeScript, and modern web technologies"
+      tools: [Read, Edit, Write, "Bash(npm:*)", "Bash(yarn:*)", "Bash(pnpm:*)"]

data/example/claude-swarm.yml

@@ -0,0 +1,36 @@
+version: 1
+swarm:
+  name: "Rails Expert Team"
+  main: lead_rails_dev
+  instances:
+    lead_rails_dev:
+      role: "Lead Rails Developer"
+      directory: .
+      model: opus
+      connections: [backend_dev, frontend_dev, test_engineer]
+      prompt: "You are a senior Ruby on Rails developer with 10+ years of experience. You excel at Rails architecture, performance optimization, and best practices. You coordinate the team and make architectural decisions."
+      
+    backend_dev:
+      role: "Backend Rails Developer"
+      directory: .
+      model: sonnet
+      connections: [test_engineer]
+      prompt: "You specialize in Rails backend development including models, controllers, services, jobs, and API design. You follow Rails conventions and write clean, maintainable code with a focus on performance and security."
+      mcps:
+        - name: "headless_browser"
+          type: "stdio"
+          command: "bundle"
+          args: ["exec", "hbt", "stdio"]
+    
+    frontend_dev:
+      role: "Rails Frontend Developer"
+      directory: .
+      model: sonnet
+      connections: [test_engineer]
+      prompt: "You are a Rails developer specializing in views, partials, helpers, Stimulus/Turbo, and asset pipeline. You excel at creating responsive UIs with Rails' built-in tools and modern CSS/JavaScript integration."
+          
+    test_engineer:
+      role: "Rails Test Engineer"
+      directory: .
+      model: sonnet
+      prompt: "You are a Rails testing expert specializing in Minitest. You write comprehensive unit tests, integration tests, system tests, and fixtures. You ensure high test coverage and follow Rails testing best practices including proper use of assertions, test helpers, and factories."

data/lib/claude_swarm/cli.rb

@@ -17,6 +17,8 @@ module ClaudeSwarm
                            desc: "Path to configuration file"
     method_option :vibe, type: :boolean, default: false,
                          desc: "Run with --dangerously-skip-permissions for all instances"
+    method_option :prompt, aliases: "-p", type: :string,
+                           desc: "Prompt to pass to the main Claude instance (non-interactive mode)"
     def start(config_file = nil)
       config_path = config_file || options[:config]
       unless File.exist?(config_path)
@@ -24,11 +26,11 @@ module ClaudeSwarm
         exit 1
       end
 
-      say "Starting Claude Swarm from #{config_path}..."
+      say "Starting Claude Swarm from #{config_path}..." unless options[:prompt]
       begin
         config = Configuration.new(config_path)
         generator = McpGenerator.new(config, vibe: options[:vibe])
-        orchestrator = Orchestrator.new(config, generator, vibe: options[:vibe])
+        orchestrator = Orchestrator.new(config, generator, vibe: options[:vibe], prompt: options[:prompt])
         orchestrator.start
       rescue Error => e
         error e.message
@@ -78,6 +80,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

@@ -4,39 +4,48 @@ require "shellwords"
 
 module ClaudeSwarm
   class Orchestrator
-    def initialize(configuration, mcp_generator, vibe: false)
+    def initialize(configuration, mcp_generator, vibe: false, prompt: nil)
       @config = configuration
       @generator = mcp_generator
       @vibe = vibe
+      @prompt = prompt
     end
 
     def start
-      puts "🐝 Starting Claude Swarm: #{@config.swarm_name}"
-      puts "😎 Vibe mode ON" if @vibe
-      puts
+      unless @prompt
+        puts "🐝 Starting Claude Swarm: #{@config.swarm_name}"
+        puts "😎 Vibe mode ON" if @vibe
+        puts
+      end
 
       # Set session timestamp for all instances to share the same log file
       session_timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
       ENV["CLAUDE_SWARM_SESSION_TIMESTAMP"] = session_timestamp
-      puts "📝 Session logs will be saved to: .claude-swarm/logs/session_#{session_timestamp}.log"
-      puts
+      unless @prompt
+        puts "📝 Session logs will be saved to: .claude-swarm/logs/session_#{session_timestamp}.log"
+        puts
+      end
 
       # Generate all MCP configuration files
       @generator.generate_all
-      puts "✓ Generated MCP configurations in .claude-swarm/"
-      puts
+      unless @prompt
+        puts "✓ Generated MCP configurations in .claude-swarm/"
+        puts
+      end
 
       # Launch the main instance
       main_instance = @config.main_instance_config
-      puts "🚀 Launching main instance: #{@config.main_instance} (#{main_instance[:role]})"
-      puts "   Model: #{main_instance[:model]}"
-      puts "   Directory: #{main_instance[:directory]}"
-      puts "   Tools: #{main_instance[:tools].join(", ")}" if main_instance[:tools].any?
-      puts "   Connections: #{main_instance[:connections].join(", ")}" if main_instance[:connections].any?
-      puts
+      unless @prompt
+        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?
+        puts "   Connections: #{main_instance[:connections].join(", ")}" if main_instance[:connections].any?
+        puts
+      end
 
       command = build_main_command(main_instance)
-      if ENV["DEBUG"]
+      if ENV["DEBUG"] && !@prompt
         puts "Running: #{command}"
         puts
       end
@@ -65,6 +74,8 @@ module ClaudeSwarm
       mcp_config_path = @generator.mcp_config_path(@config.main_instance)
       parts << "--mcp-config #{mcp_config_path}"
 
+      parts << "-p #{Shellwords.escape(@prompt)}" if @prompt
+
       parts.join(" ")
     end
   end

data/lib/claude_swarm/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude_swarm
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Paulo Arruda
 bindir: exe
 cert_chain: []
-date: 2025-05-28 00:00:00.000000000 Z
+date: 2025-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -58,6 +58,7 @@ files:
 - README.md
 - Rakefile
 - claude-swarm.yml
+- example/claude-swarm.yml
 - exe/claude-swarm
 - lib/claude_swarm.rb
 - lib/claude_swarm/claude_code_executor.rb