From e810d1a1dbea8ffba9a128e7b2e2fc40a06783aa Mon Sep 17 00:00:00 2001
From: Sheldon Finlay <sheldon@outerlimitsmedia.com>
Date: Fri, 27 Mar 2026 12:10:12 -0400
Subject: [PATCH] fix: attach to tmux session instead of detaching

---
 skills/run/SKILL.md | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/skills/run/SKILL.md b/skills/run/SKILL.md
index e68da7a..9d53336 100644
--- a/skills/run/SKILL.md
+++ b/skills/run/SKILL.md
@@ -107,25 +107,24 @@ LOOP_CMD=".loop/loop.sh"
 # Add --max N if specified
 ```
 
-6. Launch in tmux:
+6. Tell the user what's about to happen:
 
-```bash
-tmux new-session -d -s agent-loop -c <project_root> "$LOOP_CMD"
-```
-
-7. Report to the user:
-
-> **Loop launched in tmux session `agent-loop`**
+> **Launching loop in tmux...**
 > - Stories: {total} to complete
 > - Mode: {mode}
 >
-> **Monitor:**
-> - Watch live: `tmux attach -t agent-loop`
-> - Check progress: read `.loop/progress.md`
-> - Check status: read `.loop/prd.json`
-> - Stop the loop: `tmux kill-session -t agent-loop`
->
-> I can also check on progress for you — just ask "how's it going?"
+> The tmux session will open now. You'll see the loop running live.
+> - **Detach** (return to Claude Code): `Ctrl+B` then `D`
+> - **Stop the loop**: `Ctrl+C` in the tmux session
+> - **Reattach later**: `tmux attach -t agent-loop`
+
+7. Launch tmux **attached** so the user sees it immediately:
+
+```bash
+tmux new-session -s agent-loop -c <project_root> "$LOOP_CMD"
+```
+
+**IMPORTANT:** Do NOT use the `-d` flag. The session must attach so the user can watch it live. The bash command will block until the user detaches (`Ctrl+B D`) or the loop finishes.
 
 ---