shellmates 0.1.0

package/scripts/launch.sh

@@ -0,0 +1,183 @@
+#!/usr/bin/env bash
+# launch.sh — Start or restore the shellmates session
+#
+# Usage:
+#   ./scripts/launch.sh                             # 2-pane: Gemini + Claude
+#   ./scripts/launch.sh --codex                     # 2-pane: Codex + Claude
+#   ./scripts/launch.sh --session myname            # Custom session name (default: orchestra)
+#   ./scripts/launch.sh --purpose "phase 3 work"   # Describe what this session is for
+#
+# Pane layout:
+#   0.0  — Sub-agent (Gemini CLI or Codex CLI)
+#   0.1  — Orchestrator (Claude Code)
+
+set -euo pipefail
+
+SESSION="orchestra"
+SUB_AGENT="gemini"   # "gemini" or "codex"
+PROJECT_DIR="${PWD}"
+PURPOSE=""
+MANIFEST_DIR="${HOME}/.shellmates"
+MANIFEST_FILE="${MANIFEST_DIR}/sessions.json"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --codex)     SUB_AGENT="codex"; shift ;;
+    --session)   SESSION="$2"; shift 2 ;;
+    --dir)       PROJECT_DIR="$2"; shift 2 ;;
+    --purpose)   PURPOSE="$2"; shift 2 ;;
+    -h|--help)
+      echo "Usage: $0 [--codex] [--session name] [--dir path] [--purpose \"description\"]"
+      exit 0 ;;
+    *) echo "Unknown option: $1"; exit 1 ;;
+  esac
+done
+
+# Default purpose if not provided
+if [[ -z "$PURPOSE" ]]; then
+  PURPOSE="$(basename "$PROJECT_DIR") session"
+fi
+
+# Check dependencies
+check_dep() {
+  if ! command -v "$1" &>/dev/null; then
+    echo "ERROR: '$1' not found. Install it first."
+    echo "  Claude Code:  npm install -g @anthropic-ai/claude-code"
+    echo "  Gemini CLI:   npm install -g @google/gemini-cli"
+    echo "  Codex CLI:    npm install -g @openai/codex"
+    exit 1
+  fi
+}
+
+check_dep tmux
+check_dep claude
+
+if [[ "$SUB_AGENT" == "codex" ]]; then
+  check_dep codex
+else
+  check_dep gemini
+fi
+
+# If session already exists, just attach
+if tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "Session '$SESSION' already exists. Attaching..."
+  echo "(Use 'bash scripts/status.sh' to see all active sessions)"
+  tmux attach-session -t "$SESSION"
+  exit 0
+fi
+
+echo "Creating tmux session '$SESSION'..."
+echo "  Sub-agent:   $SUB_AGENT (pane 0.0)"
+echo "  Orchestrator: claude   (pane 0.1)"
+echo "  Project dir: $PROJECT_DIR"
+echo "  Purpose:     $PURPOSE"
+echo ""
+
+# Create session and split into two panes
+tmux new-session -d -s "$SESSION" -c "$PROJECT_DIR"
+tmux split-window -h -t "$SESSION:0" -c "$PROJECT_DIR"
+tmux select-layout -t "$SESSION:0" even-horizontal
+
+# Capture stable pane IDs (these survive pane reordering, unlike positional 0.0/0.1)
+AGENT_PANE=$(tmux list-panes -t "$SESSION:0" -F '#{pane_id}' | sed -n '1p')
+CLAUDE_PANE=$(tmux list-panes -t "$SESSION:0" -F '#{pane_id}' | sed -n '2p')
+
+# Label panes for clarity
+tmux select-pane -t "$AGENT_PANE" -T "sub-agent ($SUB_AGENT)"
+tmux select-pane -t "$CLAUDE_PANE" -T "orchestrator (claude)"
+
+# Enable pane border titles
+tmux set-option -w -t "$SESSION:0" pane-border-status top 2>/dev/null || true
+
+# Read permission mode from config
+CONFIG_FILE="${HOME}/.shellmates/config.json"
+PERMISSION_MODE=$(python3 -c "
+import json, os
+cfg = '${CONFIG_FILE}'
+if os.path.exists(cfg):
+    d = json.load(open(cfg))
+    print(d.get('permission_mode', 'default'))
+else:
+    print('default')
+" 2>/dev/null || echo "default")
+
+# Start sub-agent with appropriate permission flags
+if [[ "$SUB_AGENT" == "codex" ]]; then
+  [[ "$PERMISSION_MODE" == "bypass" ]] && tmux send-keys -t "$AGENT_PANE" "codex --full-auto" Enter || tmux send-keys -t "$AGENT_PANE" "codex" Enter
+else
+  [[ "$PERMISSION_MODE" == "bypass" ]] && tmux send-keys -t "$AGENT_PANE" "gemini --yolo" Enter || tmux send-keys -t "$AGENT_PANE" "gemini" Enter
+fi
+
+# Wait for agent shell to initialize, then verify it launched
+sleep 2
+AGENT_CMD=$(tmux display-message -p -t "$AGENT_PANE" '#{pane_current_command}' 2>/dev/null || echo "unknown")
+if [[ "$AGENT_CMD" == "bash" || "$AGENT_CMD" == "zsh" || "$AGENT_CMD" == "sh" ]]; then
+  echo "WARNING: $SUB_AGENT may not have started (pane is still running $AGENT_CMD)."
+  echo "  After attaching, check the left pane and run: $SUB_AGENT"
+  echo ""
+else
+  echo "  $SUB_AGENT started (pane $AGENT_PANE, process: $AGENT_CMD)"
+fi
+
+# Start Claude in right pane
+tmux send-keys -t "$CLAUDE_PANE" "claude" Enter
+sleep 2
+CLAUDE_CMD=$(tmux display-message -p -t "$CLAUDE_PANE" '#{pane_current_command}' 2>/dev/null || echo "unknown")
+if [[ "$CLAUDE_CMD" == "bash" || "$CLAUDE_CMD" == "zsh" || "$CLAUDE_CMD" == "sh" ]]; then
+  echo "WARNING: Claude Code may not have started (pane is still running $CLAUDE_CMD)."
+  echo "  After attaching, check the right pane and run: claude"
+  echo ""
+else
+  echo "  Claude started  (pane $CLAUDE_PANE, process: $CLAUDE_CMD)"
+fi
+
+# Register session in the manifest
+mkdir -p "$MANIFEST_DIR"
+LAUNCHED_AT=$(date -u '+%Y-%m-%dT%H:%M:%SZ')
+
+python3 - <<PYEOF
+import json, os
+
+manifest_file = "$MANIFEST_FILE"
+entry = {
+  "name": "$SESSION",
+  "purpose": "$PURPOSE",
+  "project_dir": "$PROJECT_DIR",
+  "agents": ["$SUB_AGENT"],
+  "launched_at": "$LAUNCHED_AT",
+  "panes": {
+    "$SUB_AGENT": "$AGENT_PANE",
+    "claude": "$CLAUDE_PANE"
+  }
+}
+
+if os.path.exists(manifest_file):
+  with open(manifest_file) as f:
+    data = json.load(f)
+else:
+  data = {"sessions": []}
+
+# Replace any existing entry with the same session name
+data["sessions"] = [s for s in data["sessions"] if s["name"] != "$SESSION"]
+data["sessions"].append(entry)
+
+with open(manifest_file, "w") as f:
+  json.dump(data, f, indent=2)
+PYEOF
+
+echo ""
+echo "Session registered."
+echo ""
+
+# Show or open the session view automatically
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+bash "$SCRIPT_DIR/view-session.sh" "$SESSION" "$CLAUDE_PANE"
+
+echo ""
+echo "Tips:"
+echo "  Switch panes:   Ctrl+b then arrow keys"
+echo "  Detach:         Ctrl+b then d"
+echo "  Re-attach:      tmux attach -t $SESSION"
+echo "  All sessions:   bash scripts/status.sh"
+echo "  Close session:  bash scripts/teardown.sh"

package/scripts/monitor.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# monitor.sh — Background watcher for sub-agent panes
+#
+# Watches one or more tmux panes and reports:
+#   - PHASE_COMPLETE signals
+#   - AWAITING_INSTRUCTIONS signals
+#   - Error keywords (error, failed, crash, exception, traceback)
+#   - New git commits
+#
+# Usage:
+#   ./scripts/monitor.sh                          # Watch orchestra:0.0 (default)
+#   ./scripts/monitor.sh orchestra:0.0            # Explicit pane target
+#   ./scripts/monitor.sh full:0.0 full:0.2        # Watch multiple panes
+#   ./scripts/monitor.sh --interval 10 full:0.0   # Custom poll interval (seconds)
+#
+# Run in background:
+#   ./scripts/monitor.sh > /tmp/orchestra-monitor.log 2>&1 &
+#   tail -f /tmp/orchestra-monitor.log
+
+set -euo pipefail
+
+INTERVAL=15
+TARGETS=()
+PROJECT_DIR="${PWD}"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --interval) INTERVAL="$2"; shift 2 ;;
+    --dir)      PROJECT_DIR="$2"; shift 2 ;;
+    -h|--help)
+      echo "Usage: $0 [--interval N] [--dir path] [pane-target...]"
+      echo "  Default pane: orchestra:0.0"
+      exit 0 ;;
+    *) TARGETS+=("$1"); shift ;;
+  esac
+done
+
+# Default target
+if [[ ${#TARGETS[@]} -eq 0 ]]; then
+  TARGETS=("orchestra:0.0")
+fi
+
+log() {
+  echo "[$(date '+%H:%M:%S')] $*"
+}
+
+log "Monitoring ${#TARGETS[@]} pane(s): ${TARGETS[*]}"
+log "Poll interval: ${INTERVAL}s | Project: ${PROJECT_DIR}"
+log "Press Ctrl+C to stop."
+echo ""
+
+# Track state per pane
+declare -A LAST_STATE
+declare -A LAST_COMMIT
+
+for TARGET in "${TARGETS[@]}"; do
+  LAST_STATE[$TARGET]=""
+  LAST_COMMIT[$TARGET]=$(git -C "$PROJECT_DIR" log --oneline -1 --format="%H" 2>/dev/null || echo "")
+done
+
+while true; do
+  for TARGET in "${TARGETS[@]}"; do
+    # Capture last N lines of pane
+    PANE_TAIL=$(tmux capture-pane -t "$TARGET" -p 2>/dev/null | tail -10) || {
+      log "[$TARGET] WARNING: could not capture pane — is the session running?"
+      continue
+    }
+
+    # Detect PHASE_COMPLETE
+    if echo "$PANE_TAIL" | grep -q "PHASE_COMPLETE:"; then
+      SIGNAL=$(echo "$PANE_TAIL" | grep "PHASE_COMPLETE:" | tail -1)
+      if [[ "$SIGNAL" != "${LAST_STATE[$TARGET]:-}" ]]; then
+        log "[$TARGET] >>> $SIGNAL"
+        LAST_STATE[$TARGET]="$SIGNAL"
+      fi
+    fi
+
+    # Detect AWAITING_INSTRUCTIONS
+    if echo "$PANE_TAIL" | grep -q "AWAITING_INSTRUCTIONS"; then
+      if [[ "${LAST_STATE[$TARGET]:-}" != "AWAITING" ]]; then
+        log "[$TARGET] >>> Sub-agent idle — AWAITING_INSTRUCTIONS"
+        LAST_STATE[$TARGET]="AWAITING"
+      fi
+    fi
+
+    # Detect shell prompt (agent returned to shell — likely done or crashed)
+    if echo "$PANE_TAIL" | grep -qE "\\\$ $|> $"; then
+      if [[ "${LAST_STATE[$TARGET]:-}" != "SHELL" ]]; then
+        log "[$TARGET] >>> Shell prompt detected — agent may have exited"
+        LAST_STATE[$TARGET]="SHELL"
+      fi
+    fi
+
+    # Detect errors
+    if echo "$PANE_TAIL" | grep -qiE "(^error|failed:|crash|exception|traceback|SyntaxError)"; then
+      log "[$TARGET] !!! POSSIBLE ERROR — last 15 lines:"
+      tmux capture-pane -t "$TARGET" -p 2>/dev/null | tail -15 | sed "s/^/  [$TARGET] /"
+    fi
+
+    # Detect new git commits
+    CURRENT_COMMIT=$(git -C "$PROJECT_DIR" log --oneline -1 --format="%H" 2>/dev/null || echo "")
+    if [[ -n "$CURRENT_COMMIT" && "$CURRENT_COMMIT" != "${LAST_COMMIT[$TARGET]:-}" && -n "${LAST_COMMIT[$TARGET]:-}" ]]; then
+      COMMIT_MSG=$(git -C "$PROJECT_DIR" log --oneline -1 2>/dev/null)
+      log "[$TARGET] >>> NEW COMMIT: $COMMIT_MSG"
+      LAST_COMMIT[$TARGET]="$CURRENT_COMMIT"
+    elif [[ -z "${LAST_COMMIT[$TARGET]:-}" ]]; then
+      LAST_COMMIT[$TARGET]="$CURRENT_COMMIT"
+    fi
+  done
+
+  sleep "$INTERVAL"
+done

package/scripts/spawn-team.sh

@@ -0,0 +1,302 @@
+#!/usr/bin/env bash
+# spawn-team.sh — Spawn an agent team and delegate a task in one command
+#
+# This is the frictionless interface to shellmates.
+# Tell it what you want done — it handles session creation, agent startup,
+# task dispatch, and ping-back. No tmux knowledge required.
+#
+# Usage:
+#   bash scripts/spawn-team.sh --task "check GSD status" --project ~/Projects
+#   bash scripts/spawn-team.sh --task-file /tmp/my-task.txt --agent codex
+#   bash scripts/spawn-team.sh --task "run phase 3" --workers 2
+#
+# The agent will notify your current pane when done via AGENT_PING.
+# You don't need to poll — just wait for the ping to appear.
+#
+# Options:
+#   --task        Inline task description
+#   --task-file   Path to detailed task file (preferred for multi-step tasks)
+#   --agent       Agent type: gemini (default) or codex
+#   --workers     Number of parallel agents (1-2, default: 1)
+#   --project     Project directory (default: current working directory)
+#   --session     Session name (default: auto-generated from timestamp)
+#   --purpose     Short label shown in status.sh (default: first line of task)
+#   --ping-back   Pane ID to notify when done (default: your current pane)
+#   --no-ping     Don't send AGENT_PING (fire-and-forget mode)
+#   --attach      Attach to the new session after launching (default: no)
+#   -h|--help     Show this help
+
+set -euo pipefail
+
+TASK_INLINE=""
+TASK_FILE=""
+AGENT="gemini"
+WORKERS=1
+PROJECT_DIR="${PWD}"
+SESSION=""
+PURPOSE=""
+PING_BACK_PANE=""
+NO_PING=false
+ATTACH=false
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MANIFEST_DIR="${HOME}/.shellmates"
+MANIFEST_FILE="${MANIFEST_DIR}/sessions.json"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --task)       TASK_INLINE="$2"; shift 2 ;;
+    --task-file)  TASK_FILE="$2"; shift 2 ;;
+    --agent)      AGENT="$2"; shift 2 ;;
+    --workers)    WORKERS="$2"; shift 2 ;;
+    --project)    PROJECT_DIR="$2"; shift 2 ;;
+    --session)    SESSION="$2"; shift 2 ;;
+    --purpose)    PURPOSE="$2"; shift 2 ;;
+    --ping-back)  PING_BACK_PANE="$2"; shift 2 ;;
+    --no-ping)    NO_PING=true; shift ;;
+    --no-view)    ATTACH=false; shift ;;
+    --attach)     ATTACH=true; shift ;;
+    -h|--help)
+      sed -n '2,25p' "$0" | sed 's/^# //' | sed 's/^#//'
+      exit 0 ;;
+    *) echo "ERROR: Unknown option: $1"; exit 1 ;;
+  esac
+done
+
+# Validate input
+if [[ -z "$TASK_INLINE" && -z "$TASK_FILE" ]]; then
+  echo "ERROR: Provide --task or --task-file"
+  echo "  Example: $0 --task \"check GSD status\" --project ~/Projects"
+  exit 1
+fi
+
+if [[ -n "$TASK_FILE" && ! -f "$TASK_FILE" ]]; then
+  echo "ERROR: Task file not found: $TASK_FILE"
+  exit 1
+fi
+
+if [[ "$WORKERS" -lt 1 || "$WORKERS" -gt 2 ]]; then
+  echo "ERROR: --workers must be 1 or 2"
+  exit 1
+fi
+
+# Resolve project dir
+PROJECT_DIR="$(cd "$PROJECT_DIR" && pwd)"
+
+# Auto-generate session name from timestamp if not provided
+if [[ -z "$SESSION" ]]; then
+  SESSION="team-$(date +%H%M%S)"
+fi
+
+# Auto-detect purpose from first line of task
+if [[ -z "$PURPOSE" ]]; then
+  if [[ -n "$TASK_FILE" ]]; then
+    PURPOSE=$(grep -m1 '.' "$TASK_FILE" | sed 's/^#* *//' | cut -c1-50)
+  else
+    PURPOSE=$(echo "$TASK_INLINE" | head -1 | cut -c1-50)
+  fi
+fi
+
+# Resolve ping-back pane
+if [[ -z "$PING_BACK_PANE" && "$NO_PING" == "false" ]]; then
+  if [[ -n "${TMUX_PANE:-}" ]]; then
+    PING_BACK_PANE="$TMUX_PANE"
+  elif [[ -n "${TMUX:-}" ]]; then
+    PING_BACK_PANE=$(tmux display-message -p '#{pane_id}' 2>/dev/null || echo "")
+  fi
+
+  if [[ -z "$PING_BACK_PANE" ]]; then
+    echo "NOTE: Not running inside tmux — ping-back disabled."
+    echo "  You'll need to poll the agent pane manually to check progress."
+    echo "  Or use --ping-back PANE_ID to specify where to send the completion notification."
+    NO_PING=true
+  fi
+fi
+
+# Check for existing session
+if tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "ERROR: Session '$SESSION' already exists."
+  echo "  Use a different name: --session my-task-name"
+  echo "  Or check existing: bash $SCRIPT_DIR/status.sh"
+  exit 1
+fi
+
+# Check agent is available
+if ! command -v "$AGENT" &>/dev/null; then
+  echo "ERROR: '$AGENT' not found."
+  [[ "$AGENT" == "gemini" ]] && echo "  Install: npm install -g @google/gemini-cli"
+  [[ "$AGENT" == "codex" ]]  && echo "  Install: npm install -g @openai/codex"
+  exit 1
+fi
+
+echo "Spawning team: $SESSION"
+echo "  Agent:   $AGENT × $WORKERS"
+echo "  Project: $PROJECT_DIR"
+echo "  Task:    $PURPOSE"
+[[ "$NO_PING" == "false" ]] && echo "  Ping:    $PING_BACK_PANE"
+echo ""
+
+# ── Create session ──────────────────────────────────────────────────────────
+
+tmux new-session -d -s "$SESSION" -c "$PROJECT_DIR"
+tmux set-option -w -t "$SESSION:0" pane-border-status top 2>/dev/null || true
+
+# First worker pane (already created with new-session)
+PANE_1=$(tmux list-panes -t "$SESSION:0" -F '#{pane_id}' | sed -n '1p')
+tmux select-pane -t "$PANE_1" -T "worker-1 ($AGENT)"
+
+PANE_2=""
+if [[ "$WORKERS" -eq 2 ]]; then
+  tmux split-window -h -t "$SESSION:0" -c "$PROJECT_DIR"
+  tmux select-layout -t "$SESSION:0" even-horizontal
+  PANE_2=$(tmux list-panes -t "$SESSION:0" -F '#{pane_id}' | sed -n '2p')
+  tmux select-pane -t "$PANE_2" -T "worker-2 ($AGENT)"
+fi
+
+# ── Start agents ─────────────────────────────────────────────────────────────
+
+CONFIG_FILE="${HOME}/.shellmates/config.json"
+PERMISSION_MODE=$(python3 -c "
+import json, os
+cfg = '${CONFIG_FILE}'
+if os.path.exists(cfg):
+    d = json.load(open(cfg))
+    print(d.get('permission_mode', 'default'))
+else:
+    print('default')
+" 2>/dev/null || echo "default")
+
+agent_start_cmd() {
+  local agent="$1"
+  if [[ "$PERMISSION_MODE" == "bypass" ]]; then
+    case "$agent" in
+      gemini) echo "gemini --yolo" ;;
+      codex)  echo "codex --full-auto" ;;
+      *)      echo "$agent" ;;
+    esac
+  else
+    echo "$agent"
+  fi
+}
+
+start_agent() {
+  local pane="$1"
+  local label="$2"
+  local cmd
+  cmd=$(agent_start_cmd "$AGENT")
+  echo -n "Starting $cmd in $label..."
+  tmux send-keys -t "$pane" "$cmd" Enter
+
+  # Wait until the agent prompt is visible (not just process started)
+  local elapsed=0
+  while [[ $elapsed -lt 15 ]]; do
+    sleep 1
+    elapsed=$((elapsed + 1))
+    local cmd
+    cmd=$(tmux display-message -p -t "$pane" '#{pane_current_command}' 2>/dev/null || echo "unknown")
+    if [[ "$cmd" != "bash" && "$cmd" != "zsh" && "$cmd" != "sh" && "$cmd" != "fish" ]]; then
+      # Process is an agent — now wait for the prompt to appear
+      if tmux capture-pane -t "$pane" -p 2>/dev/null | grep -q "Type your message"; then
+        echo " ready ($cmd)"
+        return 0
+      fi
+    fi
+  done
+
+  # Timeout — show what we got
+  local cmd
+  cmd=$(tmux display-message -p -t "$pane" '#{pane_current_command}' 2>/dev/null || echo "unknown")
+  if [[ "$cmd" == "bash" || "$cmd" == "zsh" || "$cmd" == "sh" ]]; then
+    echo " WARNING: agent may not have started (still $cmd)"
+  else
+    echo " OK ($cmd — prompt not yet visible)"
+  fi
+}
+
+start_agent "$PANE_1" "worker-1"
+
+if [[ "$WORKERS" -eq 2 ]]; then
+  start_agent "$PANE_2" "worker-2"
+fi
+
+# ── Register in manifest ──────────────────────────────────────────────────────
+
+mkdir -p "$MANIFEST_DIR"
+LAUNCHED_AT=$(date -u '+%Y-%m-%dT%H:%M:%SZ')
+ALL_PANES="\"worker-1\": \"$PANE_1\""
+[[ -n "$PANE_2" ]] && ALL_PANES="$ALL_PANES, \"worker-2\": \"$PANE_2\""
+
+python3 - <<PYEOF
+import json, os
+
+manifest_file = "$MANIFEST_FILE"
+panes = {"worker-1": "$PANE_1"}
+if "$PANE_2":
+    panes["worker-2"] = "$PANE_2"
+
+entry = {
+    "name": "$SESSION",
+    "purpose": "$PURPOSE",
+    "project_dir": "$PROJECT_DIR",
+    "agents": ["$AGENT"] * $WORKERS,
+    "launched_at": "$LAUNCHED_AT",
+    "panes": panes
+}
+
+if os.path.exists(manifest_file):
+    with open(manifest_file) as f:
+        data = json.load(f)
+else:
+    data = {"sessions": []}
+
+data["sessions"] = [s for s in data["sessions"] if s["name"] != "$SESSION"]
+data["sessions"].append(entry)
+
+with open(manifest_file, "w") as f:
+    json.dump(data, f, indent=2)
+PYEOF
+
+# ── Dispatch task ─────────────────────────────────────────────────────────────
+
+echo ""
+echo "Dispatching task to worker-1..."
+
+DISPATCH_ARGS="--pane $PANE_1 --no-view"  # spawn-team handles view itself
+
+if [[ -n "$TASK_FILE" ]]; then
+  DISPATCH_ARGS="$DISPATCH_ARGS --task-file $TASK_FILE"
+else
+  INLINE_TASK_FILE="/tmp/.shellmates-spawn-$$.txt"
+  echo "$TASK_INLINE" > "$INLINE_TASK_FILE"
+  DISPATCH_ARGS="$DISPATCH_ARGS --task-file $INLINE_TASK_FILE"
+fi
+
+if [[ "$NO_PING" == "true" ]]; then
+  DISPATCH_ARGS="$DISPATCH_ARGS --no-ping"
+elif [[ -n "$PING_BACK_PANE" ]]; then
+  DISPATCH_ARGS="$DISPATCH_ARGS --ping-back $PING_BACK_PANE"
+fi
+
+DISPATCH_ARGS="$DISPATCH_ARGS --task-name $SESSION"
+# shellcheck disable=SC2086
+bash "$SCRIPT_DIR/dispatch.sh" $DISPATCH_ARGS
+
+# ── Summary ───────────────────────────────────────────────────────────────────
+
+echo ""
+echo "Team spawned: $SESSION ($WORKERS worker)"
+echo ""
+
+# Open the session view automatically
+bash "$SCRIPT_DIR/view-session.sh" "$SESSION" "$PANE_1"
+
+if [[ "$NO_PING" == "false" && -n "$PING_BACK_PANE" ]]; then
+  echo "Agent will notify pane $PING_BACK_PANE when done."
+fi
+
+echo "Kill when done: bash $SCRIPT_DIR/teardown.sh"
+
+# Optionally attach (overrides view-session behaviour)
+if [[ "$ATTACH" == "true" ]]; then
+  tmux attach-session -t "$SESSION"
+fi