From 8129b5736b91780f4751e339d977839d6241ac03 Mon Sep 17 00:00:00 2001
From: Sheldon Finlay <sheldon@outerlimitsmedia.com>
Date: Fri, 27 Mar 2026 12:42:01 -0400
Subject: [PATCH] =?UTF-8?q?fix:=20platform-aware=20terminal=20launch=20?=
 =?UTF-8?q?=E2=80=94=20osascript=20on=20macOS,=20fallback=20on=20Linux?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 skills/run/SKILL.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/skills/run/SKILL.md b/skills/run/SKILL.md
index bb924bf..b2ca227 100644
--- a/skills/run/SKILL.md
+++ b/skills/run/SKILL.md
@@ -113,16 +113,22 @@ LOOP_CMD=".loop/loop.sh"
 tmux kill-session -t agent-loop 2>/dev/null; tmux new-session -d -s agent-loop -c <project_root> "$LOOP_CMD"
 ```
 
-7. Open a new terminal window attached to the tmux session:
+7. Open the tmux session for the user. Try platform-specific methods:
 
+**macOS** (check `uname` = Darwin):
 ```bash
 osascript -e 'tell application "Terminal" to do script "tmux attach -t agent-loop"'
 ```
 
+**Linux/other** — cannot open a terminal programmatically. Tell the user:
+```
+! tmux attach -t agent-loop
+```
+
 8. Tell the user:
 
-> **Loop launched.** A terminal window opened with the live session.
-> - **Detach** (keep loop running, close window): `Ctrl+B` then `D`
+> **Loop launched.**
+> - **Detach** (keep loop running): `Ctrl+B` then `D`
 > - **Stop the loop**: `Ctrl+C` in the tmux window
 > - **Reattach later**: `tmux attach -t agent-loop`
 > - Ask me "status" anytime and I'll check progress for you.