schwarm-cli 0.1.0

data/lib/schwarm_cli/commands/tasks.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  module Commands
+    class Tasks < Base
+      desc "list", "List tasks"
+      option :status, type: :string, desc: "Filter by status"
+      option :repo, type: :string, desc: "Filter by repository ID"
+      option :query, type: :string, desc: "Search by name"
+      def list
+        handle_errors do
+          data = client.tasks.list(status: options[:status], repository_id: options[:repo], query: options[:query])
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[STATUS status],
+                                      %w[REPO github_repository_id], %w[CREATED created_at]])
+        end
+      end
+
+      desc "show ID", "Show task details"
+      def show(id)
+        handle_errors do
+          data = client.tasks.find(id)
+          output_record(data, fields: {
+                          "ID" => "id", "Name" => "name", "Status" => "status", "Prompt" => "prompt",
+                          "Branch" => "branch_name", "Error" => "error_message",
+                          "Repository" => "github_repository_id", "Dependencies" => "dependency_ids",
+                          "Created" => "created_at", "Updated" => "updated_at"
+                        })
+        end
+      end
+
+      desc "create", "Create a new task"
+      option :name, type: :string, required: true, desc: "Task name"
+      option :prompt, type: :string, desc: "Task prompt"
+      option :prompt_file, type: :string, desc: "Read prompt from file"
+      option :repo, type: :string, desc: "Repository ID"
+      option :status, type: :string, desc: "Initial status (draft/waiting)"
+      option :template, type: :string, desc: "Template ID"
+      option :depends_on, type: :array, desc: "Dependency task IDs"
+      def create
+        handle_errors do
+          data = client.tasks.create(**create_attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name", "Status" => "status" })
+        end
+      end
+
+      desc "update ID", "Update a task"
+      option :name, type: :string, desc: "Task name"
+      option :prompt, type: :string, desc: "Task prompt"
+      option :prompt_file, type: :string, desc: "Read prompt from file"
+      option :repo, type: :string, desc: "Repository ID"
+      option :depends_on, type: :array, desc: "Dependency task IDs"
+      def update(id)
+        handle_errors do
+          data = client.tasks.update(id, **update_attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name", "Status" => "status" })
+        end
+      end
+
+      desc "delete ID", "Delete a task"
+      def delete(id)
+        handle_errors do
+          client.tasks.destroy(id)
+          puts "Task #{id} deleted."
+        end
+      end
+
+      desc "start ID", "Start a task"
+      def start(id)
+        handle_errors do
+          data = client.tasks.start(id)
+          puts "Task #{id} started (#{data.dig('data', 'status')})."
+        end
+      end
+
+      desc "archive ID", "Archive a task"
+      def archive(id)
+        handle_errors do
+          data = client.tasks.archive(id)
+          puts "Task #{id} archived (#{data.dig('data', 'status')})."
+        end
+      end
+
+      desc "retry ID", "Retry a failed task"
+      def retry(id)
+        handle_errors do
+          data = client.tasks.retry(id)
+          puts "Task #{id} retried (#{data.dig('data', 'status')})."
+        end
+      end
+
+      desc "reset ID", "Reset a task to draft"
+      def reset(id)
+        handle_errors do
+          data = client.tasks.reset(id)
+          puts "Task #{id} reset (#{data.dig('data', 'status')})."
+        end
+      end
+
+      desc "pause ID", "Pause a task"
+      def pause(id)
+        handle_errors do
+          data = client.tasks.pause(id)
+          puts "Task #{id} paused (#{data.dig('data', 'status')})."
+        end
+      end
+
+      desc "message ID", "Send a message to a running task"
+      option :content, type: :string, required: true, desc: "Message content"
+      def message(id)
+        handle_errors do
+          client.messages.create(task_id: id, content: options[:content])
+          puts "Message sent to task #{id}."
+        end
+      end
+
+      private
+
+      def create_attrs
+        {
+          name: options[:name], prompt: read_prompt,
+          github_repository_id: options[:repo], status: options[:status],
+          task_template_id: options[:template], dependency_ids: options[:depends_on]
+        }.compact
+      end
+
+      def update_attrs
+        {
+          name: options[:name], github_repository_id: options[:repo],
+          dependency_ids: options[:depends_on]
+        }.compact.tap do |attrs|
+          attrs[:prompt] = read_prompt if options[:prompt] || options[:prompt_file]
+        end
+      end
+
+      def read_prompt
+        if options[:prompt_file]
+          file_path = File.expand_path(options[:prompt_file])
+          abort "Error: File not found: #{file_path}" unless File.exist?(file_path)
+          File.read(file_path)
+        else
+          options[:prompt]
+        end
+      end
+    end
+  end
+end

data/lib/schwarm_cli/commands/templates.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  module Commands
+    class Templates < Base
+      desc "list", "List task templates"
+      option :query, type: :string, desc: "Search by name"
+      def list
+        handle_errors do
+          data = client.templates.list(query: options[:query])
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[CREATED created_at]])
+        end
+      end
+
+      desc "show ID", "Show template details"
+      def show(id)
+        handle_errors do
+          data = client.templates.find(id)
+          output_record(data, fields: {
+                          "ID" => "id", "Name" => "name", "Prompt" => "prompt", "Created" => "created_at"
+                        })
+        end
+      end
+
+      desc "create", "Create a task template"
+      option :name, type: :string, required: true, desc: "Template name"
+      option :prompt, type: :string, required: true, desc: "Template prompt"
+      def create
+        handle_errors do
+          data = client.templates.create(name: options[:name], prompt: options[:prompt])
+          output_record(data, fields: { "ID" => "id", "Name" => "name" })
+        end
+      end
+
+      desc "update ID", "Update a task template"
+      option :name, type: :string, desc: "Template name"
+      option :prompt, type: :string, desc: "Template prompt"
+      def update(id)
+        handle_errors do
+          attrs = {}
+          attrs[:name] = options[:name] if options[:name]
+          attrs[:prompt] = options[:prompt] if options[:prompt]
+
+          data = client.templates.update(id, **attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name" })
+        end
+      end
+
+      desc "delete ID", "Delete a task template"
+      def delete(id)
+        handle_errors do
+          client.templates.destroy(id)
+          puts "Template #{id} deleted."
+        end
+      end
+    end
+  end
+end

data/lib/schwarm_cli/config.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module SchwarmCli
+  # Loads CLI configuration from multiple sources with priority:
+  # 1. Explicit constructor arguments (highest)
+  # 2. Environment variables (SCHWARM_URL, SCHWARM_TOKEN)
+  # 3. Config file (~/.config/schwarm.json)
+  class Config
+    DEFAULT_PATH = File.expand_path("~/.config/schwarm.json")
+
+    attr_reader :url, :api_key, :config_path
+
+    def initialize(url: nil, api_key: nil, config_path: DEFAULT_PATH)
+      @config_path = config_path
+      file_config = load_file
+      @url = strip_slash(url || ENV["SCHWARM_URL"] || file_config["url"])
+      @api_key = api_key || ENV["SCHWARM_TOKEN"] || file_config["api_key"]
+    end
+
+    def valid?
+      !@url.nil? && !@url.empty? && !@api_key.nil? && !@api_key.empty?
+    end
+
+    def save
+      FileUtils.mkdir_p(File.dirname(@config_path))
+      File.write(@config_path, JSON.pretty_generate(url: @url, api_key: @api_key))
+    end
+
+    private
+
+    def load_file
+      return {} unless File.exist?(@config_path)
+
+      JSON.parse(File.read(@config_path))
+    rescue JSON::ParserError
+      {}
+    end
+
+    def strip_slash(value)
+      value&.chomp("/")
+    end
+  end
+end

data/lib/schwarm_cli/formatters/json.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "json"
+
+module SchwarmCli
+  module Formatters
+    module Json
+      def self.format(data)
+        puts JSON.pretty_generate(data)
+      end
+    end
+  end
+end

data/lib/schwarm_cli/formatters/table.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  module Formatters
+    module Table
+      def self.format_list(records, columns:)
+        if records.empty?
+          puts "No results found."
+          return
+        end
+
+        widths = column_widths(records, columns)
+        puts format_row(columns.map(&:first), columns, widths)
+        records.each do |record|
+          puts format_row(columns.map { |_, key| record[key].to_s }, columns, widths)
+        end
+      end
+
+      def self.format_record(record, fields:)
+        label_width = fields.keys.map(&:length).max
+        fields.each do |label, key|
+          puts "#{label.rjust(label_width)}: #{record[key]}"
+        end
+      end
+
+      def self.column_widths(records, columns)
+        columns.to_h do |label, key|
+          [key, [label.length, *records.map { |r| r[key].to_s.length }].max]
+        end
+      end
+
+      def self.format_row(values, columns, widths)
+        values.zip(columns).map { |val, (_, key)| val.ljust(widths[key]) }.join("  ")
+      end
+
+      private_class_method :column_widths, :format_row
+    end
+  end
+end

data/lib/schwarm_cli/version.rb

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

data/lib/schwarm_cli.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "schwarm_cli/version"
+require_relative "schwarm_cli/config"
+require_relative "schwarm_cli/client"
+require_relative "schwarm_cli/formatters/json"
+require_relative "schwarm_cli/formatters/table"
+require_relative "schwarm_cli/commands/main"
+
+module SchwarmCli
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: schwarm-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vincent Garrigues
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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: faraday-net_http_persistent
+  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: faraday-retry
+  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: gum
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: Command-line interface for managing tasks, repositories, skills, and
+  agents on a Schwarm server via the public API v2.
+executables:
+- schwarm
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/schwarm
+- lib/schwarm_cli.rb
+- lib/schwarm_cli/client.rb
+- lib/schwarm_cli/client/agent_sessions.rb
+- lib/schwarm_cli/client/recurring_tasks.rb
+- lib/schwarm_cli/client/repositories.rb
+- lib/schwarm_cli/client/repository_agents.rb
+- lib/schwarm_cli/client/repository_skills.rb
+- lib/schwarm_cli/client/resource.rb
+- lib/schwarm_cli/client/secret_files.rb
+- lib/schwarm_cli/client/shared_agents.rb
+- lib/schwarm_cli/client/skill_files.rb
+- lib/schwarm_cli/client/skills.rb
+- lib/schwarm_cli/client/task_templates.rb
+- lib/schwarm_cli/client/tasks.rb
+- lib/schwarm_cli/client/user_messages.rb
+- lib/schwarm_cli/commands/agents.rb
+- lib/schwarm_cli/commands/base.rb
+- lib/schwarm_cli/commands/configure.rb
+- lib/schwarm_cli/commands/main.rb
+- lib/schwarm_cli/commands/recurring.rb
+- lib/schwarm_cli/commands/repo_skills.rb
+- lib/schwarm_cli/commands/repos.rb
+- lib/schwarm_cli/commands/secrets.rb
+- lib/schwarm_cli/commands/sessions.rb
+- lib/schwarm_cli/commands/shared_agents.rb
+- lib/schwarm_cli/commands/skill_files.rb
+- lib/schwarm_cli/commands/skills.rb
+- lib/schwarm_cli/commands/tasks.rb
+- lib/schwarm_cli/commands/templates.rb
+- lib/schwarm_cli/config.rb
+- lib/schwarm_cli/formatters/json.rb
+- lib/schwarm_cli/formatters/table.rb
+- lib/schwarm_cli/version.rb
+homepage: https://github.com/getdexter/schwarm
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/getdexter/schwarm
+  source_code_uri: https://github.com/getdexter/schwarm/tree/main/cli
+  changelog_uri: https://github.com/getdexter/schwarm/blob/main/cli/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: CLI for the Schwarm distributed agent system
+test_files: []