claude-cook 1.11.3 → 1.11.5

package/agents/cook-pm.md

@@ -109,7 +109,9 @@ When running under `/cook:pm-start` and `pm-loop.sh`, you MUST avoid asking the
 
 ## PM Loop Launch is MANDATORY
 
-When spawned by `/cook:pm-start`, you MUST launch `pm-loop.sh --background` via Bash after executing the first cycle. The only exception is when `--manual` flag is explicitly set. Without the loop, the PM does one cycle and stops — defeating the purpose of autonomous operation. Do NOT wrap in `nohup` or append `&` — the `--background` flag handles detaching internally via `setsid`/`disown`. The script prints the PID and exits immediately.
+When spawned by `/cook:pm-start`, you MUST launch `pm-loop.sh` as a **regular foreground Bash command** after executing the first cycle. The only exception is when `--manual` flag is explicitly set. Without the loop, the PM does one cycle and stops — defeating the purpose of autonomous operation.
+
+**IMPORTANT:** Use the Bash tool as a regular foreground command (do NOT set `run_in_background`). This streams live output directly in the conversation area so the user sees progress bars, status updates, and poll results in real-time. Do NOT use `--background` flag, `nohup`, `setsid`, `disown`, or `&`. Do NOT set `timeout` on the Bash tool — the loop runs indefinitely until milestone complete or `.pm-stop`. The user can press Ctrl+B to push the loop to background and interact with Claude.
 
 </philosophy>
 

package/commands/cook/pm-start.md

@@ -142,38 +142,44 @@ Follow the action for the detected state as defined in `pm-cycle.md`:
 
 **You MUST launch pm-loop.sh unless `--manual` flag is explicitly set.** This is not optional. The loop is what makes the PM autonomous — without it, the PM does one cycle and stops.
 
-**If `--manual` is NOT set**, run this command via Bash tool immediately after the first cycle completes:
+**If `--manual` is NOT set**, launch pm-loop.sh as a **foreground Bash command** immediately after the first cycle completes:
 
 ```bash
 ~/.claude/scripts/pm-loop.sh \
   --phase={X} \
   --interval={poll_interval} \
   --max-iterations={max_iterations} \
-  --background \
   ${init_flag} \
   ${prd_flag}
 ```
 
-**IMPORTANT:** Do NOT wrap this in `nohup` or append `&`. The `--background` flag makes `pm-loop.sh` handle its own detaching internally (via `setsid` or `nohup+disown`). The script prints the PID, writes the pid file, and exits immediately — the loop continues in a fully detached process.
+**IMPORTANT:**
+
+- Use the Bash tool as a **regular foreground command** (do NOT set `run_in_background`). This streams live output directly in the conversation area so the user sees progress bars, status updates, and poll results in real-time.
+- Do NOT use `--background` flag, `nohup`, `setsid`, `disown`, or `&`.
+- Do NOT set `timeout` on the Bash tool — the loop runs indefinitely until milestone complete or `.pm-stop`.
+- The user can press **Ctrl+B** at any time to push the loop to background and interact with Claude. They can check on it later via `/bashes` or by asking Claude to check the output.
 
 Where:
 - `${init_flag}` is `--init` if the `--init` flag was provided
 - `${prd_flag}` is `--prd=<file>` if provided
 - Phase is auto-detected or from arguments
 
-After launching, confirm to user:
+Before launching, present to user:
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- PM ► LOOP STARTED
+ PM ► LAUNCHING LOOP
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-PM loop running in background (PID: {pid})
-Polling every {interval}s
+PM loop starting. Live output will stream below.
+Polling every {interval}s.
 
+Press Ctrl+B to push to background and interact.
 Stop with: /cook:pm-stop
-Status:    /cook:pm-status
 ```
 
+Then immediately invoke the Bash tool with the pm-loop.sh command.
+
 Stop with: `touch .planning/.pm-stop` | `/cook:pm-stop`
 
 **If `--manual` IS set**, do NOT launch the loop. Present:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-cook",
-  "version": "1.11.3",
+  "version": "1.11.5",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code, OpenCode and Gemini by TÂCHES.",
   "bin": {
     "claude-cook": "bin/install.js"