schwarm-cli 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fda5a7c0a0a68a6e07573a5509cadb8ea7ff600f94a3feabf065317c332a9b40
-  data.tar.gz: bfd4c31bca63d5862c9df68514c8ab3bdeefb0a1ebbd944c316aeed4522a626d
+  metadata.gz: f86723cf9675bb0de813b11efa16be17bd2b8bfa74bd9af1203130cdf7fda0f0
+  data.tar.gz: 479a9e83426d1fb675b79dd5780b14264d7a6c8454ee30404c104743aed30fdd
 SHA512:
-  metadata.gz: cf2aac68753184cd3ef7fcd28ff24eb75010b84237f2b661e76a00e1582ead6ad07b0789941f9d3c518bd40eadc34bea14d463bc83e7d69dfb62f68f165920a3
-  data.tar.gz: 9bdf3cbb26adecc1f40e90d681e9cb722bd2ae477cd7faa1ac258f3bf690cc77aa1374cb2744a8fe9bb6583b7b328b242f81e80f19ab79afa2dedad23c5d6b55
+  metadata.gz: 9e473284f4c066af2f5ed3a77cc365448574acd73a55e1f72e5d2eb94d1b11db5a95fc4fdaf23c498ecb721ef0f2f596ff753c1c869726446a66d6ae622cf167
+  data.tar.gz: b3d2498b0dcea13e9ed75ea1ee865fdf25658a31a5552059cfb617efcead48600f46008fbd4f580766250daa6b99f38619412a4c4cfa32175f6736b7f45e7c3e

data/lib/schwarm_cli/commands/tasks.rb

@@ -32,7 +32,6 @@ module SchwarmCli
       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, owner/repo, or GitHub URL"
       option :status, type: :string, desc: "Initial status (draft/waiting)"
       option :template, type: :string, desc: "Template ID"
@@ -47,7 +46,6 @@ module SchwarmCli
       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, owner/repo, or GitHub URL"
       option :depends_on, type: :array, desc: "Dependency task IDs"
       def update(id)
@@ -116,12 +114,11 @@ module SchwarmCli
 
       desc "handoff", "Hand off the current local branch to schwarm as a ready task"
       option :prompt, type: :string, desc: "Task prompt"
-      option :prompt_file, type: :string, desc: "Read prompt from file"
       option :repo, type: :string, desc: "Repository ID, owner/repo, or GitHub URL (skips origin auto-detect)"
       option :name, type: :string, desc: "Task name (defaults to the branch name)"
       def handoff
-        prompt = read_prompt
-        abort "Error: --prompt or --prompt-file is required." if prompt.nil? || prompt.strip.empty?
+        prompt = options[:prompt]
+        abort "Error: --prompt is required." if prompt.nil? || prompt.strip.empty?
 
         handle_errors do
           result = SchwarmCli::HandsOffTask.new(client: client).call(
@@ -153,7 +150,7 @@ module SchwarmCli
 
       def create_attrs
         {
-          name: options[:name], prompt: read_prompt,
+          name: options[:name], prompt: options[:prompt],
           github_repository_id: resolve_repo(options[:repo]), status: options[:status],
           task_template_id: options[:template], dependency_ids: options[:depends_on]
         }.compact
@@ -164,17 +161,7 @@ module SchwarmCli
           name: options[:name], github_repository_id: resolve_repo(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]
+          attrs[:prompt] = options[:prompt] if options[:prompt]
         end
       end
     end

data/lib/schwarm_cli/version.rb

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

data/schwarm-skill.md

@@ -32,7 +32,14 @@ The `schwarm` CLI is installed and configured (`schwarm configure`).
    ```bash
    schwarm tasks create --repo <REPO_ID> --name "Fix login bug" --prompt "The login form crashes when email is empty. Fix the validation in app/models/user.rb" --status ready
    ```
-   Use `--prompt-file ./prompt.md` for long prompts.
+   For a multi-line prompt, pipe via HEREDOC:
+   ```bash
+   schwarm tasks create --repo <REPO_ID> --name "Fix login bug" --status ready --prompt "$(cat <<'EOF'
+   The login form crashes when empty. Fix validation in app/models/user.rb
+   and add a regression test.
+   EOF
+   )"
+   ```
 3. Check the created task:
    ```bash
    schwarm tasks show <TASK_ID>
@@ -53,10 +60,24 @@ continues committing to it.
    ```bash
    schwarm tasks handoff --prompt "continue the validation logic, add tests"
    ```
-   Use `--prompt-file ./handoff.md` for long prompts.
 3. Take note of the task ID printed on success; you can monitor it like any
    other task.
 
+**Keep the prompt short.** The prompt is a pointer, not a spec. Before handing
+off, commit any detailed instructions, design notes, or TODOs into the repo
+(e.g. a `HANDOFF.md`, `AGENTS.md`, or inline comments) so the next agent reads
+them from the working tree. Then the `--prompt` just needs to say what to do
+next and where to look, e.g. `"continue per HANDOFF.md"`.
+
+For a multi-line prompt, use a HEREDOC rather than a file flag:
+```bash
+schwarm tasks handoff --prompt "$(cat <<'EOF'
+Continue the validation work. Start from the TODOs in app/models/user.rb
+and follow the plan in HANDOFF.md.
+EOF
+)"
+```
+
 **Watch for:**
 - The command refuses to hand off the base branch (`main`). Create a feature
   branch first.
@@ -223,7 +244,9 @@ for tasks in a repository.
 - Check task status before taking actions (e.g., only `retry` works on `error`
   tasks, only `start` works on `draft` tasks).
 - When building a DAG, create all tasks as drafts first, then start them all.
-- For long prompts, write them to a file and use `--prompt-file`.
+- Keep `--prompt` short — commit long-form instructions (plans, TODOs,
+  `HANDOFF.md`) into the repo and point the prompt at them. For multi-line
+  prompts, pipe via HEREDOC: `--prompt "$(cat <<'EOF' ... EOF)"`.
 - Run `schwarm <command> help` for full flag documentation on any command.
 - `schwarm tasks list` excludes archived tasks by default. Use `--all` to
   include them or `--status archived` to see only archived.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schwarm-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Vincent Garrigues