@triflux/remote 10.25.1 → 10.26.0

package/hub/team/native.mjs

@@ -2,11 +2,12 @@
 // teammate 프롬프트 템플릿 + 팀 설정 빌더
 //
 // Claude Code 네이티브 Agent Teams (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)
-// 환경에서 teammate를 Codex/Gemini CLI 래퍼로 구성하는 유틸리티.
+// 환경에서 teammate를 Codex/Antigravity CLI 래퍼로 구성하는 유틸리티.
 // SKILL.md가 인라인 프롬프트를 사용하므로, 이 모듈은 CLI(tfx multi --native)에서
 // 팀 설정을 프로그래밍적으로 생성할 때 사용한다.
 
 import * as fs from "node:fs/promises";
+import { createRequire } from "node:module";
 import os from "node:os";
 import path from "node:path";
 
@@ -25,6 +26,9 @@ const ROUTE_COMMAND_RE =
   /(?:^|[\s"'`])(?:bash\s+)?(?:[^"'`\s]*\/)?tfx-route\.sh\b/i;
 const ROUTE_PROMPT_RE = /tfx-route\.sh/i;
 const DIRECT_TOOL_BYPASS_RE = /\b(?:Read|Edit|Write)\s*\(/;
+const _require = createRequire(import.meta.url);
+const AGENT_TO_CLI = _require("./agent-map.json");
+const VALID_ROUTE_AGENTS = new Set(Object.keys(AGENT_TO_CLI));
 
 function inferWorkerIndex(agentName = "") {
   const match = /(\d+)(?!.*\d)/.exec(agentName);
@@ -33,13 +37,44 @@ function inferWorkerIndex(agentName = "") {
   return Number.isInteger(index) && index > 0 ? index : null;
 }
 
-function buildRouteEnvPrefix(agentName, workerIndex, searchTool) {
+function normalizeRouteMode(cli) {
+  const normalized = String(cli || "").trim();
+  if (["gemini", "antigravity", "agy"].includes(normalized)) {
+    return "antigravity";
+  }
+  if (normalized === "codex") return "codex";
+  return "";
+}
+
+function resolveRouteCli(cli) {
+  const normalized = String(cli || "").trim();
+  const mapped = AGENT_TO_CLI[normalized] || normalized;
+  return mapped === "gemini" ? "antigravity" : mapped;
+}
+
+function resolveSlimWrapperRouteAgent(cli, role) {
+  const routeRole = String(role || "").trim();
+  if (
+    routeRole &&
+    VALID_ROUTE_AGENTS.has(routeRole) &&
+    !["gemini", "antigravity", "agy"].includes(routeRole)
+  ) {
+    return routeRole;
+  }
+
+  const resolvedCli = resolveRouteCli(cli);
+  return VALID_ROUTE_AGENTS.has(resolvedCli) ? resolvedCli : "codex";
+}
+
+function buildRouteEnvPrefix(agentName, workerIndex, searchTool, cli) {
   const effectiveWorkerIndex =
     Number.isInteger(workerIndex) && workerIndex > 0
       ? workerIndex
       : inferWorkerIndex(agentName);
+  const routeMode = normalizeRouteMode(cli);
 
   let envPrefix = "";
+  if (routeMode) envPrefix += ` TFX_CLI_MODE="${routeMode}"`;
   if (effectiveWorkerIndex)
     envPrefix += ` TFX_WORKER_INDEX="${effectiveWorkerIndex}"`;
   if (searchTool) envPrefix += ` TFX_SEARCH_TOOL="${searchTool}"`;
@@ -188,7 +223,8 @@ export function buildSlimWrapperPrompt(cli, opts = {}) {
     maxIterations = 3,
   } = opts;
 
-  const routeTimeoutSec = getRouteTimeout(role, mcp_profile);
+  const routeAgent = resolveSlimWrapperRouteAgent(cli, role);
+  const routeTimeoutSec = getRouteTimeout(routeAgent, mcp_profile);
   const escaped = subtask.replace(/'/g, "'\\''");
   const pipelineHint = pipelinePhase
     ? `\n파이프라인 단계: ${pipelinePhase}`
@@ -197,6 +233,7 @@ export function buildSlimWrapperPrompt(cli, opts = {}) {
     agentName,
     workerIndex,
     searchTool,
+    cli,
   );
   const scoutConstraint =
     role === "scout" || role === "scientist"
@@ -218,14 +255,14 @@ SendMessage(type: "message", recipient: "${leadName}", content: "작업 시작:
 
 [HARD CONSTRAINT] 허용 도구: Bash, TaskUpdate, TaskGet, TaskList, SendMessage만 사용한다.
 Read, Edit, Write, Grep, Glob, Agent, WebSearch, WebFetch 등 다른 모든 도구 사용을 금지한다.
-코드를 직접 읽거나 수정하면 안 된다. 반드시 아래 Bash 명령(tfx-route.sh)을 통해 Codex/Gemini에 위임하라.
+코드를 직접 읽거나 수정하면 안 된다. 반드시 아래 Bash 명령(tfx-route.sh)을 통해 Codex/Antigravity에 위임하라.
 이 규칙을 위반하면 작업 실패로 간주한다.${scoutConstraint}
 
 gemini/codex를 직접 호출하지 마라. 반드시 tfx-route.sh를 거쳐야 한다.
 프롬프트를 파일로 저장하지 마라. tfx-route.sh가 인자로 받는다.
 
 Step 1 — Async 시작 (즉시 리턴, <1초):
-Bash(command: 'TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM_AGENT_NAME="${agentName}" TFX_TEAM_LEAD_NAME="${leadName}"${routeEnvPrefix} bash ${ROUTE_SCRIPT} --async "${role}" '"'"'${escaped}'"'"' ${mcp_profile} ${routeTimeoutSec}', timeout: ${launchTimeoutMs})
+Bash(command: 'TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM_AGENT_NAME="${agentName}" TFX_TEAM_LEAD_NAME="${leadName}"${routeEnvPrefix} bash ${ROUTE_SCRIPT} --async "${routeAgent}" '"'"'${escaped}'"'"' ${mcp_profile} ${routeTimeoutSec}', timeout: ${launchTimeoutMs})
 → 출력 한 줄이 JOB_ID이다. 반드시 기억하라.
 
 Step 2 — 완료 대기 (내부 폴링, 최대 540초):
@@ -333,9 +370,11 @@ export function buildHybridWrapperPrompt(cli, opts = {}) {
     agentName,
     workerIndex,
     searchTool,
+    cli,
   );
+  const routeAgent = resolveSlimWrapperRouteAgent(cli, role);
 
-  const routeCmd = `TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM_AGENT_NAME="${agentName}" TFX_TEAM_LEAD_NAME="${leadName}"${routeEnvPrefix} bash ${ROUTE_SCRIPT} "${role}" '${escaped}' ${mcp_profile}`;
+  const routeCmd = `TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM_AGENT_NAME="${agentName}" TFX_TEAM_LEAD_NAME="${leadName}"${routeEnvPrefix} bash ${ROUTE_SCRIPT} "${routeAgent}" '${escaped}' ${mcp_profile}`;
 
   return `하이브리드 psmux 워커 프로토콜:
 
@@ -360,7 +399,7 @@ export function buildHybridWrapperPrompt(cli, opts = {}) {
 ${pipelineHint}
 [HARD CONSTRAINT] 너는 Bash, TaskUpdate, TaskGet, TaskList, SendMessage만 사용할 수 있다.
 Read, Edit, Write, Grep, Glob, Agent, WebSearch, WebFetch 등 다른 모든 도구 사용을 금지한다.
-코드를 직접 읽거나 수정하면 안 된다. 반드시 아래 Bash 명령(tfx-route.sh)을 통해 Codex/Gemini에 위임하라.
+코드를 직접 읽거나 수정하면 안 된다. 반드시 아래 Bash 명령(tfx-route.sh)을 통해 Codex/Antigravity에 위임하라.
 이 규칙을 위반하면 작업 실패로 간주한다.
 
 gemini/codex를 직접 호출하지 마라. psmux spawn이 tfx-route.sh를 통해 실행한다.

package/hub/team/pane.mjs

@@ -31,11 +31,6 @@ function toMuxPath(p) {
   const drive = m[1].toLowerCase();
   const rest = m[2];
 
-  // wsl tmux는 /mnt/c/... 경로를 사용
-  if (mux === "wsl-tmux") {
-    return `/mnt/${drive}/${rest}`;
-  }
-
   // Git Bash/MSYS tmux는 /c/... 경로를 사용
   return `/${drive}/${rest}`;
 }

package/hub/team/psmux.mjs

@@ -234,7 +234,7 @@ function ensurePsmuxInstalled() {
   if (!hasPsmux()) {
     throw new Error(
       "psmux가 설치되어 있지 않습니다.\n\n" +
-        "psmux는 Codex/Gemini CLI를 병렬 세션으로 실행하는 터미널 멀티플렉서입니다.\n" +
+        "psmux는 Codex/Antigravity CLI를 병렬 세션으로 실행하는 터미널 멀티플렉서입니다.\n" +
         "설치 방법 (택 1):\n" +
         `${formatPsmuxInstallGuidance("  ")}\n\n` +
         "설치 후 터미널을 재시작하세요.",
@@ -1412,10 +1412,10 @@ export function startCapture(sessionName, paneNameOrTarget) {
  * @returns {{ paneId: string, paneName: string, token: string, logPath: string }}
  */
 /**
- * CLI 명령(codex/gemini)이 psmux pane의 PowerShell 환경에서 단축 플래그 충돌을
+ * CLI 명령(codex/legacy Gemini)이 psmux pane의 PowerShell 환경에서 단축 플래그 충돌을
  * 일으키는 문제를 방지하기 위해 bash -c '...' 로 감싼다.
  * - codex -o flag → PS -OutVariable/OutBuffer 충돌
- * - gemini --prompt flag (v8.6.0: -p → --prompt, PS 충돌 해소)
+ * - legacy Gemini prompt flag (v8.6.0: -p → long-form prompt flag, PS 충돌 해소)
  * @param {string} cmd
  * @returns {string}
  */

package/hub/team/retry-state-machine.mjs

@@ -21,7 +21,7 @@ import {
   readFileSync,
   writeFileSync,
 } from "node:fs";
-import { dirname } from "node:path";
+import { dirname, join } from "node:path";
 
 export const STATES = Object.freeze({
   PLANNING: "PLANNING",
@@ -38,16 +38,12 @@ export const MODES = Object.freeze({
   ESCALATE: "auto-escalate",
 });
 
-// Escalation chain (2026-04-25 정책):
-//   1. gpt-5.4-mini   — 비용 최저, fast tier, 단순 task 대부분 해결
-//   2. gpt-5.3-codex  — 가성비 중간, code specialized (Plus/free 모두 OK, fast 미지원)
-//   3. gpt-5.5         — top reasoning + 코드 강함, fast tier
-//   4. claude opus-4-7 — 최종 수단
-// sonnet-4-6 단계는 제거: gpt-5.5 가 코드/추론/비용 모두 우위 + 5.3-codex 가성비
-// 단계가 더 적합한 중간 격상.
+const ESCALATION_CHAIN_CONFIG_PATH = ".triflux/config/escalation-chain.json";
+
+// Escalation chain (2026-05-27 정책):
+//   1. codex gpt-5.5   — 코드/추론/비용에서 mini/5.3-codex 중간 단계를 대체
+//   2. claude opus-4-7 — 최종 수단
 const DEFAULT_ESCALATION_CHAIN = Object.freeze([
-  Object.freeze({ cli: "codex", model: "gpt-5.4-mini" }),
-  Object.freeze({ cli: "codex", model: "gpt-5.3-codex" }),
   Object.freeze({ cli: "codex", model: "gpt-5.5" }),
   Object.freeze({ cli: "claude", model: "opus-4-7" }),
 ]);
@@ -56,9 +52,7 @@ const STUCK_THRESHOLD = 3;
 
 export function createRetryStateMachine(options = {}) {
   const mode = options.mode || MODES.BOUNDED;
-  const cliChain = Array.isArray(options.cliChain)
-    ? options.cliChain.slice()
-    : DEFAULT_ESCALATION_CHAIN.slice();
+  const cliChain = resolveEscalationChain(options);
   const maxIterationsInput =
     typeof options.maxIterations === "number" ? options.maxIterations : null;
   const maxIterations =
@@ -205,7 +199,10 @@ export function createRetryStateMachine(options = {}) {
     state.lastFailureReason = snapshot.lastFailureReason || null;
     state.cliIndex = Number(snapshot.cliIndex) || 0;
     if (Array.isArray(snapshot.cliChain) && snapshot.cliChain.length > 0) {
-      state.cliChain = snapshot.cliChain.slice();
+      state.cliChain = normalizeEscalationChain(
+        snapshot.cliChain,
+        "snapshot.cliChain",
+      );
     }
     if (snapshot.mode) state.mode = snapshot.mode;
     if (snapshot.sessionId !== undefined) state.sessionId = snapshot.sessionId;
@@ -227,6 +224,78 @@ export function createRetryStateMachine(options = {}) {
   };
 }
 
+function resolveEscalationChain(options) {
+  if (Array.isArray(options.cliChain)) {
+    return normalizeEscalationChain(options.cliChain, "options.cliChain");
+  }
+
+  const projectRoot = options.projectRoot || process.cwd();
+  return (
+    loadEscalationChainOverride(projectRoot) ||
+    normalizeEscalationChain(
+      DEFAULT_ESCALATION_CHAIN,
+      "DEFAULT_ESCALATION_CHAIN",
+    )
+  );
+}
+
+export function loadEscalationChainOverride(projectRoot = process.cwd()) {
+  const configPath = join(projectRoot, ESCALATION_CHAIN_CONFIG_PATH);
+  if (!existsSync(configPath)) return null;
+
+  const raw = readFileSync(configPath, "utf8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    throw new Error(
+      `escalation-chain override 파싱 실패: ${configPath} — 원인: ${err.message} — 수정: JSON 문법 확인 또는 파일 삭제로 DEFAULT_ESCALATION_CHAIN 사용`,
+      { cause: err },
+    );
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${configPath}: expected object`);
+  }
+  if (parsed.version !== undefined && parsed.version !== 1) {
+    throw new Error(`${configPath}: unsupported version ${parsed.version}`);
+  }
+  return normalizeEscalationChain(parsed.chain, configPath);
+}
+
+function normalizeEscalationChain(chain, source) {
+  if (!Array.isArray(chain) || chain.length === 0) {
+    throw new Error(`${source}: chain must be a non-empty array`);
+  }
+  return chain.map((entry, index) =>
+    normalizeEscalationChainEntry(entry, index, source),
+  );
+}
+
+function normalizeEscalationChainEntry(entry, index, source) {
+  if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+    throw new Error(`${source}: chain[${index}] must be an object`);
+  }
+  if (typeof entry.cli !== "string" || entry.cli.trim() === "") {
+    throw new Error(
+      `${source}: chain[${index}].cli must be a non-empty string`,
+    );
+  }
+  if (typeof entry.model !== "string" || entry.model.trim() === "") {
+    throw new Error(
+      `${source}: chain[${index}].model must be a non-empty string`,
+    );
+  }
+
+  const normalized = {
+    cli: entry.cli,
+    model: entry.model,
+  };
+  if (typeof entry.profile === "string" && entry.profile.trim() !== "") {
+    normalized.profile = entry.profile;
+  }
+  return normalized;
+}
+
 function persistTransition(stateFile, entry) {
   const dir = dirname(stateFile);
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });

package/hub/team/session.mjs

@@ -38,20 +38,6 @@ function hasTmux() {
   }
 }
 
-/** WSL2 내 tmux 사용 가능 여부 (Windows 전용) */
-function hasWslTmux() {
-  try {
-    execSync("wsl tmux -V", {
-      stdio: "ignore",
-      timeout: 5000,
-      windowsHide: true,
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 /** Git Bash 내 tmux 사용 가능 여부 (Windows 전용) */
 function hasGitBashTmux() {
   const bash = resolveGitBashExecutable();
@@ -103,7 +89,7 @@ function hasLiteralPsmuxBinary(command = process.env.PSMUX_BIN || "psmux") {
 
 /**
  * 터미널 멀티플렉서 감지 (결과 캐싱 — 프로세스 수명 동안 불변)
- * @returns {'tmux'|'git-bash-tmux'|'wsl-tmux'|'psmux'|null}
+ * @returns {'tmux'|'git-bash-tmux'|'psmux'|null}
  */
 let _cachedMux;
 export function detectMultiplexer() {
@@ -139,16 +125,12 @@ export function detectMultiplexer() {
     _cachedMux = "git-bash-tmux";
     return _cachedMux;
   }
-  if (hasWslTmux()) {
-    _cachedMux = "wsl-tmux";
-    return _cachedMux;
-  }
   _cachedMux = null;
   return _cachedMux;
 }
 
 /**
- * tmux/psmux 커맨드 실행 (wsl-tmux 투명 지원)
+ * tmux/psmux 커맨드 실행
  * @param {string} args — tmux 서브커맨드 + 인자
  * @param {object} opts — execSync 옵션
  * @returns {string} stdout
@@ -159,14 +141,9 @@ function tmux(args, opts = {}) {
     throw new Error(
       "tmux/psmux 미발견.\n\n" +
         "tfx multi은 tmux 계열 멀티플렉서가 필요합니다:\n" +
-        "  Windows: psmux 설치 또는 WSL2 tmux 사용\n" +
-        "  WSL2:   wsl sudo apt install tmux\n" +
+        "  Windows: psmux 설치\n" +
         "  macOS:  brew install tmux\n" +
-        "  Linux:  apt install tmux\n\n" +
-        "Windows에서는 WSL2를 권장합니다:\n" +
-        "  1. wsl --install\n" +
-        "  2. wsl sudo apt install tmux\n" +
-        '  3. tfx multi "작업"  (자동으로 WSL tmux 사용)',
+        "  Linux:  apt install tmux",
     );
   }
   if (mux === "psmux") {
@@ -190,8 +167,7 @@ function tmux(args, opts = {}) {
     return (r.stdout || "").trim();
   }
 
-  const prefix = mux === "wsl-tmux" ? "wsl tmux" : "tmux";
-  const result = execSync(`${prefix} ${args}`, {
+  const result = execSync(`tmux ${args}`, {
     encoding: "utf8",
     timeout: 10000,
     stdio: ["pipe", "pipe", "pipe"],
@@ -238,13 +214,6 @@ export function resolveAttachCommand(sessionName, opts = {}) {
     };
   }
 
-  if (mux === "wsl-tmux") {
-    return {
-      command: "wsl",
-      args: ["tmux", "attach-session", "-t", sessionName],
-    };
-  }
-
   return {
     command: "tmux",
     args: ["attach-session", "-t", sessionName],

package/hub/team/swarm-hypervisor.mjs

@@ -156,6 +156,19 @@ function resolveHubStatusUrl(hub) {
   return `http://${formatHubHostForUrl(host)}:${port}/status`;
 }
 
+function isTruthyConfigValue(value) {
+  if (typeof value === "boolean") return value;
+  return /^(true|yes|1|interactive)$/i.test(String(value || "").trim());
+}
+
+function isInteractiveNativeBridgeShard(shard) {
+  return (
+    isTruthyConfigValue(shard?.interactive) ||
+    isTruthyConfigValue(shard?.nativeBridgeInteractive) ||
+    String(shard?.workerType || "").toLowerCase() === "interactive"
+  );
+}
+
 /**
  * Create a swarm hypervisor.
  * @param {object} opts
@@ -591,6 +604,7 @@ export function createSwarmHypervisor(opts) {
   async function maybeRegisterNativeBridgeShard(shard, sessionConfig) {
     if (!nativeBridge) return null;
     try {
+      const interactive = !shard.host && isInteractiveNativeBridgeShard(shard);
       const registration = await registerSwarmShardImpl({
         sessionId: sessionConfig.id,
         cli: shard.agent,
@@ -598,8 +612,11 @@ export function createSwarmHypervisor(opts) {
         swarmName: runId,
         ...getShardDisplayPosition(shard),
         shardName: shard.name,
-        cwd: workdir,
+        cwd: interactive
+          ? shard.worktreePath || sessionConfig.workdir || workdir
+          : workdir,
         host: shard.host || "local",
+        interactive,
         _deps: {
           warn(message) {
             emitter.emit("warning", {
@@ -646,7 +663,7 @@ export function createSwarmHypervisor(opts) {
       agent: shard.agent,
       // #125: append Completion Protocol appendix so workers emit a
       // sentinel-framed JSON payload that conductor can reliably capture.
-      prompt: buildWorkerPrompt(shard.prompt),
+      prompt: buildWorkerPrompt(shard.prompt, { leaseFiles: shard.files }),
       workdir: shard.worktreePath || workdir,
       mcpServers: shard.mcp,
       worktreePath: shard.worktreePath || null,
@@ -917,10 +934,15 @@ export function createSwarmHypervisor(opts) {
         const worker = workers.get(shardName);
         const shard = plan?.shards.find((item) => item.name === shardName);
         if (worker && shard) {
-          const cleanupPromise = maybeCleanupWorktree(shardName, worker, shard, {
-            force: true,
-            failureReason: FAILURE_MODES.F7_WORKER_DID_NOT_COMMIT,
-          });
+          const cleanupPromise = maybeCleanupWorktree(
+            shardName,
+            worker,
+            shard,
+            {
+              force: true,
+              failureReason: FAILURE_MODES.F7_WORKER_DID_NOT_COMMIT,
+            },
+          );
           worker.cleanupPromise = cleanupPromise;
           void cleanupPromise
             .finally(() => {

package/hub/team/swarm-preflight.mjs

@@ -10,7 +10,9 @@ import { planSwarm } from "./swarm-planner.mjs";
 
 const AGENT_COMMANDS = Object.freeze({
   codex: "codex",
-  gemini: "gemini",
+  gemini: "agy",
+  antigravity: "agy",
+  agy: "agy",
   claude: "claude",
 });
 

package/hub/team/terminal-opener.mjs

@@ -4,7 +4,7 @@ import { psmuxExec as defaultPsmuxExec } from "./psmux.mjs";
 import { tmuxExec as defaultTmuxExec, detectMultiplexer } from "./session.mjs";
 import { createWtManager as defaultCreateWtManager } from "./wt-manager.mjs";
 
-const TMUX_LIKE_MUXES = new Set(["tmux", "wsl-tmux", "git-bash-tmux"]);
+const TMUX_LIKE_MUXES = new Set(["tmux", "git-bash-tmux"]);
 
 export function sanitizeTerminalTitle(value, fallback = "triflux") {
   const title = String(value ?? "")

package/hub/team/tui-core.mjs

@@ -137,6 +137,10 @@ export function normalizeWorkerState(existing = {}, state = {}, opts = {}) {
         : existing.cli || "codex",
     role:
       state.role !== undefined ? sanitizeOneLine(state.role) : existing.role,
+    displayName:
+      state.displayName !== undefined
+        ? sanitizeOneLine(state.displayName, existing.displayName)
+        : existing.displayName,
     status:
       state.status !== undefined
         ? sanitizeOneLine(state.status, existing.status || "pending")

package/hub/team/tui-lite.mjs

@@ -82,6 +82,7 @@ function buildWorkerRail(names, workers, selectedWorker, width) {
   const lines = names.length
     ? names.map((name, index) => {
         const worker = workers.get(name);
+        const displayName = worker?.displayName || name;
         const status = runtimeStatus(worker);
         const pct = Math.round(
           ((worker?.progress ?? (status === "completed" ? 1 : 0)) || 0) * 100,
@@ -91,7 +92,7 @@ function buildWorkerRail(names, workers, selectedWorker, width) {
           : "";
         const prefix =
           name === selectedWorker ? color("▶", MOCHA.blue) : dim("·");
-        return `${prefix} ${index + 1}.${name} ${stripAnsi(statusBadge(status))} ${pct}%${token}`;
+        return `${prefix} ${index + 1}.${displayName} ${stripAnsi(statusBadge(status))} ${pct}%${token}`;
       })
     : [dim("workers 없음")];
   return frame(lines, width);
@@ -115,7 +116,7 @@ function buildDetail(workerName, worker, width, tab, helpVisible) {
   }
   if (!workerName || !worker) return frame([dim("선택된 워커 없음")], width);
   const detailLines = [
-    bold(workerName),
+    bold(worker.displayName || workerName),
     `status ${runtimeStatus(worker)}`,
     `progress ${Math.round((worker.progress || 0) * 100)}% ${progressBar(Math.round((worker.progress || 0) * 100), 12)}`,
     `tokens ${formatTokens(worker.tokens)}`,

package/hub/team/tui-viewer.mjs

@@ -447,10 +447,10 @@ function ingest() {
 function pushToTui(paneName, cli, paneTitle, update) {
   // _leadAction은 tui에 노출하지 않음 (내부용)
   const { _leadAction: _ignored, ...safeUpdate } = update;
-  // pane title에서 실제 역할만 추출: "⚪ codex (executor)" → "executor"
-  const roleMatch = paneTitle.match(/\(([^)]+)\)$/);
-  const role = roleMatch ? roleMatch[1] : "";
-  tui.updateWorker(paneName, { cli, role, ...safeUpdate });
+  // pane title의 괄호 값은 UI 라벨이며 role 의미값으로 승격하지 않는다.
+  const labelMatch = paneTitle.match(/\(([^)]+)\)$/);
+  const displayName = labelMatch ? labelMatch[1] : paneName;
+  tui.updateWorker(paneName, { cli, displayName, role: "", ...safeUpdate });
 }
 
 // ── render 루프 (8-12FPS ≈ 100ms) ──

package/hub/team/tui.mjs

@@ -573,6 +573,7 @@ function buildWorkerRail(name, st, opts = {}) {
   const innerWidth = Math.max(12, width - 4);
   const cli = st.cli || "codex";
   const role = sanitizeOneLine(st.role);
+  const displayName = sanitizeOneLine(st.displayName, name);
   const status = runtimeStatus(st);
   const sec = Number.isFinite(st._logSec) ? st._logSec : 0;
   const changeElapsed = st._statusChangedAt
@@ -598,9 +599,9 @@ function buildWorkerRail(name, st, opts = {}) {
     st.host && st.host !== "local"
       ? color(`[${st.host}]`, MOCHA.mauve) + " "
       : "";
-  const displayRole = dedupeRole(role, name, cli);
+  const displayRole = dedupeRole(role, displayName, cli);
   const title = truncate(
-    `${selMark} ${hb} ${hostBadge}${color(name, FG.triflux)} ${color("•", MOCHA.overlay)} ${color(cli, cliColor(cli))}${displayRole ? ` ${color(`(${displayRole})`, MOCHA.overlay)}` : ""}`,
+    `${selMark} ${hb} ${hostBadge}${color(displayName, FG.triflux)} ${color("•", MOCHA.overlay)} ${color(cli, cliColor(cli))}${displayRole ? ` ${color(`(${displayRole})`, MOCHA.overlay)}` : ""}`,
     innerWidth,
   );
 
@@ -1658,6 +1659,7 @@ export function createLogDashboard(opts = {}) {
         cli: merged.cli,
         status: merged.status,
         role: merged.role,
+        displayName: merged.displayName,
         snapshot: merged.snapshot,
         summary: merged.summary,
         detail: merged.detail,

package/hub/team/worker-sandbox.mjs

@@ -71,6 +71,10 @@ export function buildWorkerSandboxEnv(opts = {}) {
     XDG_CACHE_HOME: xdgCache,
     XDG_STATE_HOME: xdgState,
   };
+  const hostHome = env.HOME || env.USERPROFILE;
+  if (!env.CODEX_HOME && hostHome) {
+    overlay.CODEX_HOME = join(hostHome, ".codex");
+  }
 
   const winParts =
     windowsHomeParts(home) ||

package/hub/tools.mjs

@@ -135,7 +135,10 @@ export function createTools(store, router, hitl, pipe = null) {
         ],
         properties: {
           agent_id: { type: "string", pattern: "^[a-zA-Z0-9._:-]{3,64}$" },
-          cli: { type: "string", enum: ["codex", "gemini", "claude", "other"] },
+          cli: {
+            type: "string",
+            enum: ["codex", "antigravity", "gemini", "claude", "other"],
+          },
           pid: { type: "integer", minimum: 1 },
           capabilities: {
             type: "array",