schwarm-cli 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 601a7ca203a5837a47d4bd0348300054e07fe3577a57c99865a64c282e310d8f
-  data.tar.gz: 857487dd8fa4d92e575466ebe1ed63c70fd3b1c744c6b041eb3d4c675c4657fc
+  metadata.gz: 6eb34f4bf3e7d00ae361c8f3e2e92543b70a3cf607bca49c2621db6308ff7347
+  data.tar.gz: '081ef605e386eef7aa68d0f41646a16c270cf5760bfeb1b5f7270f4b3b5ecf7e'
 SHA512:
-  metadata.gz: 899c50f55a6b91d9a8690603de5cbf7dc429b022f18198d205c3679eb6a97911e1fb5afe6bc96cb8ae76f852bb38edf9ca7ef82df245249e5ef1fc5e8188ccc9
-  data.tar.gz: 506dd09f7f837606a154cd61f0e2f79e7b231af0daa1e495115ba16b2e7c6fc5290dc101fd0c30ca8370132bc08178e39158295100a68c3a36a0e21e2079ca58
+  metadata.gz: 259bfe442c01d5d6a7906fcbf474927013374d8283f7083552b5e30137603e94ae94d2f92c3211c173807236d37b188de25e45594179c108fb49562af521a903
+  data.tar.gz: 118a0a5418bd88cc5f17e6f06bd80221830fdc2d8b5a4e9a83276894cd64779bdc1b9015012f5e5f1068ee1805800260f8f9dbafbde9327247bf1853cd78b0d6

data/lib/schwarm_cli/client/secret_files.rb

@@ -3,8 +3,8 @@
 module SchwarmCli
   class Client
     class SecretFiles < Resource
-      def list(repository_id: nil, page: nil, per_page: nil)
-        params = { repository_id:, page:, per_page: }.compact
+      def list(repository_id: nil, query: nil, page: nil, per_page: nil)
+        params = { repository_id:, q: query, page:, per_page: }.compact
         get("/api/v2/secret_files", params).body
       end
 

data/lib/schwarm_cli/client/skill_files.rb

@@ -1,7 +1,12 @@
 # frozen_string_literal: true
 
+require "faraday/multipart"
+
 module SchwarmCli
   class Client
+    # The skill_files endpoint expects path as a top-level form param plus a
+    # multipart-attached `file` (Active Storage), NOT a JSON body wrapped in
+    # `{skill_file: {...}}`. Build a multipart form for create/update.
     class SkillFiles < Resource
       def list(skill_id:, page: nil, per_page: nil)
         params = { page:, per_page: }.compact
@@ -12,18 +17,34 @@ module SchwarmCli
         get("/api/v2/skills/#{skill_id}/files/#{id}").body
       end
 
-      def create(skill_id:, **attributes)
-        post("/api/v2/skills/#{skill_id}/files", { skill_file: attributes }).body
+      def create(skill_id:, path:, content:)
+        post("/api/v2/skills/#{skill_id}/files", multipart_body(path:, content:)).body
       end
 
-      def update(skill_id:, id:, **attributes)
-        patch("/api/v2/skills/#{skill_id}/files/#{id}", { skill_file: attributes }).body
+      def update(skill_id:, id:, path: nil, content: nil)
+        body = {}
+        body[:path] = path if path
+        body[:file] = file_part(path:, content:) if content
+        patch("/api/v2/skills/#{skill_id}/files/#{id}", body).body
       end
 
       def destroy(skill_id:, id:)
         delete("/api/v2/skills/#{skill_id}/files/#{id}")
         nil
       end
+
+      private
+
+      def multipart_body(path:, content:)
+        { path:, file: file_part(path:, content:) }
+      end
+
+      # Active Storage needs a real IO with a filename. Wrap the in-memory
+      # content in a StringIO and hand it to Faraday::Multipart::FilePart.
+      def file_part(path:, content:)
+        io = StringIO.new(content.to_s)
+        Faraday::Multipart::FilePart.new(io, "application/octet-stream", File.basename(path.to_s))
+      end
     end
   end
 end

data/lib/schwarm_cli/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "faraday"
+require "faraday/multipart"
 require "faraday/net_http_persistent"
 require "faraday/retry"
 
@@ -21,7 +22,7 @@ require_relative "client/user_messages"
 module SchwarmCli
   class Client
     attr_reader :tasks, :repositories, :skills, :skill_files, :templates,
-                :recurring, :agents, :shared_agents, :secrets, :sessions,
+                :recurring, :agents, :subscriptions, :secrets, :sessions,
                 :repo_skills, :messages
 
     def get(...) = conn.get(...)
@@ -52,8 +53,8 @@ module SchwarmCli
       @skill_files = SkillFiles.new(client: self)
       @templates = TaskTemplates.new(client: self)
       @recurring = RecurringTasks.new(client: self)
-      @agents = RepositoryAgents.new(client: self)
-      @shared_agents = SharedAgents.new(client: self)
+      @agents = SharedAgents.new(client: self)
+      @subscriptions = RepositoryAgents.new(client: self)
       @secrets = SecretFiles.new(client: self)
       @sessions = AgentSessions.new(client: self)
       @repo_skills = RepositorySkills.new(client: self)
@@ -62,6 +63,7 @@ module SchwarmCli
 
     def conn
       @conn ||= Faraday.new(url:, headers:, **faraday_options) do |f|
+        f.request :multipart
         f.request :json
         f.request :authorization, "Bearer", api_key
         f.request :retry, retry_options

data/lib/schwarm_cli/commands/agent_subscriptions.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  module Commands
+    class AgentSubscriptions < Base
+      desc "list", "List repository subscriptions"
+      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
+      option :query, type: :string, desc: "Search by name"
+      pagination_options
+      def list
+        handle_errors do
+          data = fetch_paged do |page_params|
+            client.subscriptions.list(repository_id: resolve_repo(options[:repo]), query: options[:query],
+                                      **page_params)
+          end
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
+                                      %w[ENABLED enabled], %w[SCHEDULE schedule]])
+        end
+      end
+
+      desc "show ID", "Show subscription details"
+      def show(id)
+        handle_errors do
+          data = client.subscriptions.find(id)
+          output_record(data, fields: {
+                          "ID" => "id", "Name" => "name", "Repository" => "github_repository_name",
+                          "Agent" => "shared_agent_id", "Enabled" => "enabled",
+                          "Schedule" => "schedule",
+                          "Additional Instructions" => "additional_instructions",
+                          "Created" => "created_at", "Updated" => "updated_at"
+                        })
+        end
+      end
+
+      desc "create", "Subscribe an agent to a repository"
+      option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
+      option :agent, type: :string, required: true,
+                     desc: "Agent ID to subscribe to this repository"
+      option :additional_instructions, type: :string,
+                                       desc: "Per-repository additional instructions appended to the shared prompt"
+      option :enabled, type: :boolean, default: false,
+                       desc: "Whether the subscription is active (default: false; toggle to enable)"
+      def create
+        handle_errors do
+          data = client.subscriptions.create(**create_attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
+        end
+      end
+
+      desc "update ID", "Update a subscription"
+      option :additional_instructions, type: :string,
+                                       desc: "Per-repository additional instructions"
+      option :enabled, type: :boolean, desc: "Whether the subscription is active"
+      def update(id)
+        handle_errors do
+          data = client.subscriptions.update(id, **update_attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
+        end
+      end
+
+      desc "delete ID", "Delete a subscription"
+      def delete(id)
+        handle_errors do
+          client.subscriptions.destroy(id)
+          puts "Subscription #{id} deleted."
+        end
+      end
+
+      desc "toggle ID", "Toggle subscription enabled/disabled"
+      def toggle(id)
+        handle_errors do
+          data = client.subscriptions.toggle(id)
+          status = data.dig("data", "enabled") ? "enabled" : "disabled"
+          puts "Subscription #{id} #{status}."
+        end
+      end
+
+      desc "run-now ID", "Trigger subscription to run immediately"
+      map "run-now" => :run_now
+      def run_now(id)
+        handle_errors do
+          client.subscriptions.run_now(id)
+          puts "Subscription #{id} triggered."
+        end
+      end
+
+      private
+
+      def create_attrs
+        attrs = {
+          shared_agent_id: options[:agent],
+          github_repository_id: resolve_repo(options[:repo]),
+          enabled: options[:enabled]
+        }
+        attrs[:additional_instructions] = options[:additional_instructions] if options[:additional_instructions]
+        attrs
+      end
+
+      def update_attrs
+        {}.tap do |attrs|
+          attrs[:additional_instructions] = options[:additional_instructions] if options[:additional_instructions]
+          attrs[:enabled] = options[:enabled] unless options[:enabled].nil?
+        end
+      end
+    end
+  end
+end

data/lib/schwarm_cli/commands/agents.rb

@@ -1,19 +1,23 @@
 # frozen_string_literal: true
 
+require_relative "agent_subscriptions"
+
 module SchwarmCli
   module Commands
     class Agents < Base
-      desc "list", "List repository agents"
-      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
+      desc "subscriptions SUBCOMMAND", "Manage repository subscriptions"
+      subcommand "subscriptions", AgentSubscriptions
+
+      desc "list", "List agents"
       option :query, type: :string, desc: "Search by name"
       pagination_options
       def list
         handle_errors do
           data = fetch_paged do |page_params|
-            client.agents.list(repository_id: resolve_repo(options[:repo]), query: options[:query], **page_params)
+            client.agents.list(query: options[:query], **page_params)
           end
-          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
-                                      %w[ENABLED enabled], %w[SCHEDULE schedule]])
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[ENABLED enabled],
+                                      %w[SCHEDULE cron_expression]])
         end
       end
 
@@ -21,43 +25,40 @@ module SchwarmCli
       def show(id)
         handle_errors do
           data = client.agents.find(id)
-          output_record(data, fields: {
-                          "ID" => "id", "Name" => "name", "Repository" => "github_repository_name",
-                          "Shared Agent" => "shared_agent_id", "Enabled" => "enabled",
-                          "Schedule" => "schedule",
-                          "Additional Instructions" => "additional_instructions",
-                          "Created" => "created_at", "Updated" => "updated_at"
-                        })
+          output_record(data, fields: agent_fields)
         end
       end
 
-      desc "create", "Create a repository agent (subscribe a shared agent to a repo)"
-      option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
-      option :shared_agent, type: :string, required: true,
-                            desc: "Shared agent ID to subscribe to this repository"
-      option :additional_instructions, type: :string,
-                                       desc: "Per-repository additional instructions appended to the shared prompt"
-      option :enabled, type: :boolean, default: true,
-                       desc: "Whether the agent runs (default: true)"
+      desc "create", "Create an agent"
+      option :name, type: :string, required: true, desc: "Agent name"
+      option :prompt, type: :string, required: true, desc: "Agent prompt"
+      option :schedule, type: :string, required: true, desc: "Cron schedule (e.g. \"0 0 * * *\")"
+      option :enabled, type: :boolean, default: false,
+                       desc: "Whether the agent runs (default: false; toggle to enable)"
       def create
         handle_errors do
-          data = client.agents.create(**create_attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
+          attrs = {
+            name: options[:name], prompt: options[:prompt],
+            cron_expression: options[:schedule], enabled: options[:enabled]
+          }
+
+          data = client.agents.create(**attrs)
+          output_record(data, fields: agent_fields)
         end
       end
 
-      desc "update ID", "Update a repository agent"
-      option :additional_instructions, type: :string,
-                                       desc: "Per-repository additional instructions"
-      option :enabled, type: :boolean, desc: "Whether the agent runs"
+      desc "update ID", "Update an agent"
+      option :name, type: :string, desc: "Agent name"
+      option :prompt, type: :string, desc: "Agent prompt"
+      option :schedule, type: :string, desc: "Cron schedule"
       def update(id)
         handle_errors do
           data = client.agents.update(id, **update_attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
+          output_record(data, fields: agent_fields)
         end
       end
 
-      desc "delete ID", "Delete a repository agent"
+      desc "delete ID", "Delete an agent"
       def delete(id)
         handle_errors do
           client.agents.destroy(id)
@@ -74,33 +75,23 @@ module SchwarmCli
         end
       end
 
-      desc "run-now ID", "Trigger agent to run immediately"
-      map "run-now" => :run_now
-      def run_now(id)
-        handle_errors do
-          client.agents.run_now(id)
-          puts "Agent #{id} triggered."
-        end
-      end
-
       private
 
-      def create_attrs
-        attrs = {
-          shared_agent_id: options[:shared_agent],
-          github_repository_id: resolve_repo(options[:repo]),
-          enabled: options[:enabled]
-        }
-        attrs[:additional_instructions] = options[:additional_instructions] if options[:additional_instructions]
-        attrs
-      end
-
       def update_attrs
         {}.tap do |attrs|
-          attrs[:additional_instructions] = options[:additional_instructions] if options[:additional_instructions]
-          attrs[:enabled] = options[:enabled] unless options[:enabled].nil?
+          attrs[:name] = options[:name] if options[:name]
+          attrs[:prompt] = options[:prompt] if options[:prompt]
+          attrs[:cron_expression] = options[:schedule] if options[:schedule]
         end
       end
+
+      def agent_fields
+        {
+          "ID" => "id", "Name" => "name", "Enabled" => "enabled",
+          "Schedule" => "cron_expression", "Prompt" => "prompt",
+          "Created" => "created_at", "Updated" => "updated_at"
+        }
+      end
     end
   end
 end

data/lib/schwarm_cli/commands/base.rb

@@ -5,12 +5,39 @@ require "thor"
 module SchwarmCli
   module Commands
     class Base < Thor
-      class_option :json, type: :boolean, default: false, desc: "Output as JSON"
+      # No `default: false` on :json — we need to distinguish "not provided"
+      # (nil) from "explicitly negated" (--no-json => false) so nested
+      # subcommands can opt out of an inherited --json (see options below).
+      class_option :json, type: :boolean, desc: "Output as JSON"
       class_option :url, type: :string, desc: "Schwarm server URL (overrides config)"
       class_option :token, type: :string, desc: "API key (overrides config)"
 
       def self.exit_on_failure? = true
 
+      # Thor parses class_options at each subcommand level independently, so
+      # `--json` at a doubly-nested invocation (`agents subscriptions list
+      # --json`) is consumed by the outer class and never reaches the inner.
+      # Merge parent_options for global flags (json, url, token) so they
+      # propagate transparently into nested subcommands.
+      #
+      # We can't use Hash#merge with a block because Thor returns a
+      # HashWithIndifferentAccess whose `merge` ignores the block argument
+      # (lib/thor/core_ext/hash_with_indifferent_access.rb:53). Walk the
+      # inherited keys explicitly so an explicit child value (including
+      # `false` from --no-json) wins over an inherited parent value.
+      INHERITED_OPTIONS = %w[json url token].freeze
+
+      no_commands do
+        def options
+          merged = super.dup
+          parent = parent_options || {}
+          INHERITED_OPTIONS.each do |key|
+            merged[key] = parent[key] if merged[key].nil? && !parent[key].nil?
+          end
+          merged
+        end
+      end
+
       DEFAULT_LIST_LIMIT = 20
 
       # Declares --limit, --page, --all options for the next method.

data/lib/schwarm_cli/commands/main.rb

@@ -7,7 +7,6 @@ require_relative "templates"
 require_relative "skills"
 require_relative "skill_files"
 require_relative "agents"
-require_relative "shared_agents"
 require_relative "recurring"
 require_relative "secrets"
 require_relative "sessions"
@@ -34,12 +33,9 @@ module SchwarmCli
       desc "skill-files SUBCOMMAND", "Manage skill files"
       subcommand "skill_files", SkillFilesCmd
 
-      desc "agents SUBCOMMAND", "Manage repository agents"
+      desc "agents SUBCOMMAND", "Manage agents and their repository subscriptions"
       subcommand "agents", Agents
 
-      desc "shared-agents SUBCOMMAND", "Manage shared agents"
-      subcommand "shared_agents", SharedAgentsCmd
-
       desc "recurring SUBCOMMAND", "Manage recurring tasks"
       subcommand "recurring", Recurring
 

data/lib/schwarm_cli/commands/recurring.rb

@@ -21,11 +21,7 @@ module SchwarmCli
       def show(id)
         handle_errors do
           data = client.recurring.find(id)
-          output_record(data, fields: {
-                          "ID" => "id", "Name" => "name", "Repository" => "github_repository_id",
-                          "Enabled" => "enabled", "Schedule" => "cron_expression", "Prompt" => "prompt",
-                          "Created" => "created_at", "Updated" => "updated_at"
-                        })
+          output_record(data, fields: recurring_fields)
         end
       end
 
@@ -34,15 +30,12 @@ module SchwarmCli
       option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
       option :prompt, type: :string, required: true, desc: "Task prompt"
       option :schedule, type: :string, required: true, desc: "Cron schedule"
+      option :enabled, type: :boolean, default: false,
+                       desc: "Whether the recurring task fires (default: false; toggle to enable)"
       def create
         handle_errors do
-          attrs = {
-            name: options[:name], github_repository_id: resolve_repo(options[:repo]),
-            prompt: options[:prompt], cron_expression: options[:schedule]
-          }
-
-          data = client.recurring.create(**attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name", "Schedule" => "cron_expression" })
+          data = client.recurring.create(**create_attrs)
+          output_record(data, fields: recurring_fields)
         end
       end
 
@@ -53,7 +46,7 @@ module SchwarmCli
       def update(id)
         handle_errors do
           data = client.recurring.update(id, **update_attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name", "Schedule" => "cron_expression" })
+          output_record(data, fields: recurring_fields)
         end
       end
 
@@ -76,6 +69,20 @@ module SchwarmCli
 
       private
 
+      def create_attrs
+        {
+          name: options[:name], github_repository_id: resolve_repo(options[:repo]),
+          prompt: options[:prompt], cron_expression: options[:schedule],
+          enabled: options[:enabled]
+        }
+      end
+
+      def recurring_fields
+        { "ID" => "id", "Name" => "name", "Repository" => "github_repository_id",
+          "Enabled" => "enabled", "Schedule" => "cron_expression", "Prompt" => "prompt",
+          "Created" => "created_at", "Updated" => "updated_at" }
+      end
+
       def update_attrs
         {}.tap do |attrs|
           attrs[:name] = options[:name] if options[:name]

data/lib/schwarm_cli/commands/repo_skills.rb

@@ -23,10 +23,7 @@ module SchwarmCli
       def show(id)
         handle_errors do
           data = client.repo_skills.find(id)
-          output_record(data, fields: {
-                          "ID" => "id", "Repository" => "github_repository_id",
-                          "Skill" => "skill_id", "Created" => "created_at"
-                        })
+          output_record(data, fields: repo_skill_fields)
         end
       end
 
@@ -38,8 +35,7 @@ module SchwarmCli
           data = client.repo_skills.create(
             github_repository_id: resolve_repo(options[:repo]), skill_id: options[:skill]
           )
-          output_record(data, fields: { "ID" => "id", "Repository" => "github_repository_id",
-                                        "Skill" => "skill_id" })
+          output_record(data, fields: repo_skill_fields)
         end
       end
 
@@ -50,6 +46,13 @@ module SchwarmCli
           puts "Repository-skill association #{id} deleted."
         end
       end
+
+      private
+
+      def repo_skill_fields
+        { "ID" => "id", "Repository" => "github_repository_name",
+          "Skill" => "skill_name", "Created" => "created_at" }
+      end
     end
   end
 end

data/lib/schwarm_cli/commands/secrets.rb

@@ -5,11 +5,14 @@ module SchwarmCli
     class Secrets < Base
       desc "list", "List secret files"
       option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
+      option :query, type: :string, desc: "Search by path"
       pagination_options
       def list
         handle_errors do
           data = fetch_paged do |page_params|
-            client.secrets.list(repository_id: resolve_repo(options[:repo]), **page_params)
+            client.secrets.list(
+              repository_id: resolve_repo(options[:repo]), query: options[:query], **page_params
+            )
           end
           output_list(data, columns: [%w[ID id], %w[REPO github_repository_name], %w[PATH path]])
         end

data/lib/schwarm_cli/commands/skill_files.rb

@@ -3,9 +3,8 @@
 module SchwarmCli
   module Commands
     class SkillFilesCmd < Base
-      class_option :skill, type: :string, required: true, desc: "Skill ID"
-
       desc "list", "List skill files"
+      option :skill, type: :string, required: true, desc: "Skill ID"
       pagination_options
       def list
         handle_errors do
@@ -17,39 +16,46 @@ module SchwarmCli
       end
 
       desc "show ID", "Show skill file details"
+      option :skill, type: :string, required: true, desc: "Skill ID"
       def show(id)
         handle_errors do
           data = client.skill_files.find(skill_id: options[:skill], id:)
-          output_record(data, fields: {
-                          "ID" => "id", "Path" => "path", "Content" => "content", "Created" => "created_at"
-                        })
+          output_record(data, fields: skill_file_fields)
         end
       end
 
       desc "create", "Create a skill file"
-      option :path, type: :string, required: true, desc: "File path"
-      option :content, type: :string, desc: "File content"
-      option :file, type: :string, desc: "Read content from file"
+      option :skill, type: :string, required: true, desc: "Skill ID"
+      option :path, type: :string, required: true, desc: "File path within the skill (e.g. SKILL.md)"
+      option :content, type: :string, desc: "File content (mutually exclusive with --file)"
+      option :file, type: :string, desc: "Read content from file (mutually exclusive with --content)"
       def create
         handle_errors do
-          content = read_content
-          data = client.skill_files.create(skill_id: options[:skill], path: options[:path], content:)
-          output_record(data, fields: { "ID" => "id", "Path" => "path" })
+          data = client.skill_files.create(
+            skill_id: options[:skill], path: options[:path],
+            content: read_content(required: true)
+          )
+          output_record(data, fields: skill_file_fields)
         end
       end
 
       desc "update ID", "Update a skill file"
+      option :skill, type: :string, required: true, desc: "Skill ID"
       option :path, type: :string, desc: "File path"
-      option :content, type: :string, desc: "File content"
-      option :file, type: :string, desc: "Read content from file"
+      option :content, type: :string, desc: "File content (mutually exclusive with --file)"
+      option :file, type: :string, desc: "Read content from file (mutually exclusive with --content)"
       def update(id)
         handle_errors do
-          data = client.skill_files.update(skill_id: options[:skill], id:, **update_attrs)
-          output_record(data, fields: { "ID" => "id", "Path" => "path" })
+          data = client.skill_files.update(
+            skill_id: options[:skill], id:,
+            path: options[:path], content: read_content(required: false)
+          )
+          output_record(data, fields: skill_file_fields)
         end
       end
 
       desc "delete ID", "Delete a skill file"
+      option :skill, type: :string, required: true, desc: "Skill ID"
       def delete(id)
         handle_errors do
           client.skill_files.destroy(skill_id: options[:skill], id:)
@@ -59,21 +65,23 @@ module SchwarmCli
 
       private
 
-      def update_attrs
-        {}.tap do |attrs|
-          attrs[:path] = options[:path] if options[:path]
-          attrs[:content] = read_content if options[:content] || options[:file]
-        end
+      def skill_file_fields
+        { "ID" => "id", "Path" => "path", "Skill" => "skill_id",
+          "Created" => "created_at", "Updated" => "updated_at" }
       end
 
-      def read_content
-        if options[:file]
-          file_path = File.expand_path(options[:file])
-          abort "Error: File not found: #{file_path}" unless File.exist?(file_path)
-          File.read(file_path)
-        else
-          options[:content]
-        end
+      def read_content(required:)
+        abort "Error: --content and --file are mutually exclusive." if options[:content] && options[:file]
+        return options[:content] if options[:content]
+        return read_file(options[:file]) if options[:file]
+
+        abort "Error: one of --content or --file is required." if required
+      end
+
+      def read_file(path)
+        expanded = File.expand_path(path)
+        abort "Error: File not found: #{expanded}" unless File.exist?(expanded)
+        File.read(expanded)
       end
     end
   end

data/lib/schwarm_cli/commands/templates.rb

@@ -19,10 +19,7 @@ module SchwarmCli
       def show(id)
         handle_errors do
           data = client.templates.find(id)
-          output_record(data, fields: {
-                          "ID" => "id", "Name" => "name", "Description" => "description",
-                          "Prompt" => "prompt_prefix", "Created" => "created_at"
-                        })
+          output_record(data, fields: template_fields)
         end
       end
 
@@ -36,7 +33,7 @@ module SchwarmCli
           attrs[:description] = options[:description] if options[:description]
 
           data = client.templates.create(**attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name" })
+          output_record(data, fields: template_fields)
         end
       end
 
@@ -47,7 +44,7 @@ module SchwarmCli
       def update(id)
         handle_errors do
           data = client.templates.update(id, **update_attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name" })
+          output_record(data, fields: template_fields)
         end
       end
 
@@ -61,6 +58,11 @@ module SchwarmCli
 
       private
 
+      def template_fields
+        { "ID" => "id", "Name" => "name", "Description" => "description",
+          "Prompt" => "prompt_prefix", "Created" => "created_at", "Updated" => "updated_at" }
+      end
+
       def update_attrs
         {}.tap do |attrs|
           attrs[:name] = options[:name] if options[:name]

data/lib/schwarm_cli/version.rb

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

data/schwarm-skill.md

@@ -266,13 +266,18 @@ for tasks in a repository.
    ```bash
    schwarm repo-skills create --repo <REPO_ID> --skill <SKILL_ID>
    ```
-3. Create a repository agent (custom instructions for all tasks in a repo):
+3. Create an agent (a reusable definition with a name, prompt, and optional schedule):
    ```bash
-   schwarm agents create --repo <REPO_ID> --name "Code style" --prompt "Always follow the project's eslint config"
+   schwarm agents create --name "Code style" --prompt "Always follow the project's eslint config"
    ```
-4. List agents for a repo:
+4. Subscribe an agent to a repository so it runs against that repo:
    ```bash
-   schwarm agents list --repo <REPO_ID>
+   schwarm agents subscriptions create --repo <REPO_ID> --agent <AGENT_ID>
+   ```
+5. List subscriptions for a repo, or all agents:
+   ```bash
+   schwarm agents subscriptions list --repo <REPO_ID>
+   schwarm agents list
    ```
 
 ## Tips

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schwarm-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 platform: ruby
 authors:
 - Vincent Garrigues
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: faraday-net_http_persistent
   requirement: !ruby/object:Gem::Requirement
@@ -103,6 +117,7 @@ files:
 - lib/schwarm_cli/client/task_templates.rb
 - lib/schwarm_cli/client/tasks.rb
 - lib/schwarm_cli/client/user_messages.rb
+- lib/schwarm_cli/commands/agent_subscriptions.rb
 - lib/schwarm_cli/commands/agents.rb
 - lib/schwarm_cli/commands/base.rb
 - lib/schwarm_cli/commands/configure.rb
@@ -112,7 +127,6 @@ files:
 - 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

data/lib/schwarm_cli/commands/shared_agents.rb

@@ -1,84 +0,0 @@
-# frozen_string_literal: true
-
-module SchwarmCli
-  module Commands
-    class SharedAgentsCmd < Base
-      desc "list", "List shared agents"
-      option :query, type: :string, desc: "Search by name"
-      pagination_options
-      def list
-        handle_errors do
-          data = fetch_paged do |page_params|
-            client.shared_agents.list(query: options[:query], **page_params)
-          end
-          output_list(data, columns: [%w[ID id], %w[NAME name], %w[ENABLED enabled],
-                                      %w[SCHEDULE schedule]])
-        end
-      end
-
-      desc "show ID", "Show shared agent details"
-      def show(id)
-        handle_errors do
-          data = client.shared_agents.find(id)
-          output_record(data, fields: {
-                          "ID" => "id", "Name" => "name", "Enabled" => "enabled",
-                          "Schedule" => "schedule", "Prompt" => "prompt",
-                          "Created" => "created_at", "Updated" => "updated_at"
-                        })
-        end
-      end
-
-      desc "create", "Create a shared agent"
-      option :name, type: :string, required: true, desc: "Agent name"
-      option :prompt, type: :string, required: true, desc: "Agent prompt"
-      option :schedule, type: :string, desc: "Cron schedule"
-      def create
-        handle_errors do
-          attrs = { name: options[:name], prompt: options[:prompt] }
-          attrs[:schedule] = options[:schedule] if options[:schedule]
-
-          data = client.shared_agents.create(**attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
-        end
-      end
-
-      desc "update ID", "Update a shared agent"
-      option :name, type: :string, desc: "Agent name"
-      option :prompt, type: :string, desc: "Agent prompt"
-      option :schedule, type: :string, desc: "Cron schedule"
-      def update(id)
-        handle_errors do
-          data = client.shared_agents.update(id, **update_attrs)
-          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
-        end
-      end
-
-      desc "delete ID", "Delete a shared agent"
-      def delete(id)
-        handle_errors do
-          client.shared_agents.destroy(id)
-          puts "Shared agent #{id} deleted."
-        end
-      end
-
-      desc "toggle ID", "Toggle shared agent enabled/disabled"
-      def toggle(id)
-        handle_errors do
-          data = client.shared_agents.toggle(id)
-          status = data.dig("data", "enabled") ? "enabled" : "disabled"
-          puts "Shared agent #{id} #{status}."
-        end
-      end
-
-      private
-
-      def update_attrs
-        {}.tap do |attrs|
-          attrs[:name] = options[:name] if options[:name]
-          attrs[:prompt] = options[:prompt] if options[:prompt]
-          attrs[:schedule] = options[:schedule] if options[:schedule]
-        end
-      end
-    end
-  end
-end