triflux 10.60.0 → 10.61.0

package/adapters/codex/skills/tfx-live/SKILL.md

@@ -29,6 +29,8 @@ tfx-live ask --cli codex --session cx1 --prompt "현재 변경사항을 요약
 tfx-live stop --cli codex --session cx1
 ```
 
+macOS의 iTerm2에서 로컬 tmux 세션을 `start`하면 리드가 있는 창에 attach 탭이나 패인을 연다. `LC_TERMINAL=iTerm2` 또는 `TERM_PROGRAM=iTerm.app`일 때만 적용하며, 원격과 tmux 세션이 없는 daemon 경로는 제외한다. 같은 `--group NAME`은 한 탭에서 세로로 나누고 다른 그룹은 새 탭을 연다. `--group`을 생략하면 대상 CLI인 `claude`, `codex`, `agy`를 그룹으로 쓴다. `stop --session`은 tmux 종료 뒤 남은 iTerm 패인도 닫는다. 연동이 실패해도 세션 시작과 종료는 계속하며 결과의 `itermWarning`에 원인을 남긴다. 탭 제목은 iTerm2 Python 런타임으로 고정하며 처음 쓸 때 iTerm2 Scripts 폴더에 스크립트 하나를 설치하고, 런타임이 없으면 제목만 바뀌지 않는다.
+
 새 세션 이름은 `<월>.<일> <주제>`로 짓는다. `start --name`을 생략하면 자동으로 만들고 `nameGenerated: true`를 보고한다. `--resume` 또는 `--resume-last`는 `--name`을 명시한 경우에만 이름을 적용한다. 승계 세션에는 기존 이름 뒤에 ` 2`, 이후 ` 3`을 붙인다. 이름 적용을 요청한 경우 결과의 `nameApplied: false`는 미적용을 뜻한다. agy의 `namePending: true`는 첫 일반 ask에서 적용할 이름이 보류됐다는 뜻이다. Codex `start`는 `/rename` 제출을 입력창이 빌 때까지 확인하고, 이름으로 찾은 thread UUID를 `threadId`로 돌려주며 tmux 세션 옵션 `@tfx_codex_thread`에 남긴다. 로컬 Codex `--resume-last`는 Codex가 고른 thread를 사후에 찾는다. 띄운 뒤 공유 app-server daemon에 로드된 같은 cwd의 thread 중 rollout에 그 시각 이후의 resume 기록(`thread_settings_applied`)이 생긴 것이 정확히 하나이고 1.5초 뒤에도 같을 때만 `threadId`로 쓴다. 이 확인은 5초 안에 끝난다. TUI가 daemon을 쓰지 않거나 같은 cwd에서 동시에 resume이 일어나면 `null`이다. 기존 Codex UDS thread는 `tfx-live rename --cli codex --transport uds --thread ID --name "<이름>"`으로 이름을 바꾼다.
 
 ## agy 세션

package/bin/tfx-live.mjs

@@ -3,6 +3,7 @@ import { execFile } from "node:child_process";
 import { randomBytes } from "node:crypto";
 import { mkdirSync, realpathSync, statSync, writeFileSync } from "node:fs";
 import {
+  chmod,
   mkdir,
   open,
   readdir,
@@ -93,7 +94,7 @@ const BUG_REPORT_DIR =
 function usage(command) {
   const lines = [
     "Usage:",
-    "  tfx-live start --session NAME [--name NAME] [--cli codex|claude|agy] [--sandbox] [--unset-env PATTERNS] [--model ID] [--effort TIER] [--cwd DIR] [--remote HOST] [--resume ID] [--resume-last 1] [--ready-timeout 30] [--poll-interval 1500]",
+    "  tfx-live start --session NAME [--name NAME] [--group NAME] [--cli codex|claude|agy] [--sandbox] [--unset-env PATTERNS] [--model ID] [--effort TIER] [--cwd DIR] [--remote HOST] [--resume ID] [--resume-last 1] [--ready-timeout 30] [--poll-interval 1500]",
     "  tfx-live ask --session NAME[:WINDOW.PANE] --prompt TEXT [--cli codex|claude|agy] [--if-busy wait|fail|interrupt|queue] [--busy-timeout 60] [--timeout 60] [--remote HOST] [--settle 1500] [--poll-interval 1500]",
     "  tfx-live ask --cli codex [--transport queue|tmux] (--session NAME[:WINDOW.PANE] | --thread UUID) --prompt TEXT [--from NAME] [--timeout 60] [--no-wait]",
     "    Codex ask defaults to the app-server queue (thread/queue/add, `codex queue --message` only when add is unavailable; delivered when the TUI picks it up); tmux paste is the reported fallback and the path for slash commands.",
@@ -2470,6 +2471,151 @@ async function resumedCodexThread(
   return matches.length === 1 ? matches[0] : null;
 }
 
+const ITERM_TITLE_SCRIPT_NAME = "com.triflux.live-title.py";
+const ITERM_TITLE_SCRIPT = String.raw`#!/usr/bin/env python3
+import sys
+
+import iterm2
+
+
+async def main(connection):
+    session_id, group, name = sys.argv[1:]
+    app = await iterm2.async_get_app(connection)
+    session = app.get_session_by_id(session_id)
+    if session is None:
+        raise RuntimeError(f"iTerm session not found: {session_id}")
+    update = iterm2.LocalWriteOnlyProfile()
+    update.set_allow_title_setting(False)
+    update.set_name(name)
+    await session.async_set_profile_properties(update)
+    await session.tab.async_set_variable("user.tfxLiveGroup", group)
+    await session.tab.async_set_title(r"\(user.tfxLiveGroup)")
+    await session.async_set_variable("user.tfxLiveTitleApplied", "1")
+
+
+iterm2.run_until_complete(main)
+`;
+
+function appleScriptString(value) {
+  if (/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/u.test(value))
+    throw new Error("iTerm values must not contain control characters");
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+
+function shouldUseIterm(
+  remote,
+  platform = process.platform,
+  env = process.env,
+) {
+  return (
+    !remote &&
+    platform === "darwin" &&
+    (env.LC_TERMINAL === "iTerm2" || env.TERM_PROGRAM === "iTerm.app")
+  );
+}
+
+async function openItermSession(session, group) {
+  const groupLiteral = appleScriptString(group);
+  const sessionLiteral = appleScriptString(session);
+  const leaderId = appleScriptString(
+    process.env.ITERM_SESSION_ID?.split(":")[1] ?? "",
+  );
+  // tmux 안의 리드는 ITERM_SESSION_ID 가 tmux 를 처음 띄운 터미널 값이라, 지금 붙어 있는 클라이언트 tty 로 창을 찾는다.
+  const clients = process.env.TMUX_PANE
+    ? await runTmux(null, [
+        "list-clients",
+        "-t",
+        process.env.TMUX_PANE,
+        "-F",
+        "#{client_activity} #{client_tty}",
+      ]).catch(() => ({ stdout: "" }))
+    : { stdout: "" };
+  const leaderTty = appleScriptString(
+    clients.stdout
+      .trim()
+      .split("\n")
+      .filter(Boolean)
+      .map((line) => line.split(" "))
+      .sort((a, b) => Number(b[0]) - Number(a[0]))[0]?.[1] ?? "",
+  );
+  const { stdout: tmuxPath } = await execFileAsync("which", ["tmux"], {
+    timeout: 2000,
+  });
+  const command = appleScriptString(
+    `${shellQuote([realpathSync(tmuxPath.trim()), "attach-session", "-t"])} '=${session.replace(/'/g, `'"'"'`)}'`,
+  );
+  const script = `tell application "iTerm2"
+  set leaderWindow to current window
+  set ttyWindow to missing value
+  set idWindow to missing value
+  repeat with candidateWindow in windows
+    repeat with candidateTab in tabs of candidateWindow
+      repeat with candidateSession in sessions of candidateTab
+        if ${leaderTty} is not "" and tty of candidateSession is ${leaderTty} then set ttyWindow to candidateWindow
+        if ${leaderId} is not "" and id of candidateSession is ${leaderId} then set idWindow to candidateWindow
+      end repeat
+    end repeat
+  end repeat
+  if ttyWindow is not missing value then
+    set leaderWindow to ttyWindow
+  else if idWindow is not missing value then
+    set leaderWindow to idWindow
+  end if
+  set groupSession to missing value
+  repeat with candidateTab in tabs of leaderWindow
+    repeat with candidateSession in sessions of candidateTab
+      try
+        tell candidateSession to set candidateGroup to variable named "user.tfx_group"
+        if candidateGroup is ${groupLiteral} then
+          set groupSession to candidateSession
+          exit repeat
+        end if
+      end try
+    end repeat
+    if groupSession is not missing value then exit repeat
+  end repeat
+  set didSplit to groupSession is not missing value
+  if didSplit then
+    tell groupSession to set newSession to split vertically with default profile command ${command}
+  else
+    tell leaderWindow to set newTab to create tab with default profile command ${command}
+    set newSession to current session of newTab
+  end if
+  tell newSession
+    set variable named "user.tfx_group" to ${groupLiteral}
+    set variable named "user.tfx_session" to ${sessionLiteral}
+  end tell
+  return (id of newSession) & linefeed & (didSplit as text)
+end tell`;
+  const { stdout } = await execFileAsync("/usr/bin/osascript", ["-e", script], {
+    timeout: 5000,
+    maxBuffer: 64 * 1024,
+  });
+  const [sessionId, split] = stdout.trim().split("\n");
+  if (!sessionId || !["true", "false"].includes(split))
+    throw new Error("iTerm did not return a session ID and split status");
+  return { sessionId, group, split: split === "true" };
+}
+
+async function closeItermSession(sessionId) {
+  const script = `tell application "iTerm2"
+  repeat with candidateWindow in windows
+    repeat with candidateTab in tabs of candidateWindow
+      repeat with candidateSession in sessions of candidateTab
+        if id of candidateSession is ${appleScriptString(sessionId)} then
+          tell candidateSession to close
+          return
+        end if
+      end repeat
+    end repeat
+  end repeat
+end tell`;
+  await execFileAsync("/usr/bin/osascript", ["-e", script], {
+    timeout: 5000,
+    maxBuffer: 64 * 1024,
+  });
+}
+
 async function doStart(adapter, opts) {
   const {
     session,
@@ -2657,6 +2803,66 @@ async function doStart(adapter, opts) {
       "@tfx_codex_thread",
       threadId,
     ]).catch(() => {});
+  let iterm;
+  let itermWarning;
+  if (ready && shouldUseIterm(remote)) {
+    try {
+      iterm = await openItermSession(session, opts.group || adapter.cli);
+      await runTmux(null, [
+        "set-option",
+        "-t",
+        session,
+        "@tfx_iterm_session",
+        iterm.sessionId,
+      ]);
+      const scriptsDir = pathJoin(
+        homedir(),
+        "Library",
+        "Application Support",
+        "iTerm2",
+        "Scripts",
+      );
+      const scriptPath = pathJoin(scriptsDir, ITERM_TITLE_SCRIPT_NAME);
+      await mkdir(scriptsDir, { recursive: true });
+      const installed = await readFile(scriptPath, "utf8").catch((error) => {
+        if (error.code === "ENOENT") return null;
+        throw error;
+      });
+      if (installed !== ITERM_TITLE_SCRIPT)
+        await writeFile(scriptPath, ITERM_TITLE_SCRIPT, { mode: 0o700 });
+      await chmod(scriptPath, 0o700);
+      const titleArgs = [iterm.sessionId, iterm.group, opts.name ?? session]
+        .map(appleScriptString)
+        .join(", ");
+      // 절대 경로는 최초 설치 직후의 메뉴 캐시 지연을 피하고, 적용 표식은 비동기 실패를 잡는다.
+      const titleScript = `tell application "iTerm2"
+  set titleSession to missing value
+  repeat with candidateWindow in windows
+    repeat with candidateTab in tabs of candidateWindow
+      repeat with candidateSession in sessions of candidateTab
+        if id of candidateSession is ${appleScriptString(iterm.sessionId)} then set titleSession to candidateSession
+      end repeat
+    end repeat
+  end repeat
+  if titleSession is missing value then error "iTerm title session not found"
+  launch API script named ${appleScriptString(scriptPath)} arguments {${titleArgs}}
+  repeat 30 times
+    try
+      tell titleSession to set titleApplied to variable named "user.tfxLiveTitleApplied"
+      if titleApplied is "1" then return
+    end try
+    delay 0.1
+  end repeat
+  error "iTerm title update was not confirmed; check the iTerm2 Python runtime and Script Console"
+end tell`;
+      await execFileAsync("/usr/bin/osascript", ["-e", titleScript], {
+        timeout: 5000,
+        maxBuffer: 64 * 1024,
+      });
+    } catch (error) {
+      itermWarning = error.message;
+    }
+  }
   return addLoginGuard(adapter, raw, {
     cli: adapter.cli,
     session,
@@ -2673,6 +2879,8 @@ async function doStart(adapter, opts) {
       : {}),
     unsetEnv: opts.unsetEnv ?? [],
     unsetEnvVerified,
+    ...(iterm ? { iterm } : {}),
+    ...(itermWarning ? { itermWarning } : {}),
     ...(unsetEnvWarning ? { unsetEnvWarning } : {}),
     ...(name && adapter.cli === "codex" && !nameApplied
       ? {
@@ -3567,12 +3775,36 @@ async function doStop(adapter, opts) {
     throw new Error(
       "stop --session accepts only a session name; pass the session name without a pane target",
     );
+  let itermSessionId;
+  let itermWarning;
+  if (shouldUseIterm(remote)) {
+    try {
+      const { stdout } = await runTmux(null, [
+        "show-options",
+        "-qv",
+        "-t",
+        session,
+        "@tfx_iterm_session",
+      ]);
+      itermSessionId = stdout.trim();
+    } catch (error) {
+      itermWarning = error.message;
+    }
+  }
   await runTmux(remote, ["kill-session", "-t", session]);
+  if (itermSessionId) {
+    try {
+      await closeItermSession(itermSessionId);
+    } catch (error) {
+      itermWarning = error.message;
+    }
+  }
   return {
     cli: adapter.cli,
     session,
     remote: remote ?? null,
     stopped: true,
+    ...(itermWarning ? { itermWarning } : {}),
   };
 }
 
@@ -3705,6 +3937,7 @@ function startOpts(flags) {
     model: flags.model,
     effort: flags.effort,
     name: flags.name,
+    group: flags.group,
     sandbox: Object.hasOwn(flags, "sandbox"),
     unsetEnv,
     readyTimeoutMs: secondsFlag(
@@ -5147,6 +5380,7 @@ export {
   ADAPTERS,
   agyStepText,
   agyWaitVerdict,
+  appleScriptString,
   buildLaunchKeys,
   buildPeerClosurePrompt,
   buildRemoteLiveCommand,
@@ -5173,6 +5407,7 @@ export {
   resolveAskTransport,
   resolveCodexDaemonSocket,
   resumedCodexThread,
+  shouldUseIterm,
   splitTmuxTarget,
   stopOpts,
   tmuxBufferName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.60.0",
+  "version": "10.61.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Antigravity, and Claude",
   "type": "module",
   "bin": {

package/skills/tfx-live/SKILL.md

@@ -25,6 +25,8 @@ tfx-live ask --cli codex --session cx1 --prompt "현재 변경사항을 요약
 tfx-live stop --cli codex --session cx1
 ```
 
+macOS의 iTerm2에서 로컬 tmux 세션을 `start`하면 리드가 있는 창에 attach 탭이나 패인을 연다. `LC_TERMINAL=iTerm2` 또는 `TERM_PROGRAM=iTerm.app`일 때만 적용하며, 원격과 tmux 세션이 없는 daemon 경로는 제외한다. 같은 `--group NAME`은 한 탭에서 세로로 나누고 다른 그룹은 새 탭을 연다. `--group`을 생략하면 대상 CLI인 `claude`, `codex`, `agy`를 그룹으로 쓴다. `stop --session`은 tmux 종료 뒤 남은 iTerm 패인도 닫는다. 연동이 실패해도 세션 시작과 종료는 계속하며 결과의 `itermWarning`에 원인을 남긴다. 탭 제목은 iTerm2 Python 런타임으로 고정하며 처음 쓸 때 iTerm2 Scripts 폴더에 스크립트 하나를 설치하고, 런타임이 없으면 제목만 바뀌지 않는다.
+
 새 세션 이름은 `<월>.<일> <주제>`로 짓는다. `start --name`을 생략하면 자동으로 만들고 `nameGenerated: true`를 보고한다. `--resume` 또는 `--resume-last`는 `--name`을 명시한 경우에만 이름을 적용한다. 승계 세션에는 기존 이름 뒤에 ` 2`, 이후 ` 3`을 붙인다. 이름 적용을 요청한 경우 결과의 `nameApplied: false`는 미적용을 뜻한다. agy의 `namePending: true`는 첫 일반 ask에서 적용할 이름이 보류됐다는 뜻이다. Codex `start`는 `/rename` 제출을 입력창이 빌 때까지 확인하고, 이름으로 찾은 thread UUID를 `threadId`로 돌려주며 tmux 세션 옵션 `@tfx_codex_thread`에 남긴다. 로컬 Codex `--resume-last`는 Codex가 고른 thread를 사후에 찾는다. 띄운 뒤 공유 app-server daemon에 로드된 같은 cwd의 thread 중 rollout에 그 시각 이후의 resume 기록(`thread_settings_applied`)이 생긴 것이 정확히 하나이고 1.5초 뒤에도 같을 때만 `threadId`로 쓴다. 이 확인은 5초 안에 끝난다. TUI가 daemon을 쓰지 않거나 같은 cwd에서 동시에 resume이 일어나면 `null`이다. 기존 Codex UDS thread는 `tfx-live rename --cli codex --transport uds --thread ID --name "<이름>"`으로 이름을 바꾼다.
 
 ## agy 세션