triflux 8.12.2 → 9.0.0

package/scripts/session-spawn-helper.mjs

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from "node:fs";
+import { spawn, execFileSync } from "node:child_process";
+import { resolve } from "node:path";
+
+const SESSION_PREFIX = "tfx-isolated";
+const DEFAULT_ATTACH_PROFILE = "triflux";
+const SESSION_EXPIRE_MS = 30 * 60 * 1000;
+
+const STOP_WORDS = new Set([
+  "a", "an", "and", "as", "at", "be", "by", "for", "from", "in",
+  "is", "it", "of", "on", "or", "that", "the", "to", "with",
+  "작업", "요청", "합니다", "그리고", "에서", "으로",
+]);
+
+// ── psmux helpers ──
+
+function hasPsmux() {
+  try {
+    execFileSync("psmux", ["-V"], { timeout: 2000, stdio: "ignore" });
+    return true;
+  } catch { return false; }
+}
+
+function psmux(...args) {
+  execFileSync("psmux", args, { timeout: 5000, stdio: "ignore" });
+}
+
+function psmuxCapture(sessionName) {
+  try {
+    return execFileSync("psmux", ["capture-pane", "-t", sessionName, "-p"], {
+      timeout: 5000, encoding: "utf8",
+    }).trim();
+  } catch { return ""; }
+}
+
+function psmuxHasSession(sessionName) {
+  try {
+    execFileSync("psmux", ["has-session", "-t", sessionName], { timeout: 2000, stdio: "ignore" });
+    return true;
+  } catch { return false; }
+}
+
+// ── core functions ──
+
+export function createIsolatedSessionName(timestamp = Date.now()) {
+  return `${SESSION_PREFIX}-${Math.trunc(timestamp)}`;
+}
+
+export function createIsolatedSession(options = {}) {
+  const ts = options.timestamp ?? Date.now();
+  const sessionName = options.name || createIsolatedSessionName(ts);
+
+  psmux("new-session", "-s", sessionName, "-d");
+
+  // cd to project root
+  const projectRoot = options.projectRoot || process.cwd();
+  psmux("send-keys", "-t", sessionName, `cd '${projectRoot}'`, "Enter");
+
+  // send prompt as claude command
+  if (options.prompt) {
+    const safePrompt = options.prompt.replace(/'/g, "'\\''");
+    psmux("send-keys", "-t", sessionName, `claude --prompt '${safePrompt}'`, "Enter");
+  }
+
+  return { sessionName };
+}
+
+export function attachWithWindowsTerminal(sessionName, options = {}) {
+  const profile = options.profile || DEFAULT_ATTACH_PROFILE;
+  const title = options.title || sessionName;
+
+  // sp (split-pane), not new-tab
+  const wtArgs = ["sp", "-p", profile, "--title", title, "--", "psmux", "attach-session", "-t", sessionName];
+  const child = spawn("wt.exe", wtArgs, { detached: true, stdio: "ignore", windowsHide: false });
+  child.unref();
+  return wtArgs;
+}
+
+export function waitForCompletion(sessionName, opts = {}) {
+  const pollMs = opts.pollMs || 3000;
+  const maxMs = opts.maxMs || SESSION_EXPIRE_MS;
+  const start = Date.now();
+
+  return new Promise((res) => {
+    const check = () => {
+      if (!psmuxHasSession(sessionName) || Date.now() - start > maxMs) {
+        const output = psmuxCapture(sessionName);
+        // cleanup expired session
+        try { psmux("kill-session", "-t", sessionName); } catch {}
+        res({ sessionName, output, expired: Date.now() - start > maxMs });
+        return;
+      }
+      setTimeout(check, pollMs);
+    };
+    check();
+  });
+}
+
+// ── context drift (kept from codex) ──
+
+function tokenize(text) {
+  return String(text || "").toLowerCase()
+    .split(/[^\p{L}\p{N}_-]+/u)
+    .filter((t) => t.length >= 2 && !STOP_WORDS.has(t));
+}
+
+export function evaluateContextDrift(input = {}) {
+  const taskTokens = Array.from(new Set(tokenize(input.taskPrompt)));
+  if (!taskTokens.length) return { drift: false, overlapRatio: 1, reason: "task-token-empty" };
+
+  const outputTokens = new Set(tokenize(input.latestOutput));
+  const matched = taskTokens.filter((t) => outputTokens.has(t));
+  const ratio = matched.length / taskTokens.length;
+  const threshold = input.minOverlapRatio ?? 0.2;
+
+  return { drift: ratio < threshold, overlapRatio: ratio, reason: ratio < threshold ? "token-overlap-low" : "token-overlap-ok" };
+}
+
+// ── CLI ──
+
+function parseArgs(argv) {
+  const a = { spawn: false, prompt: "", attach: false, background: false, name: "" };
+  for (let i = 2; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--spawn") { a.spawn = true; continue; }
+    if (arg === "--attach") { a.attach = true; continue; }
+    if (arg === "--background") { a.background = true; continue; }
+    if ((arg === "--prompt" || arg === "-p") && argv[i + 1]) { a.prompt = argv[++i]; continue; }
+    if ((arg === "--name" || arg === "-n") && argv[i + 1]) { a.name = argv[++i]; continue; }
+  }
+  return a;
+}
+
+async function main() {
+  const args = parseArgs(process.argv);
+
+  if (!args.spawn) {
+    process.stdout.write([
+      "session-spawn-helper: psmux 격리 세션 생성 도구",
+      "",
+      "사용법:",
+      "  node scripts/session-spawn-helper.mjs --spawn --prompt '작업 내용' [--attach] [--background] [--name 세션명]",
+      "",
+      "옵션:",
+      "  --spawn        세션 생성 (필수)",
+      "  --prompt TEXT   Claude에 전달할 프롬프트",
+      "  --attach        WT split-pane으로 attach",
+      "  --background    attach 없이 실행, 완료 시 결과 출력",
+      "  --name NAME     세션 이름 (기본: tfx-isolated-{ts})",
+      "",
+    ].join("\n"));
+    process.exit(0);
+  }
+
+  if (!hasPsmux()) {
+    process.stderr.write("ERROR: psmux가 설치되어 있지 않습니다. npm install -g psmux\n");
+    process.exit(1);
+  }
+
+  const { sessionName } = createIsolatedSession({
+    name: args.name || undefined,
+    prompt: args.prompt || undefined,
+    projectRoot: process.cwd(),
+  });
+
+  process.stdout.write(`[session-spawn] 세션 생성: ${sessionName}\n`);
+
+  if (args.attach) {
+    attachWithWindowsTerminal(sessionName);
+    process.stdout.write(`[session-spawn] WT split-pane attach 완료\n`);
+  }
+
+  if (args.background) {
+    process.stdout.write(`[session-spawn] 백그라운드 대기 중...\n`);
+    const result = await waitForCompletion(sessionName);
+    const preview = (result.output || "(no output)").slice(0, 200);
+    process.stdout.write(`[session-spawn] 완료: ${sessionName} | expired=${result.expired} | preview=${preview}\n`);
+  }
+}
+
+if (process.argv[1]?.endsWith("session-spawn-helper.mjs")) {
+  main().catch((e) => { process.stderr.write(`${e.message}\n`); process.exit(1); });
+}

package/scripts/setup.mjs

@@ -10,6 +10,7 @@ import { homedir } from "os";
 import { spawn, execFileSync } from "child_process";
 import { fileURLToPath } from "url";
 import { cleanupTmpFiles } from "./tmp-cleanup.mjs";
+import { buildAll as buildCacheWarmup } from "./cache-warmup.mjs";
 
 const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const CLAUDE_DIR = join(homedir(), ".claude");
@@ -824,17 +825,15 @@ if (existsSync(mcpCheck)) {
   child.unref(); // 부모 프로세스와 분리 — 비동기 실행
 }
 
-// ── 캐시 빌드업 Phase 1 (백그라운드) ──
+// ── Step 6. 캐시 웜업 Phase 1 ──
 
-const cacheBuildupScript = join(PLUGIN_ROOT, "scripts", "cache-buildup.mjs");
-if (existsSync(cacheBuildupScript)) {
-  const child2 = spawn(process.execPath, [cacheBuildupScript], {
-    detached: true,
-    stdio: "ignore",
-    windowsHide: true,
+try {
+  buildCacheWarmup({
     cwd: process.cwd(),
+    ttlMs: 5 * 60 * 1000,
   });
-  child2.unref();
+} catch {
+  // cache-warmup 실패는 setup 전체를 막지 않는다
 }
 
 // ── /tmp 임시 파일 자동 정리 (setup 지연 방지: fire-and-forget) ──

package/scripts/tfx-route-worker.mjs

@@ -14,6 +14,13 @@ const FACTORY_CANDIDATES = [
 // MCP transport 실패 시 tfx-route.sh가 exec fallback을 수행할 수 있도록
 // CODEX_MCP_TRANSPORT_EXIT_CODE(70)으로 종료한다.
 const MCP_TRANSPORT_EXIT_CODE = 70;
+const GEMINI_RETRY_DELAY_MS = 5000;
+const GEMINI_RETRY_PATTERN_SNIPPETS = [
+  '429',
+  'quota',
+  'rate limit',
+  'resource_exhausted',
+];
 
 let createWorker = null;
 
@@ -129,6 +136,57 @@ function resolveDefaultMcpConfig(cwd) {
   return [];
 }
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function isGeminiQuotaRetrySignal(error) {
+  if (Number(error?.result?.exitCode) === 429) {
+    return true;
+  }
+
+  const fragments = [
+    error?.message,
+    error?.stderr,
+    error?.result?.stderr,
+  ]
+    .filter((value) => typeof value === 'string' && value.trim().length > 0)
+    .map((value) => value.toLowerCase());
+
+  if (fragments.length === 0) return false;
+  const merged = fragments.join('\n');
+  return GEMINI_RETRY_PATTERN_SNIPPETS.some((pattern) => merged.includes(pattern));
+}
+
+async function runWorker(worker, type, prompt) {
+  const maxAttempts = type === 'gemini' ? 2 : 1;
+  let lastError = null;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+    try {
+      return await worker.run(prompt);
+    } catch (error) {
+      lastError = error;
+      const shouldRetry = (
+        type === 'gemini'
+        && attempt < maxAttempts
+        && isGeminiQuotaRetrySignal(error)
+      );
+
+      if (!shouldRetry) {
+        throw error;
+      }
+
+      process.stderr.write(
+        '[tfx-route-worker] Gemini 429/quota 감지 — 5초 후 1회 재시도합니다.\n',
+      );
+      await sleep(GEMINI_RETRY_DELAY_MS);
+    }
+  }
+
+  throw lastError;
+}
+
 const args = parseArgs(process.argv.slice(2));
 const prompt = readPromptFromStdin();
 
@@ -148,7 +206,7 @@ const worker = createWorker(args.type, {
 });
 
 try {
-  const result = await worker.run(prompt);
+  const result = await runWorker(worker, args.type, prompt);
   if (result.response) {
     process.stdout.write(result.response);
     if (!result.response.endsWith('\n')) process.stdout.write('\n');

package/skills/merge-worktree/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: merge-worktree
+description: "워크트리 브랜치를 main으로 squash-merge + conventional commit 자동 생성. codex-swarm 워크트리 자동 인식. '머지해', 'merge worktree', '워크트리 머지', '결과 수집', 'squash merge' 요청에 사용."
+argument-hint: "[target-branch]"
+disable-model-invocation: true
+---
+
+# Merge Worktree
+
+워크트리 브랜치를 대상 브랜치로 squash-merge하고 conventional commit 메시지를 자동 작성한다.
+
+## Current context
+
+* Git dir: `!git rev-parse --git-dir`
+* Current branch: `!git branch --show-current`
+* Recent commits: `!git log --oneline -20`
+* Working tree status: `!git status --short`
+
+## Instructions
+
+### Phase 1: Validation
+
+1. **Worktree 확인**: `git rev-parse --git-dir` 출력에 `/worktrees/`가 포함되어야 한다. 아니면 중지.
+
+2. **현재 브랜치 확인**: `git branch --show-current`
+
+3. **대상 브랜치 결정**:
+   * `$ARGUMENTS`가 있으면 해당 브랜치 사용
+   * 없으면 `main` 존재 확인, 없으면 `master`
+
+4. **원본 레포 경로 확인**: `git rev-parse --git-common-dir`의 부모 디렉토리
+
+5. **클린 상태 확인**: `git status --porcelain`이 비어있어야 한다. 미커밋 변경이 있으면 먼저 커밋/스태시 안내.
+
+### Phase 2: Research
+
+1. **커밋 이력**: `git log --oneline <target>..HEAD`
+
+2. **변경 파일 요약**: `git diff <target>...HEAD --stat`
+
+3. **전체 diff**: `git diff <target>...HEAD` — 꼼꼼히 읽는다.
+
+4. **핵심 파일 읽기**: 가장 큰 변경, 신규 파일, 삭제 파일을 Read로 확인.
+
+5. **변경 분류**:
+   * Features (신규 기능)
+   * Fixes (버그 수정)
+   * Refactors (구조 변경)
+   * Tests (테스트)
+   * Docs (문서)
+   * Config/Chore (빌드, CI, 의존성)
+
+6. **dominant type 결정**: `feat`, `fix`, `refactor`, `docs`, `chore`, `test` 중 하나
+
+### Phase 3: 대상 브랜치 준비
+
+1. **대상 브랜치 최근 커밋 확인**: `git -C <원본레포> log --oneline -10 <target>`
+
+2. **WIP 커밋 감지**: `wip:`, `auto-commit`, `WIP` 시작 커밋이 있으면 사용자에게 경고.
+
+3. **최신 fetch**: `git -C <원본레포> fetch origin <target> 2>/dev/null`
+
+### Phase 4: Squash Merge
+
+1. **대상 브랜치 checkout**:
+   ```
+   git -C <원본레포> checkout <target>
+   ```
+
+2. **squash merge 실행**:
+   ```
+   git -C <원본레포> merge --squash <워크트리브랜치>
+   ```
+
+3. **충돌 처리**: 충돌 발생 시 충돌 파일 목록 + 마커를 보여주고 **중지**. 자동 해결 시도 금지.
+
+### Phase 5: 커밋 메시지 작성 + 커밋
+
+Phase 2 분석 기반으로 아래 구조의 커밋 메시지를 작성한다:
+
+```
+<type>: <명령형 요약, 72자 이내, 마침표 없음>
+
+<무엇을 왜 했는지 2-4문장. 동기와 접근 방식 중심.>
+
+Changes:
+* <그룹별 변경 사항>
+* <하위 항목은 서브 불릿>
+```
+
+**규칙:**
+* `<type>`은 `feat`, `fix`, `refactor`, `docs`, `chore`, `test` 중 하나
+* 여러 유형이 섞이면 dominant 사용
+* 요약: 명령형 ("add", "fix", "refactor"), 마침표 없음, 72자 제한
+* 본문: *왜*와 *맥락*, *무엇*만이 아님
+* Changes: 관련 항목 그룹핑, 중요한 것 먼저
+* Co-Authored-By 푸터 **절대 추가 금지** (글로벌 설정 `includeCoAuthoredBy: false`)
+
+**커밋 실행**:
+```bash
+git -C <원본레포> commit -m "$(cat <<'EOF'
+<커밋 메시지>
+EOF
+)"
+```
+
+### Phase 6: 정리 + 검증
+
+1. **커밋 확인**: `git -C <원본레포> log --oneline -3`
+
+2. **워크트리 자동 정리**:
+   ```bash
+   git -C <원본레포> worktree remove <워크트리경로>
+   git -C <원본레포> branch -d <워크트리브랜치>
+   ```
+
+3. **codex-swarm 정리 감지**: 워크트리 경로가 `.codex-swarm/wt-*` 패턴이면:
+   * 같은 `.codex-swarm/` 디렉토리에 다른 워크트리가 남아있는지 확인
+   * 모든 워크트리가 머지 완료되었으면 `.codex-swarm/` 전체 정리 제안
+   * `git worktree prune` 실행
+
+4. **결과 보고**:
+   * 커밋 해시 + 요약
+   * 머지 대상 브랜치
+   * 워크트리 정리 완료 여부
+   * push 안내 (`git push`)
+
+## codex-swarm 연동
+
+이 스킬은 `tfx-codex-swarm`의 Step 10 "결과 수집"에서 자동으로 호출된다.
+codex-swarm이 완료한 각 워크트리에 대해 순차적으로 실행:
+
+```
+각 워크트리에 대해:
+  1. 워크트리로 cd
+  2. /merge-worktree main
+  3. 다음 워크트리로 이동
+```
+
+## 주의사항
+
+* force-push, destructive 연산은 사용자 확인 없이 절대 실행 금지
+* pre-commit hook 건너뛰기(`--no-verify`) 금지
+* 예상치 못한 상황이면 추측하지 말고 **중지 후 설명**

package/skills/tfx-analysis/SKILL.md

@@ -11,6 +11,7 @@ argument-hint: "<분석 대상 — 파일, 디렉토리, 또는 주제>"
 
 # tfx-analysis — Light Code Analysis
 
+> **Deep 버전**: tfx-deep-analysis. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
 > Codex 단일 분석으로 빠른 인사이트. SuperClaude sc:analyze 영감.
 
 ## 용도

package/skills/tfx-auto/SKILL.md

@@ -33,6 +33,7 @@ argument-hint: "<command|task> [args...]"
 > 3. **DAG**: SEQUENTIAL/DAG이면 레벨 기반 순차 실행. `.omc/context/{sid}/` 생성, context_output 저장, 실패 시 후속 SKIP.
 > 4. **트리아지**: Codex `exec --full-auto` 분류 + Opus 인라인 분해. Agent 스폰 금지.
 > 5. **thorough**: `-t`/`--thorough` 시 파이프라인 init 필수. 커맨드 숏컷은 항상 quick.
+> 6. **직접 수정 금지**: implement/review/analyze 등 커맨드 숏컷 실행 시 절대로 Edit/Write 도구로 직접 코드를 수정하지 마라. 반드시 Bash(tfx-route.sh)를 통해 Codex/Gemini에 위임하라. 작업이 아무리 사소해도 예외 없음.
 
 ## 모드
 

package/skills/tfx-auto-codex/SKILL.md

@@ -8,6 +8,7 @@ argument-hint: "\"작업 설명\" | N:agent_type \"작업 설명\""
 
 # tfx-auto-codex — Codex 리드형 tfx-auto
 
+> **래퍼**: tfx-auto의 Codex 전용 바로가기. TFX_NO_CLAUDE_NATIVE=1.
 > 목적: 기존 `tfx-auto`의 오케스트레이션 패턴을 유지하면서
 > Claude 네이티브 역할(`explore`, `verifier`, `test-engineer`, `qa-tester`)을
 > Codex로 치환해 Codex/Gemini만으로 실행한다.

package/skills/tfx-autopilot/SKILL.md

@@ -1,11 +1,10 @@
 ---
 name: tfx-autopilot
-description: "간단한 작업을 자율적으로 구현해야 할 때 사용한다. 'autopilot', '자동으로', '알아서 해', '그냥 해줘', 'auto' 같은 요청에 반드시 사용. 명확한 단일 작업을 빠르게 자동 구현+검증할 때 적극 활용."
+description: "간단한 작업을 자율적으로 구현해야 할 때 사용한다. 'autopilot', '자동으로', '알아서 해', '그냥 해줘' 같은 요청에 반드시 사용. 명확한 단일 작업을 빠르게 자동 구현+검증할 때 적극 활용."
 triggers:
   - autopilot
   - 자동
   - 알아서 해
-  - auto
 argument-hint: "<구현할 작업 설명>"
 ---
 

package/skills/tfx-codex/SKILL.md

@@ -8,6 +8,8 @@ argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
 
 # tfx-codex — Codex-Only 오케스트레이터
 
+> **래퍼**: tfx-auto의 Codex 전용 바로가기. TFX_CLI_MODE=codex.
+> **HARD RULE**: Claude는 이 스킬에서 Edit/Write를 사용하면 안 된다. 모든 코드 수정은 Codex CLI를 통해 수행한다.
 > Codex CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
 > Gemini CLI가 없는 환경에서 사용합니다.
 

package/skills/tfx-codex-swarm/SKILL.md

@@ -13,8 +13,18 @@ description: OMX 스킬을 활용하는 Codex 다중 세션 스폰 오케스트
 - `codex` CLI 설치됨
 - `psmux` 설치됨 (세션 관리)
 - `git` (worktree 생성)
-- Windows Terminal (탭 기반 attach)
 - Windows Terminal (`wt.exe` 탭 기반 attach)
+- MCP 싱글톤 데몬 (`supergateway` + `mcp-remote`) — 선택적이나 스웜 시 강력 권장
+
+## 설정
+
+| 설정 | 기본값 | 설명 |
+|------|--------|------|
+| MAX_CONCURRENCY | 4 | 동시 실행 세션 수. 초과분은 큐 대기 후 순차 시작 |
+| WT_ATTACH_MODE | attach | `attach`: split-pane 직접 attach (기본). `dashboard`: 모니터링 탭만 |
+| MCP_DAEMON_REQUIRED | true | MCP 싱글톤 데몬 사전 확인 필수. false면 세션별 MCP 직접 스폰 (비권장) |
+
+사용자가 명시하지 않으면 기본값 사용. AskUserQuestion으로 오버라이드 가능.
 
 ## 워크플로우
 
@@ -267,7 +277,13 @@ git worktree add .codex-swarm/wt-issue-{N} codex/issue-{N}
 cp {PRD_PATH} .codex-swarm/wt-issue-{N}/{PRD_PATH}
 ```
 
-### Step 7: psmux 세션 생성 + Codex 실행
+### Step 7: psmux 세션 생성 + Codex 실행 (웨이브 방식)
+
+**MAX_CONCURRENCY(기본 4)에 따라 웨이브 단위로 실행한다.**
+- Wave 1: 태스크 1~MAX_CONCURRENCY 동시 시작
+- Wave 2+: 이전 웨이브에서 완료된 슬롯만큼 다음 태스크 시작
+- 완료 감지: `psmux capture-pane`으로 codex 종료 여부 확인 (30초 폴링)
+- 전체 태스크 > MAX_CONCURRENCY일 때만 큐잉 적용
 
 각 태스크에 대해 psmux 세션을 생성하고 Codex를 실행한다:
 
@@ -293,26 +309,39 @@ psmux send-keys -t "codex-swarm-{id}" \
 # --skip-git-repo-check: codex exec 전용이므로 대화식 모드에서 사용 불가
 ```
 
-### Step 8: WT triflux 프로파일로 attach
+### Step 8: WT attach
 
 > WT `triflux` 프로파일 사용 필수 (`commandline: "psmux"`, One Half Dark, acrylic).
-> triflux 프로파일은 psmux를 기본 셸로 쓰므로 attach가 바로 동작한다.
-> 탭 대신 split-pane 사용 (feedback: WT 새탭 금지, split+dashboard 기본).
+> 기본은 **split-pane 직접 attach**. 4개 이하 2x2 그리드, 5개 이상은 사용자 확인.
 
 ```bash
-# 단일 세션: triflux 프로파일로 attach
-wt.exe -w new -p triflux --title "{title1}" psmux attach-session -t codex-swarm-{id1}
-
-# 다중 세션: split-pane (상/하 분할)
-wt.exe -w new \
-  -p triflux --title "{title1}" psmux attach-session -t codex-swarm-{id1} \; \
-  split-pane -H -p triflux --title "{title2}" psmux attach-session -t codex-swarm-{id2}
-
-# 3개 이상: 추가 split-pane
-wt.exe -w new \
-  -p triflux --title "{title1}" psmux attach-session -t codex-swarm-{id1} \; \
-  split-pane -H -p triflux --title "{title2}" psmux attach-session -t codex-swarm-{id2} \; \
-  split-pane -V -p triflux --title "{title3}" psmux attach-session -t codex-swarm-{id3}
+# 2개: 상하 분할
+wt.exe -w 0 \
+  sp -H -p triflux --title "{t1}" psmux attach-session -t {id1} \; \
+  sp -V -p triflux --title "{t2}" psmux attach-session -t {id2}
+
+# 4개: 2x2 그리드
+wt.exe -w 0 \
+  sp -H -p triflux --title "{t1}" psmux attach-session -t {id1} \; \
+  sp -V -p triflux --title "{t2}" psmux attach-session -t {id2} \; \
+  move-focus up \; \
+  sp -V -p triflux --title "{t3}" psmux attach-session -t {id3} \; \
+  move-focus down \; \
+  sp -V -p triflux --title "{t4}" psmux attach-session -t {id4}
+```
+
+5개 이상이면 AskUserQuestion으로 확인 후 dashboard 모드 제안:
+```bash
+# dashboard 모드 (모니터링 전용)
+wt.exe -w 0 -p triflux --title "swarm-dashboard" bash -c '
+  while true; do
+    clear; echo "=== Codex Swarm Dashboard ==="
+    for s in $(psmux list-sessions -F "#{session_name}" 2>/dev/null | grep codex-swarm); do
+      echo "  [$s] $(psmux capture-pane -t "$s" -p | tail -1)"
+    done
+    sleep 10
+  done
+'
 ```
 
 ### Step 9: 상태 보고
@@ -432,6 +461,21 @@ for bin in codex psmux git; do
     exit 1
   }
 done
+
+# MCP 싱글톤 데몬 검사 (MCP_DAEMON_REQUIRED=true일 때)
+if [ "$MCP_DAEMON_REQUIRED" != "false" ]; then
+  DAEMON_OK=true
+  for port in 9001 9002 9003 9004 9005; do
+    curl -s --max-time 1 "http://localhost:$port/sse" >/dev/null 2>&1 || {
+      DAEMON_OK=false
+      break
+    }
+  done
+  if [ "$DAEMON_OK" = "false" ]; then
+    echo "WARN: MCP daemons not running. Starting..."
+    powershell -ExecutionPolicy Bypass -File "$HOME/.codex/mcp-daemon/start-daemons.ps1"
+  fi
+fi
 ```
 
 ## 정리

package/skills/tfx-codex-swarm/mcp-daemon/start-daemons.ps1

@@ -0,0 +1,54 @@
+# MCP Singleton Daemons - supergateway wrapper
+# Each OMX MCP server runs once, codex sessions connect via mcp-remote
+# Usage: powershell -ExecutionPolicy Bypass -File start-daemons.ps1
+
+$OMX_BASE = "$env:APPDATA/npm/node_modules/oh-my-codex/dist/mcp"
+$SG_CMD = "$env:APPDATA\npm\supergateway.cmd"
+$DAEMON_DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+$servers = @(
+    @{ Name = "omx_state";      Script = "state-server.js";      Port = 9001 }
+    @{ Name = "omx_memory";     Script = "memory-server.js";     Port = 9002 }
+    @{ Name = "omx_code_intel"; Script = "code-intel-server.js"; Port = 9003 }
+    @{ Name = "omx_trace";      Script = "trace-server.js";      Port = 9004 }
+    @{ Name = "omx_team_run";   Script = "team-server.js";       Port = 9005 }
+)
+
+foreach ($srv in $servers) {
+    $port = $srv.Port
+    $name = $srv.Name
+    $script = "$OMX_BASE/$($srv.Script)"
+
+    # Check if already running on this port
+    $existing = Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue
+    if ($existing) {
+        Write-Host "[SKIP] $name already running on port $port"
+        continue
+    }
+
+    # Create individual launcher .cmd
+    $launcher = Join-Path $DAEMON_DIR "run-$name.cmd"
+    $content = "@echo off`r`ncall `"$SG_CMD`" --stdio `"node $script`" --port $port"
+    Set-Content -Path $launcher -Value $content -Encoding ASCII
+
+    Write-Host "[START] $name on port $port"
+    Start-Process -WindowStyle Hidden -FilePath $launcher
+
+    Start-Sleep -Milliseconds 800
+}
+
+Start-Sleep -Milliseconds 1000
+
+# Verify
+$ok = 0
+foreach ($srv in $servers) {
+    $c = Get-NetTCPConnection -LocalPort $srv.Port -ErrorAction SilentlyContinue
+    if ($c) {
+        Write-Host "[OK] $($srv.Name) listening on port $($srv.Port)"
+        $ok++
+    } else {
+        Write-Host "[FAIL] $($srv.Name) NOT listening on port $($srv.Port)"
+    }
+}
+Write-Host ""
+Write-Host "$ok / $($servers.Count) daemons running"

package/skills/tfx-codex-swarm/mcp-daemon/stop-daemons.ps1

@@ -0,0 +1,15 @@
+# Stop all MCP singleton daemons
+# Usage: powershell -ExecutionPolicy Bypass -File stop-daemons.ps1
+
+9001..9005 | ForEach-Object {
+    $port = $_
+    $conn = Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue
+    if ($conn) {
+        $pid = $conn[0].OwningProcess
+        Write-Host "[STOP] Killing PID $pid on port $port"
+        Stop-Process -Id $pid -Force -ErrorAction SilentlyContinue
+    } else {
+        Write-Host "[SKIP] Nothing on port $port"
+    }
+}
+Write-Host "All MCP daemons stopped."