swarm_cli 2.0.0.pre.1

data/lib/swarm_cli/formatters/json_formatter.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  module Formatters
+    # JsonFormatter streams JSON log entries in real-time for consumption by scripts.
+    # Each log entry is output as a single line of JSON (newline-delimited JSON).
+    #
+    # No colors, no spinners, no animations - just pure structured data.
+    class JsonFormatter
+      def initialize(output: $stdout)
+        @output = output
+      end
+
+      # Called when swarm execution starts
+      #
+      # Note: SwarmSDK now automatically emits swarm_start as a log event,
+      # so we don't emit it here to avoid duplicates. The swarm_start event
+      # will flow through on_log() from the SwarmSDK event stream.
+      def on_start(config_path:, swarm_name:, lead_agent:, prompt:)
+        # SwarmSDK emits swarm_start automatically - no need to emit here
+      end
+
+      # Called for each log entry from SwarmSDK
+      def on_log(entry)
+        emit(entry)
+      end
+
+      # Called when swarm execution completes successfully
+      #
+      # No action needed - SwarmSDK's swarm_stop event already contains all necessary
+      # information (content, last_agent, duration, metrics, etc.)
+      def on_success(result:)
+        # SwarmSDK emits swarm_stop automatically with complete information
+      end
+
+      # Called when swarm execution fails
+      #
+      # No action needed - SwarmSDK's swarm_stop event already contains error information
+      def on_error(error:, duration: nil)
+        # SwarmSDK emits swarm_stop automatically with error information
+      end
+
+      private
+
+      def emit(data)
+        @output.puts(data.to_json)
+        @output.flush
+      end
+    end
+  end
+end

data/lib/swarm_cli/mcp_serve_options.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  # Options for the `swarm mcp serve` command
+  class McpServeOptions
+    include TTY::Option
+
+    usage do
+      program "swarm"
+      commands "mcp", "serve"
+      desc "Start an MCP server exposing swarm lead agent as a tool"
+      example "swarm mcp serve team.yml"
+    end
+
+    argument :config_file do
+      desc "Path to swarm configuration file (YAML)"
+      required
+    end
+
+    option :help do
+      short "-h"
+      long "--help"
+      desc "Print usage"
+    end
+
+    def validate!
+      errors = []
+
+      # Config file must exist
+      if config_file && !File.exist?(config_file)
+        errors << "Configuration file not found: #{config_file}"
+      end
+
+      unless errors.empty?
+        raise SwarmCLI::ExecutionError, errors.join("\n")
+      end
+    end
+
+    # Convenience accessor
+    def config_file
+      params[:config_file]
+    end
+  end
+end

data/lib/swarm_cli/mcp_tools_options.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  # Options for the `swarm mcp tools` command
+  class McpToolsOptions
+    include TTY::Option
+
+    usage do
+      program "swarm"
+      commands "mcp", "tools"
+      desc "Start an MCP server exposing SwarmSDK tools"
+      example "swarm mcp tools"
+      example "swarm mcp tools Read Write Bash"
+      example "swarm mcp tools ScratchpadWrite,ScratchpadRead"
+    end
+
+    argument :tool_names do
+      desc "Optional tool names to expose (defaults to all non-special tools)"
+      optional
+      arity :any
+    end
+
+    option :help do
+      short "-h"
+      long "--help"
+      desc "Print usage"
+    end
+
+    def validate!
+      errors = []
+
+      # Validate tool names if provided
+      if tool_names&.any?
+        invalid_tools = SwarmSDK::Tools::Registry.validate(tool_names)
+        if invalid_tools.any?
+          available = SwarmSDK::Tools::Registry.available_names.join(", ")
+          errors << "Invalid tool names: #{invalid_tools.join(", ")}. Available: #{available}"
+        end
+      end
+
+      unless errors.empty?
+        raise SwarmCLI::ExecutionError, errors.join("\n")
+      end
+    end
+
+    # Convenience accessor
+    def tool_names
+      names = params[:tool_names]
+      return [] if names.nil? || names.empty?
+
+      # TTY::Option might return a string or array
+      names_array = names.is_a?(Array) ? names : [names]
+
+      # Support comma-separated tool names in addition to space-separated
+      # e.g., both "swarm mcp tools Read Write" and "swarm mcp tools Read,Write" work
+      names_array.flat_map { |name| name.to_s.split(",") }.map(&:strip).reject(&:empty?)
+    end
+  end
+end

data/lib/swarm_cli/options.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  class Options
+    include TTY::Option
+
+    usage do
+      program "swarm"
+      command "run"
+      desc "Execute a swarm with AI agents"
+      example "swarm run team.yml -p 'Build a REST API'"
+      example "echo 'Build a REST API' | swarm run team.yml"
+      example "swarm run team.yml -p 'Refactor code' --output-format json"
+    end
+
+    argument :config_file do
+      desc "Path to swarm configuration file (YAML)"
+      required
+    end
+
+    option :prompt do
+      short "-p"
+      long "--prompt PROMPT"
+      desc "Task prompt for the swarm (if not provided, reads from stdin)"
+    end
+
+    option :output_format do
+      long "--output-format FORMAT"
+      desc "Output format: 'human' (default) or 'json'"
+      default "human"
+      permit ["human", "json"]
+    end
+
+    option :help do
+      short "-h"
+      long "--help"
+      desc "Print usage"
+    end
+
+    option :version do
+      short "-v"
+      long "--version"
+      desc "Print version"
+    end
+
+    flag :quiet do
+      short "-q"
+      long "--quiet"
+      desc "Suppress progress output (human format only)"
+    end
+
+    flag :truncate do
+      long "--truncate"
+      desc "Truncate long outputs for concise view"
+    end
+
+    flag :verbose do
+      long "--verbose"
+      desc "Show system reminders and additional debug information"
+    end
+
+    def validate!
+      errors = []
+
+      # At least one of prompt or stdin must be provided
+      if !prompt && $stdin.tty?
+        errors << "Prompt is required. Use -p or provide input via stdin."
+      end
+
+      # Config file must exist
+      if config_file && !File.exist?(config_file)
+        errors << "Configuration file not found: #{config_file}"
+      end
+
+      unless errors.empty?
+        raise SwarmCLI::ExecutionError, errors.join("\n")
+      end
+    end
+
+    def prompt_text
+      @prompt_text ||= if prompt
+        prompt
+      elsif !$stdin.tty?
+        $stdin.read.strip
+      else
+        raise SwarmCLI::ExecutionError, "No prompt provided"
+      end
+    end
+
+    # Convenience accessors that delegate to params
+    def config_file
+      params[:config_file]
+    end
+
+    def prompt
+      params[:prompt]
+    end
+
+    def output_format
+      params[:output_format]
+    end
+
+    def quiet?
+      params[:quiet]
+    end
+
+    def truncate?
+      params[:truncate]
+    end
+
+    def verbose?
+      params[:verbose]
+    end
+  end
+end

data/lib/swarm_cli/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  VERSION = "2.0.0-1"
+end

data/lib/swarm_cli.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "pathname"
+require "yaml"
+
+require "pastel"
+require "tty-box"
+require "tty-screen"
+require "tty/link"
+require "tty/markdown"
+require "tty/option"
+require "tty/prompt"
+require "tty/spinner"
+require "tty/spinner/multi"
+require "tty/tree"
+
+require "swarm_sdk"
+
+module SwarmCLI
+end
+
+require "zeitwerk"
+loader = Zeitwerk::Loader.new
+loader.push_dir("#{__dir__}/swarm_cli", namespace: SwarmCLI)
+loader.inflector.inflect(
+  "cli" => "CLI",
+)
+loader.setup
+
+module SwarmCLI
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class ExecutionError < Error; end
+end

metadata

@@ -0,0 +1,283 @@
+--- !ruby/object:Gem::Specification
+name: swarm_cli
+version: !ruby/object:Gem::Version
+  version: 2.0.0.pre.1
+platform: ruby
+authors:
+- Paulo Arruda
+bindir: exe
+cert_chain: []
+date: 2025-10-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fast-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: swarm_sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: tty-box
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-link
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-option
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-tree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: docx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: pdf-reader
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+- !ruby/object:Gem::Dependency
+  name: roo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+description: |
+  SwarmCLI provides a beautiful command-line interface for SwarmSDK, the lightweight multi-agent
+  AI orchestration framework. Built with the TTY toolkit, it offers an intuitive and interactive
+  way to define, manage, and execute AI agent swarms with progress indicators, formatted output,
+  and comprehensive help documentation.
+email:
+- parrudaj@gmail.com
+executables:
+- swarm
+extensions: []
+extra_rdoc_files: []
+files:
+- exe/swarm
+- lib/swarm_cli.rb
+- lib/swarm_cli/cli.rb
+- lib/swarm_cli/commands/mcp_serve.rb
+- lib/swarm_cli/commands/mcp_tools.rb
+- lib/swarm_cli/commands/run.rb
+- lib/swarm_cli/formatters/human_formatter.rb
+- lib/swarm_cli/formatters/json_formatter.rb
+- lib/swarm_cli/mcp_serve_options.rb
+- lib/swarm_cli/mcp_tools_options.rb
+- lib/swarm_cli/options.rb
+- lib/swarm_cli/version.rb
+homepage: https://github.com/parruda/claude-swarm
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/parruda/claude-swarm
+  changelog_uri: https://github.com/parruda/claude-swarm/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Command-line interface for SwarmSDK
+test_files: []