sneakoscope 0.6.60 → 0.6.62

package/README.md

@@ -2,7 +2,7 @@
 
 ![](https://github.com/mandarange/Sneakoscope-Codex/raw/dev/docs/assets/sneakoscope-codex-logo.png)
 
-Codex CLI/App harness for `$` routes, Team/Ralph/QA/Research, Context7, Honest Mode, DB safety, TriWiki, Codex App skills, and release readiness.
+Codex CLI/App harness for `$` routes, cmux-native CLI workspaces, Team/Ralph/QA/Research, Context7, Honest Mode, DB safety, TriWiki, Codex App skills, and release readiness.
 
 Install: `npm i -g sneakoscope && sks bootstrap`
 Fallback: `npx -y -p sneakoscope sks bootstrap`
@@ -19,6 +19,7 @@ Sneakoscope (`sks`, displayed as `ㅅㅋㅅ`) wraps Codex with a repeatable cont
 | --- | --- |
 | Codex App commands | Installs generated skills so `$Team`, `$DFix`, `$QA-LOOP`, `$Ralph`, `$DB`, `$Wiki`, `$Help`, and related routes are discoverable in prompt workflows. |
 | CLI commands | Provides `sks commands`, `sks dollar-commands`, `sks usage <topic>`, bootstrap, setup, doctor, deps, selftest, wiki, team, QA, Ralph, DB, and GX commands. |
+| cmux runtime | Opens Codex CLI through `sks`/`sks cmux`, exposes one-shot full-access high mode with `sks --mad --high`, and opens Team missions with cmux multi-line agent lanes when cmux is available. |
 | Team orchestration | Routes substantial code work through ambiguity removal, scouts, TriWiki refresh, debate, consensus, concrete runtime task graph/inboxes, implementation, review, integration, reflection, and Honest Mode. |
 | Ralph | Seals a decision contract up front, then continues without more user questions by using the agreed decision ladder. |
 | QA loop | Dogfoods UI/API behavior with safety boundaries, evidence capture, safe remediation, and focused rechecks. |
@@ -60,6 +61,8 @@ sks usage install
 sks usage team
 sks usage qa-loop
 sks usage codex-app
+sks cmux check
+sks --mad --high
 sks setup --install-scope project
 sks wiki refresh
 sks wiki validate .sneakoscope/wiki/context-pack.json
@@ -111,6 +114,7 @@ This runs repo audit, changelog check, syntax packcheck, mock selftest, sizechec
 - Node.js `>=20.11`
 - npm
 - Codex CLI/App for app-facing workflows
+- cmux for the CLI-first runtime (`sks deps install cmux`)
 - Context7 MCP for current-docs-gated routes
 
 ## License

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "ㅅㅋㅅ",
-  "version": "0.6.60",
+  "version": "0.6.62",
   "description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team, Ralph, AutoResearch, TriWiki, and Honest Mode.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
@@ -57,7 +57,7 @@
     "harness",
     "codex-cli",
     "codex-app",
-    "tmux",
+    "cmux",
     "auto-review",
     "browser-use",
     "computer-use",

package/src/cli/main.mjs

@@ -30,8 +30,8 @@ import { context7Evidence, evaluateStop, recordContext7Evidence, recordSubagentE
 import { TEAM_DECOMPOSITION_ARTIFACT, TEAM_GRAPH_ARTIFACT, TEAM_INBOX_DIR, TEAM_RUNTIME_TASKS_ARTIFACT, teamRuntimePlanMetadata, teamRuntimeRequiredArtifacts, validateTeamRuntimeArtifacts, writeTeamRuntimeArtifacts } from '../core/team-dag.mjs';
 import { appendTeamEvent, formatRoleCounts, initTeamLive, normalizeTeamSpec, parseTeamSpecArgs, parseTeamSpecText, readTeamDashboard, readTeamLive, readTeamTranscriptTail } from '../core/team-live.mjs';
 import { CODEX_APP_DOCS_URL, codexAppIntegrationStatus, formatCodexAppStatus } from '../core/codex-app.mjs';
-import { buildTmuxLaunchPlan, defaultTmuxSessionName, formatTmuxBanner, launchTmuxUi, platformTmuxInstallHint, runTmuxStatus, sanitizeTmuxSessionName, tmuxAvailable } from '../core/tmux-ui.mjs';
-import { autoReviewProfileName, autoReviewStatus, autoReviewSummary, enableAutoReview, disableAutoReview } from '../core/auto-review.mjs';
+import { buildCmuxLaunchPlan, defaultCmuxWorkspaceName, formatCmuxBanner, launchCmuxTeamView, launchCmuxUi, platformCmuxInstallHint, runCmuxStatus, sanitizeCmuxWorkspaceName, cmuxAvailable } from '../core/cmux-ui.mjs';
+import { autoReviewProfileName, autoReviewStatus, autoReviewSummary, enableAutoReview, disableAutoReview, enableMadHighProfile, madHighProfileName } from '../core/auto-review.mjs';
 
 const flag = (args, name) => args.includes(name);
 const promptOf = (args) => args.filter((x) => !String(x).startsWith('--')).join(' ').trim();
@@ -48,15 +48,16 @@ function installScopeFromArgs(args = [], fallback = 'global') {
 }
 
 export async function main(args) {
+  if (isMadHighLaunch(args)) return madHighCommand(args);
   if (isAutoReviewFlag(args[0])) return autoReviewCommand('start', args.slice(1));
   const [cmd, sub, ...rest] = args;
   const tail = sub === undefined ? [] : [sub, ...rest];
-  if (!cmd) return shouldLaunchTmuxUi() ? tmuxCommand('start', []) : help();
+  if (!cmd) return shouldLaunchCmuxUi() ? cmuxCommand('start', []) : help();
   if (cmd === '--help' || cmd === '-h') return help();
   if (cmd === '--version' || cmd === '-v' || cmd === 'version') return version();
   if (cmd === 'postinstall') return postinstall();
   if (cmd === 'wizard' || cmd === 'ui') return wizard(tail);
-  if (cmd === 'tmux') return String(sub || '').startsWith('--') ? tmuxCommand('start', tail) : tmuxCommand(sub, rest);
+  if (cmd === 'cmux') return String(sub || '').startsWith('--') ? cmuxCommand('start', tail) : cmuxCommand(sub, rest);
   if (cmd === 'auto-review' || cmd === 'autoreview') return autoReviewCommand(sub, rest);
   if (cmd === 'update-check') return updateCheck(tail);
   if (cmd === 'help') return help(tail);
@@ -113,12 +114,13 @@ Usage:
   sks usage [${USAGE_TOPICS}]
   sks quickstart
   sks bootstrap [--install-scope global|project] [--local-only] [--json]
-  sks deps check|install [tmux|codex|context7|all] [--yes] [--json]
+  sks deps check|install [cmux|codex|context7|all] [--yes] [--json]
   sks codex-app
+  sks --mad --high
   sks auto-review status|enable|start [--high]
   sks --Auto-review [--high]
-  sks tmux [--session name] [--no-attach]
-  sks tmux status [--once]
+  sks cmux [--workspace name]
+  sks cmux status [--once]
   sks dollar-commands [--json]
   sks dfix
   sks qa-loop prepare "target"
@@ -190,14 +192,18 @@ function shouldShowWizard() {
   return Boolean(input.isTTY && output.isTTY && process.env.SKS_NO_WIZARD !== '1' && process.env.CI !== 'true');
 }
 
-function shouldLaunchTmuxUi() {
-  return Boolean(input.isTTY && output.isTTY && process.env.SKS_NO_TMUX !== '1' && process.env.CI !== 'true');
+function shouldLaunchCmuxUi() {
+  return Boolean(input.isTTY && output.isTTY && process.env.SKS_NO_CMUX !== '1' && process.env.CI !== 'true');
 }
 
 function isAutoReviewFlag(value) {
   return /^--?auto[-_]?review$/i.test(String(value || ''));
 }
 
+function isMadHighLaunch(args = []) {
+  return /^--(?:mad|MAD|mad-sks)$/i.test(String(args[0] || ''));
+}
+
 async function postinstall() {
   const installRoot = path.resolve(process.env.INIT_CWD || process.cwd());
   const conflictScan = await scanHarnessConflicts(installRoot);
@@ -235,8 +241,8 @@ async function postinstall() {
   }
   console.log('\nNext:');
   console.log('  sks bootstrap');
-  console.log('\nThis initializes the current project, installs SKS Codex App skills, verifies Codex App/Context7 readiness, and checks tmux/runtime dependencies.');
-  console.log('Dependency repair: sks deps check; sks deps install tmux');
+  console.log('\nThis initializes the current project, installs SKS Codex App skills, verifies Codex App/Context7 readiness, and checks cmux/runtime dependencies.');
+  console.log('Dependency repair: sks deps check; sks deps install cmux');
   console.log('Open runtime after readiness is green: sks\n');
 }
 
@@ -366,14 +372,14 @@ async function ensureGlobalCodexSkillsDuringInstall(opts = {}) {
 async function ensureRelatedCliTools(args = []) {
   const skip = flag(args, '--skip-cli-tools') || process.env.SKS_SKIP_CLI_TOOLS === '1';
   const codex = await ensureCodexCliTool({ skip });
-  const tmux = await tmuxAvailable().catch((err) => ({ ok: false, version: null, error: err.message }));
+  const cmux = await cmuxAvailable().catch((err) => ({ ok: false, version: null, error: err.message }));
   return {
     codex,
-    tmux: {
-      ok: Boolean(tmux.ok),
-      version: tmux.version || null,
-      install_hint: tmux.ok ? null : platformTmuxInstallHint(),
-      error: tmux.error || null
+    cmux: {
+      ok: Boolean(cmux.ok),
+      version: cmux.version || null,
+      install_hint: cmux.ok ? null : platformCmuxInstallHint(),
+      error: cmux.error || null
     }
   };
 }
@@ -1005,24 +1011,24 @@ function readNumberOption(args, name, fallback) {
   return Number.isFinite(value) && value > 0 ? value : fallback;
 }
 
-async function tmuxCommand(sub = 'start', args = []) {
+async function cmuxCommand(sub = 'start', args = []) {
   const action = sub || 'start';
   if (action === 'status' || action === 'banner') {
     if (flag(args, '--json')) {
       const status = await codexAppIntegrationStatus();
       return console.log(JSON.stringify(status, null, 2));
     }
-    await runTmuxStatus(action === 'banner' ? ['--once', ...args] : args);
+    await runCmuxStatus(action === 'banner' ? ['--once', ...args] : args);
     return;
   }
   if (action === 'check') {
     const root = await projectRoot();
-    const plan = await buildTmuxLaunchPlan({ root, session: readOption(args, '--session', null) });
+    const plan = await buildCmuxLaunchPlan({ root, session: readOption(args, '--session', null) });
     if (flag(args, '--json')) return console.log(JSON.stringify(plan, null, 2));
-    console.log(formatTmuxBanner(plan.app));
+    console.log(formatCmuxBanner(plan.app));
     console.log('');
-    console.log(`tmux:      ${plan.tmux.ok ? 'ok' : 'missing'} ${plan.tmux.version || ''}`.trim());
-    console.log(`Session:   ${plan.session}`);
+    console.log(`cmux:      ${plan.cmux.ok ? 'ok' : 'missing'} ${plan.cmux.version || ''}`.trim());
+    console.log(`Workspace: ${plan.workspace}`);
     console.log(`Project:   ${plan.root}`);
     console.log(`Ready:     ${plan.ready ? 'yes' : 'no'}`);
     if (!plan.ready) {
@@ -1032,11 +1038,21 @@ async function tmuxCommand(sub = 'start', args = []) {
     }
     return;
   }
-  if (['start', 'attach', 'connect', 'open'].includes(action)) return launchTmuxUi(args);
-  console.error('Usage: sks tmux [check|status|banner] [--session name] [--no-attach]');
+  if (['start', 'attach', 'connect', 'open'].includes(action)) return launchCmuxUi(args);
+  console.error('Usage: sks cmux [check|status|banner] [--workspace name]');
   process.exitCode = 1;
 }
 
+async function madHighCommand(args = []) {
+  const cleanArgs = args.filter((arg) => !['--mad', '--MAD', '--mad-sks', '--high'].includes(arg));
+  const profile = await enableMadHighProfile();
+  if (flag(args, '--json')) return console.log(JSON.stringify(profile, null, 2));
+  console.log(`SKS MAD high profile ready: ${madHighProfileName()}`);
+  console.log('Scope: explicit cmux launch only; normal SKS/DB safety returns after this command.');
+  const workspace = readOption(cleanArgs, '--workspace', readOption(cleanArgs, '--session', `sks-mad-${defaultCmuxWorkspaceName(process.cwd())}`));
+  return launchCmuxUi([...cleanArgs, '--workspace', workspace], { codexArgs: ['--profile', profile.profile_name] });
+}
+
 async function deps(sub = 'check', args = []) {
   const action = sub || 'check';
   if (action === 'check' || action === 'status') {
@@ -1048,7 +1064,7 @@ async function deps(sub = 'check', args = []) {
     return;
   }
   if (action === 'install') return depsInstall(args);
-  console.error('Usage: sks deps check|install [tmux|codex|context7|all] [--yes] [--json]');
+  console.error('Usage: sks deps check|install [cmux|codex|context7|all] [--yes] [--json]');
   process.exitCode = 1;
 }
 
@@ -1058,7 +1074,7 @@ async function depsStatus(root = null, opts = {}) {
   const codex = opts.codex || await getCodexInfo().catch(() => ({}));
   const app = opts.codexApp || await codexAppIntegrationStatus({ codex });
   const context7 = opts.context7 || await checkContext7(root);
-  const tmux = opts.tmux || await tmuxAvailable().catch((err) => ({ ok: false, version: null, error: err.message }));
+  const cmux = opts.cmux || await cmuxAvailable().catch((err) => ({ ok: false, version: null, error: err.message }));
   const brew = process.platform === 'darwin' ? await which('brew').catch(() => null) : null;
   const globalBin = await discoverGlobalSksCommand();
   const npmPrefix = npmBin ? await runProcess(npmBin, ['prefix', '-g'], { timeoutMs: 8000, maxOutputBytes: 4096 }).catch(() => null) : null;
@@ -1066,10 +1082,10 @@ async function depsStatus(root = null, opts = {}) {
   const npmPrefixDir = npmPrefix?.code === 0 ? npmPrefix.stdout.trim().split(/\r?\n/).pop() : null;
   const npmBinDir = npmPrefixDir ? (process.platform === 'win32' ? npmPrefixDir : path.join(npmPrefixDir, 'bin')) : null;
   const nodeOk = Number(process.versions.node.split('.')[0]) >= 20;
-  const homebrewNeeded = process.platform === 'darwin' && !tmux.ok;
+  const homebrewNeeded = process.platform === 'darwin' && !cmux.ok;
   return {
     root,
-    ready: Boolean(nodeOk && npmBin && globalBin && codex.bin && app.ok && context7.ok && tmux.ok),
+    ready: Boolean(nodeOk && npmBin && globalBin && codex.bin && context7.ok && cmux.ok),
     node: { ok: nodeOk, version: process.version },
     npm: { ok: Boolean(npmBin), bin: npmBin, global_bin_dir: npmBinDir, global_bin_on_path: npmBinDir ? pathText.split(path.delimiter).includes(npmBinDir) : null },
     sneakoscope: { ok: Boolean(globalBin), bin: globalBin },
@@ -1078,13 +1094,13 @@ async function depsStatus(root = null, opts = {}) {
     context7,
     browser_use: { ok: app.mcp.has_browser_use, cache: app.plugins.browser_use_cache },
     computer_use: { ok: app.mcp.has_computer_use, cache: app.plugins.computer_use_cache },
-    tmux: { ok: Boolean(tmux.ok), version: tmux.version || null, install_hint: tmux.ok ? null : platformTmuxInstallHint(), error: tmux.error || null },
-    homebrew: process.platform === 'darwin' ? { ok: Boolean(brew), bin: brew, required_for_tmux_install: homebrewNeeded } : { ok: null, bin: null, required_for_tmux_install: false },
-    next_actions: depsNextActions({ npmBin, globalBin, codex, app, context7, tmux, brew, nodeOk })
+    cmux: { ok: Boolean(cmux.ok), version: cmux.version || null, install_hint: cmux.ok ? null : platformCmuxInstallHint(), error: cmux.error || null },
+    homebrew: process.platform === 'darwin' ? { ok: Boolean(brew), bin: brew, required_for_cmux_install: homebrewNeeded } : { ok: null, bin: null, required_for_cmux_install: false },
+    next_actions: depsNextActions({ npmBin, globalBin, codex, app, context7, cmux, brew, nodeOk })
   };
 }
 
-function depsNextActions({ npmBin, globalBin, codex, app, context7, tmux, brew, nodeOk }) {
+function depsNextActions({ npmBin, globalBin, codex, app, context7, cmux, brew, nodeOk }) {
   const out = [];
   if (!nodeOk) out.push('Install Node.js 20.11+.');
   if (!npmBin) out.push('Install npm or use a Node.js distribution that includes npm.');
@@ -1092,7 +1108,7 @@ function depsNextActions({ npmBin, globalBin, codex, app, context7, tmux, brew,
   if (!codex.bin) out.push('Run: sks deps install codex');
   if (!context7.ok) out.push('Run: sks deps install context7');
   if (!app.ok) out.push('Run: sks codex-app check');
-  if (!tmux.ok) out.push(process.platform === 'darwin' && !brew ? 'Install Homebrew, then run: sks deps install tmux' : 'Run: sks deps install tmux');
+  if (!cmux.ok) out.push(process.platform === 'darwin' && !brew ? 'Install Homebrew, then run: sks deps install cmux' : 'Run: sks deps install cmux');
   return out;
 }
 
@@ -1107,7 +1123,7 @@ function printDepsStatus(status) {
   console.log(`Context7:    ${status.context7.ok ? 'ok' : 'missing'}`);
   console.log(`Browser Use: ${status.browser_use.ok ? 'ok' : 'missing'}`);
   console.log(`Computer Use:${status.computer_use.ok ? ' ok' : ' missing'}`);
-  console.log(`tmux:        ${status.tmux.ok ? 'ok' : 'missing'} ${status.tmux.version || ''}`.trimEnd());
+  console.log(`cmux:        ${status.cmux.ok ? 'ok' : 'missing'} ${status.cmux.version || ''}`.trimEnd());
   if (process.platform === 'darwin') console.log(`Homebrew:    ${status.homebrew.ok ? 'ok' : 'missing'} ${status.homebrew.bin || ''}`.trimEnd());
   console.log(`Ready:       ${status.ready ? 'true' : 'false'}`);
   if (status.next_actions.length) {
@@ -1119,11 +1135,11 @@ function printDepsStatus(status) {
 async function depsInstall(args = []) {
   const root = await projectRoot();
   const target = positionalArgs(args)[0] || 'all';
-  const wants = target === 'all' ? ['codex', 'context7', 'tmux'] : [target];
+  const wants = target === 'all' ? ['codex', 'context7', 'cmux'] : [target];
   const actions = [];
   if (wants.includes('codex')) actions.push(await installCodexDependency(args));
   if (wants.includes('context7')) actions.push(await installContext7Dependency(root));
-  if (wants.includes('tmux')) actions.push(await installTmuxDependency(args));
+  if (wants.includes('cmux')) actions.push(await installCmuxDependency(args));
   const status = await depsStatus(root);
   const result = { target, actions, status };
   if (flag(args, '--json')) return console.log(JSON.stringify(result, null, 2));
@@ -1147,18 +1163,22 @@ async function installContext7Dependency(root) {
   return { target: 'context7', status: changed ? 'project_configured' : 'already_configured', command: 'sks context7 check' };
 }
 
-async function installTmuxDependency(args = []) {
-  const before = await tmuxAvailable().catch(() => ({ ok: false }));
-  if (before.ok) return { target: 'tmux', status: 'present', version: before.version || null };
+async function installCmuxDependency(args = []) {
+  const before = await cmuxAvailable().catch(() => ({ ok: false }));
+  if (before.ok) return { target: 'cmux', status: 'present', version: before.version || null };
   if (process.platform === 'darwin') {
     const brew = await which('brew').catch(() => null);
-    if (!brew) return { target: 'tmux', status: 'homebrew_missing', command: '/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" && brew install tmux' };
-    if (flag(args, '--dry-run')) return { target: 'tmux', status: 'dry_run', command: `${brew} install tmux` };
-    if (!await confirmInstall(`Install tmux with Homebrew (${brew} install tmux)?`, args)) return { target: 'tmux', status: 'needs_approval', command: 'brew install tmux' };
-    const run = await runProcess(brew, ['install', 'tmux'], { timeoutMs: 180000, maxOutputBytes: 128 * 1024 });
-    return { target: 'tmux', status: run.code === 0 ? 'installed' : 'failed', command: 'brew install tmux', code: run.code, error: run.code === 0 ? null : `${run.stderr || run.stdout || 'brew install tmux failed'}`.trim() };
+    const command = 'brew tap manaflow-ai/cmux && brew install --cask cmux';
+    if (!brew) return { target: 'cmux', status: 'homebrew_missing', command: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" && ${command}` };
+    if (flag(args, '--dry-run')) return { target: 'cmux', status: 'dry_run', command };
+    if (!await confirmInstall(`Install cmux with Homebrew (${command})?`, args)) return { target: 'cmux', status: 'needs_approval', command };
+    const tap = await runProcess(brew, ['tap', 'manaflow-ai/cmux'], { timeoutMs: 180000, maxOutputBytes: 128 * 1024 });
+    const run = tap.code === 0
+      ? await runProcess(brew, ['install', '--cask', 'cmux'], { timeoutMs: 180000, maxOutputBytes: 128 * 1024 })
+      : tap;
+    return { target: 'cmux', status: run.code === 0 ? 'installed' : 'failed', command, code: run.code, error: run.code === 0 ? null : `${run.stderr || run.stdout || 'brew install --cask cmux failed'}`.trim() };
   }
-  return { target: 'tmux', status: 'manual_required', command: platformTmuxInstallHint() };
+  return { target: 'cmux', status: 'manual_required', command: platformCmuxInstallHint() };
 }
 
 async function confirmInstall(question, args = []) {
@@ -1204,8 +1224,8 @@ async function autoReviewCommand(sub = 'status', args = []) {
     if (flag(args, '--json')) return console.log(JSON.stringify(status, null, 2));
     console.log(`SKS Auto-Review enabled: ${profile}`);
     const sessionArg = readOption(cleanArgs, '--session', null);
-    const session = sessionArg || sanitizeTmuxSessionName(`${profile}-${defaultTmuxSessionName(process.cwd())}`);
-    return launchTmuxUi([...cleanArgs, '--session', session], { codexArgs: ['--profile', profile] });
+    const session = sessionArg || sanitizeCmuxWorkspaceName(`${profile}-${defaultCmuxWorkspaceName(process.cwd())}`);
+    return launchCmuxUi([...cleanArgs, '--session', session], { codexArgs: ['--profile', profile] });
   }
   console.error('Usage: sks auto-review status|enable|disable|start [--high] [--json]');
   console.error('Alias: sks --Auto-review [--high]');
@@ -1220,8 +1240,8 @@ First install and bootstrap this project:
   sks bootstrap
   sks
 
-If tmux is missing:
-  sks deps install tmux
+If cmux is missing:
+  sks deps install cmux
 
 Initialize this project for CLI and Codex App:
   sks setup --bootstrap
@@ -1234,7 +1254,7 @@ Open from terminal:
 Verify:
   sks deps check
   sks codex-app check
-  sks tmux check
+  sks cmux check
   sks auto-review status
   sks doctor --fix
   sks context7 check
@@ -1288,7 +1308,7 @@ async function codexAppHelp(args = []) {
     'ㅅㅋㅅ Codex App', '',
     formatCodexAppStatus(status), '',
     `Skills: project=${skills.project.ok ? 'ok' : `missing ${skills.project.missing.length}`} global=${skills.global.ok ? 'ok' : `missing ${skills.global.missing.length}`}`, '',
-    'Setup:', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks tmux check', '',
+    'Setup:', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks cmux check', '',
     'Generated files:', '  .codex/config.toml', '  .codex/hooks.json', '  .agents/skills/', '  .codex/agents/', '  .codex/SNEAKOSCOPE.md', '  AGENTS.md', '',
     'Prompt routes:', formatDollarCommandsCompact('  ')
   ].join('\n'));
@@ -1320,11 +1340,11 @@ Examples:
 function usage(args = []) {
   const topic = String(args[0] || 'overview').toLowerCase();
   const blocks = {
-    overview: ['ㅅㅋㅅ Usage', '', 'Discover:', '  sks commands', '  sks quickstart', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks tmux check', '  sks dollar-commands', '', `Topics: ${USAGE_TOPICS}`],
+    overview: ['ㅅㅋㅅ Usage', '', 'Discover:', '  sks commands', '  sks quickstart', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks cmux check', '  sks dollar-commands', '', `Topics: ${USAGE_TOPICS}`],
     install: ['Install', '', '  npm i -g sneakoscope', '  sks bootstrap', '  sks', '', 'Fallback:', '  npx -y -p sneakoscope sks bootstrap', '', 'Project:', '  npm i -D sneakoscope', '  npx sks setup --install-scope project'],
-    bootstrap: ['Bootstrap', '', '  sks bootstrap', '  sks setup --bootstrap', '', 'Creates project SKS files, Codex App skills/hooks/config, state/guard files, then checks Codex App, Context7, and tmux.'],
-    deps: ['Dependencies', '', '  sks deps check [--json]', '  sks deps install [tmux|codex|context7|all] [--yes]', '', 'tmux on macOS uses Homebrew only after approval.'],
-    tmux: ['tmux', '', '  sks', '  sks tmux check', '  sks tmux status --once', '  sks deps install tmux'],
+    bootstrap: ['Bootstrap', '', '  sks bootstrap', '  sks setup --bootstrap', '', 'Creates project SKS files, Codex App skills/hooks/config, state/guard files, then checks Codex App, Context7, and cmux.'],
+    deps: ['Dependencies', '', '  sks deps check [--json]', '  sks deps install [cmux|codex|context7|all] [--yes]', '', 'cmux on macOS uses Homebrew only after approval.'],
+    cmux: ['cmux', '', '  sks', '  sks cmux check', '  sks cmux status --once', '  sks deps install cmux'],
     team: ['Team', '', '  sks team "task" executor:5 reviewer:2 user:1', '  sks team watch latest', '', '$Team runs questions -> contract -> scouts -> TriWiki attention -> debate -> runtime graph/inbox -> fresh executors -> review -> cleanup -> reflection -> Honest.'],
     'qa-loop': ['QA-LOOP', '', '  sks qa-loop prepare "QA this app"', '  sks qa-loop answer <MISSION_ID> answers.json', '  sks qa-loop run <MISSION_ID> --max-cycles 8', '', 'Report: YYYY-MM-DD-v<version>-qa-report.md'],
     ralph: ['Ralph', '', '  sks ralph prepare "task"', '  sks ralph answer <MISSION_ID> answers.json', '  sks ralph run <MISSION_ID> --max-cycles 8'],
@@ -1353,13 +1373,13 @@ async function bootstrap(args = []) {
   const cliTools = await ensureRelatedCliTools(args);
   const context7Status = await checkContext7(root);
   const appRuntime = await codexAppIntegrationStatus({ codex: await getCodexInfo().catch(() => ({})) });
-  const deps = await depsStatus(root, { context7: context7Status, codexApp: appRuntime, tmux: cliTools.tmux });
+  const deps = await depsStatus(root, { context7: context7Status, codexApp: appRuntime, cmux: cliTools.cmux });
   const install = await installStatus(root, installScope, { globalCommand });
   const versioningInfo = await versioningStatus(root);
   const skills = await checkRequiredSkills(root);
   const guard = await harnessGuardStatus(root);
   const files = await codexAppFilesStatus(root, skills, versioningInfo);
-  const ready = Boolean(!conflicts.hard_block && install.ok && files.ok && skills.ok && guard.ok && context7Status.ok && appRuntime.ok && deps.tmux.ok);
+  const ready = Boolean(!conflicts.hard_block && install.ok && files.ok && skills.ok && guard.ok && context7Status.ok && appRuntime.ok && deps.cmux.ok);
   const result = {
     root,
     ready,
@@ -1370,7 +1390,7 @@ async function bootstrap(args = []) {
     codex_app: appRuntime,
     global_skills: globalSkills,
     context7: context7Status,
-    tmux: deps.tmux,
+    cmux: deps.cmux,
     harness_guard: guard,
     deps,
     next: ready ? ['sks', '$Team implement ...', '$QA-LOOP run ...'] : deps.next_actions
@@ -1383,7 +1403,7 @@ async function bootstrap(args = []) {
   console.log(`Hooks:         ${files.hooks.ok ? 'ok' : 'missing'}`);
   console.log(`Harness guard: ${guard.ok ? 'ok' : 'blocked'}`);
   console.log(`Context7:      ${context7Status.ok ? 'ok' : 'missing'}`);
-  console.log(`tmux:          ${deps.tmux.ok ? 'ok' : 'missing'}${deps.tmux.version ? ` ${deps.tmux.version}` : ''}`);
+  console.log(`cmux:          ${deps.cmux.ok ? 'ok' : 'missing'}${deps.cmux.version ? ` ${deps.cmux.version}` : ''}`);
   console.log(`ready:         ${ready ? 'true' : 'false'}`);
   if (!ready) {
     console.log('\nNext:');
@@ -1462,7 +1482,7 @@ async function setup(args) {
   console.log('ㅅㅋㅅ Setup\n');
   console.log(`Project:   ${root}`);
   console.log(`Install:   ${install.ok ? 'ok' : 'missing'} ${install.scope} (${install.command_prefix})`);
-  console.log(`CLI tools: Codex ${formatCodexCliToolStatus(cliTools.codex)}; tmux ${cliTools.tmux.ok ? `ok ${cliTools.tmux.version || ''}`.trim() : 'missing'}`);
+  console.log(`CLI tools: Codex ${formatCodexCliToolStatus(cliTools.codex)}; cmux ${cliTools.cmux.ok ? `ok ${cliTools.cmux.version || ''}`.trim() : 'missing'}`);
   console.log(`Hooks:     ${path.relative(root, hooksPath)}`);
   console.log(`Version:   ${versioningInfo.enabled ? (versioningInfo.hook_installed ? 'auto-bump enabled' : 'auto-bump hook missing') : 'not enabled'}${versioningInfo.package_version ? ` (${versioningInfo.package_version})` : ''}`);
   if (localOnly) console.log('Git:       local-only (.git/info/exclude; user AGENTS preserved, SKS managed block refreshed)');
@@ -1474,10 +1494,10 @@ async function setup(args) {
   console.log(`Next:      sks context7 check; sks selftest --mock; sks commands; sks dollar-commands`);
   if (cliTools.codex.status === 'failed') console.log(`\nCodex CLI install failed. Run manually: npm i -g @openai/codex. ${cliTools.codex.error || ''}`.trim());
   if (cliTools.codex.status === 'installed_not_on_path') console.log(`\nCodex CLI installed but not on PATH. ${cliTools.codex.hint}`);
-  if (!cliTools.tmux.ok) console.log(`\ntmux missing. Install: ${cliTools.tmux.install_hint}`);
+  if (!cliTools.cmux.ok) console.log(`\ncmux missing. Install: ${cliTools.cmux.install_hint}`);
   if (!install.ok && install.scope === 'global') console.log('\nGlobal command missing. Run: npm i -g sneakoscope');
   if (!install.ok && install.scope === 'project') console.log('\nProject package missing. Run: npm i -D sneakoscope');
-  if (!appRuntime.ok) console.log('\nCodex App and first-party Browser Use/Computer Use tools are required for SKS tmux/QA parity. Run: sks codex-app check');
+  if (!appRuntime.ok) console.log('\nCodex App and first-party Browser Use/Computer Use tools are required for SKS cmux/QA parity. Run: sks codex-app check');
 }
 
 function formatCodexCliToolStatus(status = {}) {
@@ -1544,7 +1564,7 @@ async function doctor(args) {
   const dbScan = await scanDbSafety(root).catch((err) => ({ ok: false, findings: [{ id: 'db_safety_scan_failed', severity: 'high', reason: err.message }] }));
   const context7Status = await checkContext7(root);
   const appRuntime = await codexAppIntegrationStatus({ codex });
-  const tmuxStatus = await tmuxAvailable().catch((err) => ({ ok: false, version: null, error: err.message }));
+  const cmuxStatus = await cmuxAvailable().catch((err) => ({ ok: false, version: null, error: err.message }));
   const skillStatus = await checkRequiredSkills(root);
   const globalSkillStatus = await checkRequiredSkills(null, globalCodexSkillsRoot());
   const guardStatus = await harnessGuardStatus(root);
@@ -1565,7 +1585,7 @@ async function doctor(args) {
     sneakoscope: { ok: await exists(path.join(root, '.sneakoscope')) },
     context7: context7Status,
     codex_app_runtime: appRuntime,
-    runtime: { tmux: { ok: Boolean(tmuxStatus.ok), version: tmuxStatus.version || null, install_hint: tmuxStatus.ok ? null : platformTmuxInstallHint(), error: tmuxStatus.error || null } },
+    runtime: { cmux: { ok: Boolean(cmuxStatus.ok), version: cmuxStatus.version || null, install_hint: cmuxStatus.ok ? null : platformCmuxInstallHint(), error: cmuxStatus.error || null } },
     harness_guard: guardStatus,
     versioning: versioningInfo,
     db_guard: { ok: dbPolicyExists && dbScan.ok, policy: dbPolicyExists ? await loadDbSafetyPolicy(root) : null, scan: dbScan },
@@ -1577,7 +1597,7 @@ async function doctor(args) {
     },
     package: { bytes: pkgBytes, human: formatBytes(pkgBytes) }, storage
   };
-  result.ready = !result.harness_conflicts.hard_block && nodeOk && Boolean(codex.bin) && install.ok && result.sneakoscope.ok && result.context7.ok && appRuntime.ok && result.runtime.tmux.ok && result.harness_guard.ok && result.versioning.ok && result.db_guard.ok && result.codex_app.ok && result.skills.ok && result.global_skills.ok;
+  result.ready = !result.harness_conflicts.hard_block && nodeOk && Boolean(codex.bin) && install.ok && result.sneakoscope.ok && result.context7.ok && appRuntime.ok && result.runtime.cmux.ok && result.harness_guard.ok && result.versioning.ok && result.db_guard.ok && result.codex_app.ok && result.skills.ok && result.global_skills.ok;
   if (result.harness_conflicts.hard_block) process.exitCode = 1;
   if (flag(args, '--json')) return console.log(JSON.stringify(result, null, 2));
   console.log('ㅅㅋㅅ Doctor\n');
@@ -1593,7 +1613,7 @@ async function doctor(args) {
   console.log(`State:     ${result.sneakoscope.ok ? 'ok' : 'missing .sneakoscope'}`);
   console.log(`Context7:  ${result.context7.ok ? 'ok' : 'missing MCP config'} project=${result.context7.project.ok ? 'ok' : 'missing'} global=${result.context7.global.ok ? 'ok' : 'missing'}`);
   console.log(`App tools: ${appRuntime.ok ? 'ok' : 'needs setup'} Codex App=${appRuntime.app.installed ? 'ok' : 'missing'} Browser Use=${appRuntime.mcp.has_browser_use ? 'ok' : 'missing'} Computer Use=${appRuntime.mcp.has_computer_use ? 'ok' : 'missing'}`);
-  console.log(`tmux:      ${result.runtime.tmux.ok ? 'ok' : 'missing'} ${result.runtime.tmux.version || ''}`.trimEnd());
+  console.log(`cmux:      ${result.runtime.cmux.ok ? 'ok' : 'missing'} ${result.runtime.cmux.version || ''}`.trimEnd());
   console.log(`Guard:     ${result.harness_guard.ok ? 'ok' : 'blocked'}${result.harness_guard.source_exception ? ' source-exception' : ''}`);
   console.log(`Version:   ${result.versioning.ok ? 'ok' : 'missing'}${result.versioning.enabled ? ` ${result.versioning.package_version || ''}` : ` ${result.versioning.reason || 'disabled'}`}`);
   console.log(`DB Guard:  ${result.db_guard.ok ? 'ok' : 'blocked'} ${dbScan.findings?.length || 0} finding(s)`);
@@ -1610,13 +1630,13 @@ async function doctor(args) {
   if (result.harness_conflicts.hard_block) console.log(`\n${formatHarnessConflictReport(conflictScan)}`);
   if (!result.context7.ok) console.log('Context7 MCP missing. Run: sks context7 setup --scope project');
   if (!appRuntime.ok) console.log('Codex App or first-party MCP/plugin tools missing. Run: sks codex-app check');
-  if (!result.runtime.tmux.ok) console.log('tmux missing. Run: sks deps install tmux');
+  if (!result.runtime.cmux.ok) console.log('cmux missing. Run: sks deps install cmux');
   if (!result.harness_guard.ok) console.log('Harness guard failed. Run: sks setup from a real terminal, then sks guard check.');
   if (!result.versioning.ok) console.log('Versioning hook missing. Run: sks versioning hook, or sks doctor --fix.');
   if (!result.skills.ok) console.log(`Missing skills: ${result.skills.missing.join(', ')}. Run: sks setup`);
   if (!result.global_skills.ok) console.log(`Missing global $ skills: ${result.global_skills.missing.join(', ')}. Run: npm i -g sneakoscope, or sks setup from a non-local-only run.`);
   const blocked = [];
-  if (!result.runtime.tmux.ok) blocked.push(['tmux is missing', 'sks deps install tmux']);
+  if (!result.runtime.cmux.ok) blocked.push(['cmux is missing', 'sks deps install cmux']);
   if (!appRuntime.ok) blocked.push(['Codex App or first-party MCP/plugin tools need setup', 'sks codex-app check']);
   if (blocked.length) {
     console.log('\nBlocked:');
@@ -2227,7 +2247,12 @@ async function selftest() {
   if (!bootstrapResult.project_setup?.ok || typeof bootstrapResult.ready !== 'boolean') throw new Error('selftest failed: bootstrap json did not report project setup and ready boolean');
   const depsCheck = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'deps', 'check', '--json'], { cwd: bootstrapJsonTmp, env: { HOME: path.join(bootstrapJsonTmp, 'home') }, timeoutMs: 20000, maxOutputBytes: 256 * 1024 });
   const depsResult = JSON.parse(depsCheck.stdout);
-  if (!depsResult.node?.ok || !('tmux' in depsResult) || !('homebrew' in depsResult)) throw new Error('selftest failed: deps check json missing expected fields');
+  if (!depsResult.node?.ok || !('cmux' in depsResult) || !('homebrew' in depsResult)) throw new Error('selftest failed: deps check json missing expected fields');
+  const madProfilePath = path.join(tmp, 'mad-codex-config.toml');
+  const madProfile = await enableMadHighProfile({ configPath: madProfilePath });
+  const madProfileText = await safeReadText(madProfilePath);
+  if (madProfile.profile_name !== 'sks-mad-high' || !madProfileText.includes('sandbox_mode = "danger-full-access"') || !madProfileText.includes('approval_policy = "never"') || !madProfileText.includes('model_reasoning_effort = "high"')) throw new Error('selftest failed: MAD high profile is not full-access high/fast');
+  if (!isMadHighLaunch(['--mad', '--high']) || isMadHighLaunch(['db', '--mad'])) throw new Error('selftest failed: MAD high launch flag parsing is not top-level only');
   const guardBlocked = await checkHarnessModification(tmp, { tool_name: 'apply_patch', command: '*** Update File: .agents/skills/team/SKILL.md\n+tamper\n' });
   if (guardBlocked.action !== 'block') throw new Error('selftest failed: harness guard allowed skill tampering');
   const setupBlocked = await checkHarnessModification(tmp, { command: 'sks setup --force' });
@@ -2613,7 +2638,7 @@ async function selftest() {
   const codexConfigText = await safeReadText(path.join(tmp, '.codex', 'config.toml'));
   if (!codexConfigText.includes('multi_agent = true')) throw new Error('selftest failed: multi_agent not enabled');
   if (!hasContext7ConfigText(codexConfigText)) throw new Error('selftest failed: Context7 MCP not configured');
-  if (!codexConfigText.includes('[profiles.sks-task-medium]') || !codexConfigText.includes('[profiles.sks-logic-high]') || !codexConfigText.includes('[profiles.sks-research-xhigh]')) throw new Error('selftest failed: reasoning profiles not configured');
+  if (!codexConfigText.includes('[profiles.sks-task-medium]') || !codexConfigText.includes('[profiles.sks-logic-high]') || !codexConfigText.includes('[profiles.sks-research-xhigh]') || !codexConfigText.includes('[profiles.sks-mad-high]')) throw new Error('selftest failed: reasoning profiles not configured');
   if (!codexConfigText.includes('[agents.analysis_scout]')) throw new Error('selftest failed: analysis_scout agent not configured');
   if (!codexConfigText.includes('[agents.team_consensus]')) throw new Error('selftest failed: team_consensus agent not configured');
   const autoReviewHome = path.join(tmp, 'auto-review-home');
@@ -2868,6 +2893,8 @@ async function selftest() {
   if (roleTeamPlan.roster.analysis_team.length !== 5) throw new Error('selftest failed: executor role count not reflected in analysis scout team');
   if (roleTeamPlan.roster.development_team.filter((agent) => agent.role === 'executor').length !== 5) throw new Error('selftest failed: executor role count not reflected in development team');
   if (!roleTeamPlan.roster.debate_team.some((agent) => /inconvenience/.test(agent.persona))) throw new Error('selftest failed: user friction persona missing from debate team');
+  const cmuxTeam = await launchCmuxTeamView({ root: tmp, missionId: teamId, plan: roleTeamPlan, json: true });
+  if (!cmuxTeam.agents?.length || !cmuxTeam.agents.some((entry) => entry.agent === 'analysis_scout_1') || !cmuxTeam.agents.every((entry) => String(entry.command || '').includes('team watch'))) throw new Error('selftest failed: Team cmux view did not expose agent live lanes');
   if (routeReasoning(routePrompt('$Research frontier idea'), '$Research frontier idea').effort !== 'xhigh') throw new Error('selftest failed: research reasoning not xhigh');
   if (routeReasoning(routePrompt('$DB migration'), '$DB migration').effort !== 'high') throw new Error('selftest failed: logical reasoning not high');
   if (routeReasoning(routePrompt('$DFix button label'), '$DFix button label').effort !== 'medium') throw new Error('selftest failed: simple reasoning not medium');
@@ -3514,7 +3541,7 @@ function userRequestSignal(prompt = '') {
   const topicRules = [
     ['ambiguity-questions', /모호|ambiguity|clarification|질문|답변|answers?\.json|decision-contract|추론|예측/],
     ['triwiki-priority-memory', /triwiki|wiki|메모리|memory|기억|우선|반복|자주|카운팅|count|frequency|weight/],
-    ['install-bootstrap', /bootstrap|postinstall|doctor|deps|tmux|homebrew|최초\s*설치|셋업|setup/],
+    ['install-bootstrap', /bootstrap|postinstall|doctor|deps|cmux|homebrew|최초\s*설치|셋업|setup/],
     ['version-release', /버전|version|publish:dry|release|npm\s+pack/],
     ['qa-loop', /qa|e2e|검증|리포트|report/],
     ['team-pipeline', /team|subagent|세션|cleanup|reflection|회고|반성/],
@@ -3796,6 +3823,7 @@ async function team(args) {
     questions: path.join(dir, 'questions.md'),
     codex_agents: ['analysis_scout', 'team_consensus', 'implementation_worker', 'db_safety_reviewer', 'qa_reviewer']
   };
+  result.cmux = await launchCmuxTeamView({ root, missionId: id, plan, promptFile: result.workflow, json: flag(args, '--json') });
   if (flag(args, '--json')) return console.log(JSON.stringify(result, null, 2));
   console.log(`Team mission created: ${id}`);
   console.log(`Plan: ${path.relative(root, result.plan)}`);
@@ -3805,8 +3833,10 @@ async function team(args) {
   console.log(`Runtime graph: ${path.relative(root, result.team_graph)}`);
   console.log(`Worker inbox: ${path.relative(root, result.worker_inbox_dir)}`);
   console.log(`Live: ${path.relative(root, result.live)}`);
+  if (result.cmux.ready) console.log(`cmux: ${result.cmux.created ? 'opened' : 'ready'} ${result.cmux.agents.length} agent lane(s)`);
+  else console.log(`cmux: blocked (${Array.from(new Set(result.cmux.blockers || [])).join('; ')})`);
   console.log(`Watch: sks team watch ${id}`);
-  console.log('Use $Team in Codex App to run the scout-first flow: parallel analysis scouts, TriWiki attention, debate/consensus, runtime graph/inbox handoff, then a fresh implementation team with disjoint ownership.');
+  console.log('Use $Team in Codex App or the cmux lanes from this CLI flow to run scouts, debate/consensus, runtime graph/inbox handoff, then a fresh implementation team with disjoint ownership.');
 }
 
 function parseTeamCreateArgs(args) {
@@ -3952,6 +3982,7 @@ function buildTeamPlan(id, prompt, opts = {}) {
       markdown: 'team-live.md',
       transcript: 'team-transcript.jsonl',
       dashboard: 'team-dashboard.json',
+      cmux: 'sks team opens a cmux workspace with one live multi-line lane per visible Team agent budget when cmux is available.',
       commands: [
         'sks team status <mission-id>',
         'sks team log <mission-id>',

package/src/core/auto-review.mjs

@@ -6,6 +6,7 @@ export const AUTO_REVIEW_REVIEWER = 'guardian_subagent';
 export const LEGACY_AUTO_REVIEW_REVIEWER = 'auto_review';
 export const AUTO_REVIEW_PROFILE = 'sks-auto-review';
 export const AUTO_REVIEW_HIGH_PROFILE = 'sks-auto-review-high';
+export const MAD_HIGH_PROFILE = 'sks-mad-high';
 
 export function codexHome(env = process.env) {
   return path.resolve(env.CODEX_HOME || path.join(env.HOME || os.homedir(), '.codex'));
@@ -56,6 +57,34 @@ export async function enableAutoReview(opts = {}) {
   };
 }
 
+export async function enableMadHighProfile(opts = {}) {
+  const configPath = opts.configPath || codexConfigPath(opts.env || process.env);
+  await ensureDir(path.dirname(configPath));
+  const current = await readText(configPath, '');
+  let next = upsertTable(current, `profiles.${MAD_HIGH_PROFILE}`, [
+    `[profiles.${MAD_HIGH_PROFILE}]`,
+    'model = "gpt-5.5"',
+    'approval_policy = "never"',
+    'sandbox_mode = "danger-full-access"',
+    'model_reasoning_effort = "high"'
+  ].join('\n'));
+  if (!next.endsWith('\n')) next += '\n';
+  await writeTextAtomic(configPath, next);
+  return {
+    config_path: configPath,
+    profile_name: MAD_HIGH_PROFILE,
+    launch_args: ['--profile', MAD_HIGH_PROFILE],
+    sandbox_mode: 'danger-full-access',
+    approval_policy: 'never',
+    model_reasoning_effort: 'high',
+    scope: 'explicit_launch_only'
+  };
+}
+
+export function madHighProfileName() {
+  return MAD_HIGH_PROFILE;
+}
+
 export async function disableAutoReview(opts = {}) {
   const configPath = opts.configPath || codexConfigPath(opts.env || process.env);
   const current = await readText(configPath, '');

package/src/core/cmux-ui.mjs

@@ -0,0 +1,204 @@
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { exists, packageRoot, projectRoot, runProcess, sha256, which } from './fsx.mjs';
+import { getCodexInfo } from './codex-adapter.mjs';
+import { codexAppIntegrationStatus, formatCodexAppStatus } from './codex-app.mjs';
+
+export const SKS_CMUX_LOGO = [
+  '+----------------------+',
+  '|        ㅅㅋㅅ         |',
+  '|       SKS cmux       |',
+  '+----------------------+'
+].join('\n');
+
+export function sanitizeCmuxWorkspaceName(input) {
+  const base = String(input || 'sks').trim().replace(/[^A-Za-z0-9_.-]+/g, '-').replace(/^-+|-+$/g, '');
+  return (base || 'sks').slice(0, 80);
+}
+
+export function defaultCmuxWorkspaceName(root) {
+  const base = sanitizeCmuxWorkspaceName(path.basename(root || process.cwd()) || 'project');
+  const hash = sha256(path.resolve(root || process.cwd())).slice(0, 8);
+  return sanitizeCmuxWorkspaceName(`sks-${base}-${hash}`);
+}
+
+export function shellEscape(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+export function platformCmuxInstallHint() {
+  if (process.platform !== 'darwin') return 'cmux is a native macOS app; install it on macOS 14+ from https://cmux.com or https://github.com/manaflow-ai/cmux.';
+  return [
+    'brew tap manaflow-ai/cmux && brew install --cask cmux',
+    'then expose the CLI if needed:',
+    'sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux'
+  ].join(' ');
+}
+
+export async function findCmuxBinary() {
+  const env = process.env.SKS_CMUX_BIN || process.env.CMUX_BIN;
+  if (env && await exists(env)) return env;
+  const onPath = await which('cmux').catch(() => null);
+  if (onPath) return onPath;
+  const appBin = '/Applications/cmux.app/Contents/Resources/bin/cmux';
+  if (process.platform === 'darwin' && await exists(appBin)) return appBin;
+  return null;
+}
+
+export async function cmuxAvailable() {
+  const bin = await findCmuxBinary();
+  if (!bin) return { ok: false, bin: null, version: null, error: 'cmux CLI not found' };
+  const probe = await runProcess(bin, ['list-workspaces', '--json'], { timeoutMs: 5000, maxOutputBytes: 16 * 1024 }).catch((err) => ({ code: 1, stderr: err.message, stdout: '' }));
+  const text = `${probe.stdout || ''}${probe.stderr || ''}`.trim();
+  return { ok: probe.code === 0, bin, version: text || 'cmux CLI', error: probe.code === 0 ? null : text || 'cmux workspace probe failed' };
+}
+
+export function codexLaunchCommand(root, codexBin, codexArgs = []) {
+  const extraArgs = Array.isArray(codexArgs) ? codexArgs : [];
+  return [
+    'clear',
+    `printf '%s\\n' ${shellEscape(SKS_CMUX_LOGO)}`,
+    `printf '\\nProject: %s\\n' ${shellEscape(root)}`,
+    'printf \'Runtime: cmux workspace for Codex CLI\\n\'',
+    'printf \'Prompt:  use canonical $ commands, for example $Team or $QA-LOOP\\n\\n\'',
+    'sleep 1',
+    `exec ${[shellEscape(codexBin), ...extraArgs.map(shellEscape), '--cd', shellEscape(root)].join(' ')}`
+  ].join('; ');
+}
+
+export function teamAgentCommand(root, missionId, agentId, phase) {
+  return [
+    `printf '%s\\n' ${shellEscape(`${SKS_CMUX_LOGO}\n\nTeam mission: ${missionId}\nAgent: ${agentId}\nPhase: ${phase}\n`)}`,
+    `cd ${shellEscape(root)}`,
+    `node ${shellEscape(path.join(packageRoot(), 'bin', 'sks.mjs'))} team watch ${shellEscape(missionId)} --follow --lines 12`
+  ].join('; ');
+}
+
+export async function buildCmuxLaunchPlan(opts = {}) {
+  const root = path.resolve(opts.root || await projectRoot());
+  const workspace = sanitizeCmuxWorkspaceName(opts.workspace || opts.session || defaultCmuxWorkspaceName(root));
+  const sksBin = opts.sksBin || path.join(packageRoot(), 'bin', 'sks.mjs');
+  const codex = opts.codex || await getCodexInfo().catch(() => ({}));
+  const cmux = opts.cmux || await cmuxAvailable();
+  const app = opts.app || await codexAppIntegrationStatus({ codex });
+  const codexArgs = Array.isArray(opts.codexArgs) ? opts.codexArgs : [];
+  return {
+    root,
+    workspace,
+    sksBin,
+    codex,
+    cmux,
+    app,
+    codexArgs,
+    ready: Boolean(cmux.ok && codex.bin),
+    warnings: app.ok ? [] : app.guidance || [],
+    blockers: [
+      ...(!cmux.ok ? [`cmux missing. Install: ${platformCmuxInstallHint()}`] : []),
+      ...(!codex.bin ? ['Codex CLI missing. Install: npm i -g @openai/codex, or set SKS_CODEX_BIN.'] : [])
+    ]
+  };
+}
+
+export function formatCmuxBanner(status = null) {
+  const lines = [
+    SKS_CMUX_LOGO,
+    '',
+    'ㅅㅋㅅ cmux runtime',
+    '',
+    'Canonical prompt commands:',
+    '  $DFix  $Answer  $SKS  $Team  $QA-LOOP  $Ralph  $Research  $AutoResearch  $DB  $GX  $Wiki  $Help',
+    '',
+    'CLI-first runtime:',
+    '  sks                 open a cmux Codex CLI workspace',
+    '  sks --mad --high    open one-shot MAD-SKS high reasoning workspace',
+    '  sks team "task"     prepare Team mission and cmux multi-line agent view',
+    '',
+    'Useful terminal commands:',
+    '  sks commands',
+    '  sks dollar-commands',
+    '  sks codex-app check',
+    '  sks doctor --fix'
+  ];
+  if (status) lines.push('', formatCodexAppStatus(status));
+  return lines.join('\n');
+}
+
+export async function launchCmuxUi(args = [], opts = {}) {
+  const rootArg = readOption(args, '--root', opts.root);
+  const workspaceArg = readOption(args, '--workspace', readOption(args, '--session', opts.workspace || opts.session));
+  const plan = await buildCmuxLaunchPlan({ ...opts, root: rootArg, workspace: workspaceArg });
+  if (args.includes('--json')) return { plan };
+  if (!plan.ready && !args.includes('--status-only')) {
+    console.log(formatCmuxBanner(plan.app));
+    console.log('\nLaunch blocked:\n');
+    for (const blocker of Array.from(new Set(plan.blockers))) console.log(`- ${blocker}`);
+    process.exitCode = 1;
+    return { plan };
+  }
+  if (!args.includes('--no-open')) await openCmuxApp().catch(() => null);
+  const command = codexLaunchCommand(plan.root, plan.codex.bin, plan.codexArgs);
+  const created = spawnSync(plan.cmux.bin, ['new-workspace', '--cwd', plan.root, '--command', command], { encoding: 'utf8', stdio: args.includes('--quiet') ? 'pipe' : 'inherit' });
+  if (created.status !== 0) {
+    process.exitCode = created.status || 1;
+    if (created.stderr) process.stderr.write(created.stderr);
+    return { plan };
+  }
+  if (args.includes('--no-open')) {
+    console.log(`SKS cmux workspace requested: ${plan.workspace}`);
+  }
+  return { plan, created: true };
+}
+
+export async function openCmuxApp() {
+  if (process.platform !== 'darwin') return { ok: false, reason: 'not_macos' };
+  const run = await runProcess('open', ['-a', 'cmux'], { timeoutMs: 5000, maxOutputBytes: 16 * 1024 }).catch((err) => ({ code: 1, stderr: err.message, stdout: '' }));
+  return { ok: run.code === 0, stdout: run.stdout || '', stderr: run.stderr || '' };
+}
+
+export async function launchCmuxTeamView({ root, missionId, plan = {}, promptFile = null, json = false } = {}) {
+  const launch = await buildCmuxLaunchPlan({ root, workspace: `sks-team-${missionId}` });
+  const agents = [
+    ...(plan.roster?.analysis_team || []),
+    ...(plan.roster?.debate_team || []),
+    ...(plan.roster?.development_team || []),
+    ...(plan.roster?.validation_team || [])
+  ];
+  const uniqueAgents = [];
+  const seen = new Set();
+  for (const agent of agents) {
+    const id = agent.id || String(agent);
+    if (seen.has(id)) continue;
+    seen.add(id);
+    uniqueAgents.push(id);
+  }
+  const commands = uniqueAgents.slice(0, Math.max(1, plan.agent_session_count || 3)).map((agentId, index) => ({
+    agent: agentId,
+    command: teamAgentCommand(launch.root, missionId, agentId, index === 0 ? 'analysis' : 'team', promptFile)
+  }));
+  const result = { ready: launch.ready, cmux: launch.cmux, workspace: launch.workspace, agents: commands, blockers: launch.blockers };
+  if (json || !launch.ready) return result;
+  const first = commands[0]?.command || teamAgentCommand(launch.root, missionId, 'parent_orchestrator', 'team', promptFile);
+  const created = spawnSync(launch.cmux.bin, ['new-workspace', '--cwd', launch.root, '--command', first], { encoding: 'utf8', stdio: 'ignore' });
+  result.created = created.status === 0;
+  for (const entry of commands.slice(1)) {
+    spawnSync(launch.cmux.bin, ['new-split', 'right'], { encoding: 'utf8', stdio: 'ignore' });
+    spawnSync(launch.cmux.bin, ['send', `${entry.command}\n`], { encoding: 'utf8', stdio: 'ignore' });
+  }
+  return result;
+}
+
+export async function runCmuxStatus(args = [], opts = {}) {
+  const once = args.includes('--once') || !args.includes('--watch');
+  do {
+    const app = await codexAppIntegrationStatus();
+    console.clear();
+    console.log(formatCmuxBanner(app));
+    if (once) return app;
+    await new Promise((resolve) => setTimeout(resolve, 5000));
+  } while (true);
+}
+
+function readOption(args, name, fallback = null) {
+  const i = args.indexOf(name);
+  return i >= 0 && args[i + 1] ? args[i + 1] : fallback;
+}

package/src/core/codex-app.mjs

@@ -118,7 +118,7 @@ export async function codexAppIntegrationStatus(opts = {}) {
 export function codexAppGuidance({ appInstalled, codex, mcpList, computerUseReady, browserUseReady }) {
   const lines = [];
   if (!appInstalled) {
-    lines.push('Install and open Codex App first. SKS CLI blocks tmux launch until Codex App is present because first-party MCP/plugin tools are App-provisioned.');
+    lines.push('Install and open Codex App for first-party MCP/plugin tools. SKS cmux launch can still run with Codex CLI alone, but Browser Use and Computer Use evidence will be unavailable until Codex App is ready.');
     lines.push(`Docs: ${CODEX_APP_DOCS_URL}`);
   }
   if (!codex?.bin) lines.push('Install Codex CLI too: npm i -g @openai/codex, or set SKS_CODEX_BIN.');

package/src/core/fsx.mjs

@@ -5,7 +5,7 @@ import os from 'node:os';
 import crypto from 'node:crypto';
 import { spawn } from 'node:child_process';
 
-export const PACKAGE_VERSION = '0.6.60';
+export const PACKAGE_VERSION = '0.6.62';
 export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
 export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
 

package/src/core/init.mjs

@@ -402,7 +402,13 @@ export async function initProject(root, opts = {}) {
     created.push('AGENTS.md managed block');
   }
 
-  await writeTextAtomic(path.join(root, '.codex', 'config.toml'), `[features]\ncodex_hooks = true\nmulti_agent = true\n\n[agents]\nmax_threads = 6\nmax_depth = 1\n\n${context7ConfigToml()}\n[agents.analysis_scout]\ndescription = "Read-only SKS scout."\nconfig_file = "./agents/analysis-scout.toml"\nnickname_candidates = ["Scout", "Mapper"]\n\n[agents.team_consensus]\ndescription = "SKS planning/debate agent."\nconfig_file = "./agents/team-consensus.toml"\nnickname_candidates = ["Consensus", "Atlas"]\n\n[agents.implementation_worker]\ndescription = "SKS bounded implementation worker."\nconfig_file = "./agents/implementation-worker.toml"\nnickname_candidates = ["Builder", "Mason"]\n\n[agents.db_safety_reviewer]\ndescription = "Read-only DB safety reviewer."\nconfig_file = "./agents/db-safety-reviewer.toml"\nnickname_candidates = ["Sentinel", "Ledger"]\n\n[agents.qa_reviewer]\ndescription = "Read-only QA reviewer."\nconfig_file = "./agents/qa-reviewer.toml"\nnickname_candidates = ["Verifier", "Scout"]\n\n[profiles.sks-task-medium]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "medium"\n\n[profiles.sks-logic-high]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "high"\n\n[profiles.sks-research-xhigh]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "xhigh"\n\n[profiles.sks-ralph]\nmodel = "gpt-5.5"\napproval_policy = "never"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "high"\n\n[profiles.sks-research]\nmodel = "gpt-5.5"\napproval_policy = "never"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "xhigh"\n\n[profiles.sks-team]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "high"\n\n[profiles.sks-default]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "medium"\n`);
+  await writeTextAtomic(path.join(root, '.codex', 'config.toml'), `[features]\ncodex_hooks = true\nmulti_agent = true\n\n[agents]\nmax_threads = 6\nmax_depth = 1\n\n${context7ConfigToml()}\n[agents.analysis_scout]\ndescription = "Read-only SKS scout."\nconfig_file = "./agents/analysis-scout.toml"\nnickname_candidates = ["Scout", "Mapper"]\n\n[agents.team_consensus]\ndescription = "SKS planning/debate agent."\nconfig_file = "./agents/team-consensus.toml"\nnickname_candidates = ["Consensus", "Atlas"]\n\n[agents.implementation_worker]\ndescription = "SKS bounded implementation worker."\nconfig_file = "./agents/implementation-worker.toml"\nnickname_candidates = ["Builder", "Mason"]\n\n[agents.db_safety_reviewer]\ndescription = "Read-only DB safety reviewer."\nconfig_file = "./agents/db-safety-reviewer.toml"\nnickname_candidates = ["Sentinel", "Ledger"]\n\n[agents.qa_reviewer]\ndescription = "Read-only QA reviewer."\nconfig_file = "./agents/qa-reviewer.toml"\nnickname_candidates = ["Verifier", "Scout"]\n\n[profiles.sks-task-medium]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "medium"\n\n[profiles.sks-logic-high]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "high"\n\n[profiles.sks-research-xhigh]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "xhigh"\n\n[profiles.sks-ralph]\nmodel = "gpt-5.5"\napproval_policy = "never"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "high"\n\n[profiles.sks-research]\nmodel = "gpt-5.5"\napproval_policy = "never"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "xhigh"\n\n[profiles.sks-team]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "high"\n\n[profiles.sks-mad-high]
+model = "gpt-5.5"
+approval_policy = "never"
+sandbox_mode = "danger-full-access"
+model_reasoning_effort = "high"
+
+[profiles.sks-default]\nmodel = "gpt-5.5"\napproval_policy = "on-request"\nsandbox_mode = "workspace-write"\nmodel_reasoning_effort = "medium"\n`);
   created.push('.codex/config.toml');
 
   await writeTextAtomic(path.join(root, '.codex', 'SNEAKOSCOPE.md'), codexAppQuickReference(installScope, hookCommandPrefix));
@@ -458,7 +464,7 @@ function codexAppQuickReference(scope, commandPrefix) {
     `Install scope: \`${scope}\``,
     `Command: \`${commandPrefix} <command>\``,
     'Files: AGENTS.md, .codex/hooks.json, .codex/config.toml, .codex/SNEAKOSCOPE.md, .agents/skills, .codex/agents, .sneakoscope/missions.',
-    `Discover: ${commandPrefix} bootstrap; ${commandPrefix} deps check; ${commandPrefix} commands; ${commandPrefix} codex-app check; ${commandPrefix} tmux check; ${commandPrefix} dollar-commands; ${commandPrefix} pipeline status.`,
+    `Discover: ${commandPrefix} bootstrap; ${commandPrefix} deps check; ${commandPrefix} commands; ${commandPrefix} codex-app check; ${commandPrefix} cmux check; ${commandPrefix} dollar-commands; ${commandPrefix} pipeline status.`,
     'dollar-commands:',
     ...DOLLAR_COMMANDS.map((c) => `- \`${c.command}\`: ${c.route}`),
     `Picker skills: ${DOLLAR_COMMAND_ALIASES.map((x) => x.app_skill).join(', ')}.`,
@@ -466,7 +472,7 @@ function codexAppQuickReference(scope, commandPrefix) {
     `Full routes write reflection.md, record lessons to ${REFLECTION_MEMORY_PATH}, refresh/pack TriWiki, validate, then final-answer with a user-visible completion summary plus Honest Mode.`,
     `Context Tracking: TriWiki SSOT. Before each route phase read only the latest coordinate+voxel overlay pack at .sneakoscope/wiki/context-pack.json; coordinate-only legacy packs are invalid. Use attention.use_first for compact high-trust recall and hydrate attention.hydrate_first from source before risky/lower-trust decisions. During every stage hydrate low-trust claims from source/hash/RGBA anchors; after changes run ${commandPrefix} wiki refresh or pack; before handoff/final run ${commandPrefix} wiki validate .sneakoscope/wiki/context-pack.json.`,
     stackCurrentDocsPolicyText(commandPrefix),
-    `Runtime: open Codex App once, then run ${commandPrefix} bootstrap, ${commandPrefix} deps check, or ${commandPrefix} deps install tmux.`,
+    `Runtime: open Codex App once, then run ${commandPrefix} bootstrap, ${commandPrefix} deps check, or ${commandPrefix} deps install cmux.`,
     `Guard: generated harness files are immutable outside the engine source repo; check ${commandPrefix} guard check; conflicts use ${commandPrefix} conflicts prompt with human approval.`
   ].join('\n') + '\n';
 }

package/src/core/pipeline.mjs

@@ -304,6 +304,7 @@ async function prepareTeam(root, route, task, required) {
       markdown: 'team-live.md',
       transcript: 'team-transcript.jsonl',
       dashboard: 'team-dashboard.json',
+      cmux: 'CLI Team entrypoints open cmux live lanes for the visible Team agent budget when cmux is available.',
       commands: ['sks team status latest', 'sks team log latest', 'sks team tail latest', 'sks team watch latest', 'sks team event latest --agent <name> --phase <phase> --message "..."']
     },
     required_artifacts: ['team-roster.json', 'team-analysis.md', ...(fromChatImgRequired ? [FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT] : []), 'team-consensus.md', ...teamRuntimeRequiredArtifacts(), 'team-review.md', 'team-gate.json', TEAM_SESSION_CLEANUP_ARTIFACT, 'reflection.md', 'reflection-gate.json', 'team-live.md', 'team-transcript.jsonl', 'team-dashboard.json', '.sneakoscope/wiki/context-pack.json', 'context7-evidence.jsonl']

package/src/core/questions.mjs

@@ -78,7 +78,7 @@ export function inferAnswersForPrompt(prompt, explicitAnswers = {}) {
     .trim();
   const version = String(text || '').match(/\bv?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)\b/)?.[1] || null;
   const versionWork = /버전|version|bump|release|publish:dry|npm\s+pack/.test(lower);
-  const installWork = /bootstrap|postinstall|doctor|deps|tmux|homebrew|first install|최초\s*설치|설치\s*ux|셋업|setup/.test(lower);
+  const installWork = /bootstrap|postinstall|doctor|deps|cmux|homebrew|first install|최초\s*설치|설치\s*ux|셋업|setup/.test(lower);
   const questionGateWork = /모호|ambiguity|clarification|질문|triwiki|추론|infer|predict|예측|answers?\.json|decision-contract/.test(lower);
   const prioritySignalWork = /화|짜증|답답|;;|!!|강력|기억|우선|자주|반복|카운팅|count|frequency|frequent|priority|weight/.test(lower);
   const cliSurfaceWork = /\b(cli|command|route|usage|help|sks)\b|명령|커맨드|사용법/.test(lower);

package/src/core/routes.mjs

@@ -4,7 +4,7 @@ export const FROM_CHAT_IMG_CHECKLIST_ARTIFACT = 'from-chat-img-checklist.md';
 export const FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT = 'from-chat-img-temp-triwiki.json';
 export const FROM_CHAT_IMG_QA_LOOP_ARTIFACT = 'from-chat-img-qa-loop.json';
 export const FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS = 5;
-export const USAGE_TOPICS = 'install|setup|bootstrap|deps|tmux|auto-review|team|qa-loop|ralph|research|db|codex-app|dfix|design|imagegen|dollar|context7|pipeline|reasoning|guard|conflicts|versioning|eval|hproof|gx|wiki';
+export const USAGE_TOPICS = 'install|setup|bootstrap|deps|cmux|auto-review|team|qa-loop|ralph|research|db|codex-app|dfix|design|imagegen|dollar|context7|pipeline|reasoning|guard|conflicts|versioning|eval|hproof|gx|wiki';
 
 export const RECOMMENDED_MCP_SERVERS = [
   {
@@ -330,11 +330,12 @@ export const COMMAND_CATALOG = [
   { name: 'commands', usage: 'sks commands [--json]', description: 'List every user-facing command with a short description.' },
   { name: 'usage', usage: `sks usage [${USAGE_TOPICS}]`, description: 'Print copy-ready workflows for common tasks.' },
   { name: 'quickstart', usage: 'sks quickstart', description: 'Show the shortest safe setup and verification flow.' },
-  { name: 'bootstrap', usage: 'sks bootstrap [--install-scope global|project] [--local-only] [--json]', description: 'Initialize the current project, install SKS Codex App files/skills, check Context7/Codex App/tmux, and print ready true/false.' },
-  { name: 'deps', usage: 'sks deps check|install [tmux|codex|context7|all] [--yes]', description: 'Check or guided-install Node/npm PATH, Codex CLI/App, Context7, Browser Use, Computer Use, tmux, and Homebrew on macOS.' },
+  { name: 'bootstrap', usage: 'sks bootstrap [--install-scope global|project] [--local-only] [--json]', description: 'Initialize the current project, install SKS Codex App files/skills, check Context7/Codex App/cmux, and print ready true/false.' },
+  { name: 'deps', usage: 'sks deps check|install [cmux|codex|context7|all] [--yes]', description: 'Check or guided-install Node/npm PATH, Codex CLI/App, Context7, Browser Use, Computer Use, cmux, and Homebrew on macOS.' },
   { name: 'codex-app', usage: 'sks codex-app [check|open]', description: 'Check Codex App install and first-party MCP/plugin readiness, then show app setup files and examples.' },
-  { name: 'tmux', usage: 'sks tmux [check|status] [--session name] [--no-attach]', description: 'Open the SKS tmux runtime with the ㅅㅋㅅ ASCII status pane and Codex CLI.' },
-  { name: 'auto-review', usage: 'sks auto-review status|enable|start [--high] | sks --Auto-review --high', description: 'Enable Codex automatic approval review and launch SKS tmux with the auto-review profile.' },
+  { name: 'cmux', usage: 'sks cmux [check|status] [--workspace name]', description: 'Open the SKS cmux runtime with the ㅅㅋㅅ ASCII status pane and Codex CLI.' },
+  { name: 'mad-high', usage: 'sks --mad --high', description: 'Open a one-shot cmux Codex CLI workspace with the SKS MAD high full-access profile.' },
+  { name: 'auto-review', usage: 'sks auto-review status|enable|start [--high] | sks --Auto-review --high', description: 'Enable Codex automatic approval review and launch SKS cmux with the auto-review profile.' },
   { name: 'dollar-commands', usage: 'sks dollar-commands [--json]', description: 'List Codex App $ commands such as $DFix and $Team.' },
   { name: 'dfix', usage: 'sks dfix', description: 'Explain $DFix ultralight design/content fix mode.' },
   { name: 'qa-loop', usage: 'sks qa-loop prepare|answer|run|status ...', description: 'Dogfood UI/API as human proxy with safety gates, safe fixes, rechecks, Browser/Computer evidence, report.' },

package/src/core/team-live.mjs

@@ -93,7 +93,7 @@ ${prompt}
 
 ## How to Read
 
-- This file is the Codex App-visible replacement for tmux-style team panes.
+- This file is the Codex App-visible replacement for cmux-style team panes.
 - Use at most ${spec.agentSessions} subagent sessions at a time unless the mission is recreated with a different budget.
 - Team mode has three bundles: parallel analysis scouts first, debate team second, then fresh parallel development team.
 - Use relevant TriWiki context before every stage, hydrate low-trust claims from source during the stage, refresh after findings/artifact changes, and validate before handoffs or final claims.

package/src/core/tmux-ui.mjs

@@ -1,167 +0,0 @@
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { exists, packageRoot, projectRoot, runProcess, sha256 } from './fsx.mjs';
-import { getCodexInfo } from './codex-adapter.mjs';
-import { codexAppIntegrationStatus, formatCodexAppStatus } from './codex-app.mjs';
-
-export const SKS_TMUX_LOGO = [
-  '+----------------------+',
-  '|        ㅅㅋㅅ         |',
-  '|        SKS CLI       |',
-  '+----------------------+'
-].join('\n');
-
-export function sanitizeTmuxSessionName(input) {
-  const base = String(input || 'sks').trim().replace(/[^A-Za-z0-9_.-]+/g, '-').replace(/^-+|-+$/g, '');
-  return (base || 'sks').slice(0, 80);
-}
-
-export function defaultTmuxSessionName(root) {
-  const base = sanitizeTmuxSessionName(path.basename(root || process.cwd()) || 'project');
-  const hash = sha256(path.resolve(root || process.cwd())).slice(0, 8);
-  return sanitizeTmuxSessionName(`sks-${base}-${hash}`);
-}
-
-export function shellEscape(value) {
-  return `'${String(value).replace(/'/g, `'\\''`)}'`;
-}
-
-export function platformTmuxInstallHint() {
-  if (process.platform === 'darwin') return 'brew install tmux';
-  if (process.platform === 'win32') return 'Install WSL2 and run: sudo apt install tmux; native Windows may use psmux.';
-  return 'Ubuntu/Debian: sudo apt install tmux; Fedora: sudo dnf install tmux; Arch: sudo pacman -S tmux';
-}
-
-export async function tmuxAvailable() {
-  const out = await runProcess('tmux', ['-V'], { timeoutMs: 5000, maxOutputBytes: 16 * 1024 }).catch(() => null);
-  return { ok: Boolean(out && out.code === 0), version: out ? `${out.stdout}${out.stderr}`.trim() : null };
-}
-
-export async function tmuxHasSession(sessionName) {
-  const out = await runProcess('tmux', ['has-session', '-t', sessionName], { timeoutMs: 5000, maxOutputBytes: 16 * 1024 }).catch((err) => ({ code: 1, stderr: err.message, stdout: '' }));
-  return out.code === 0;
-}
-
-export function tmuxSplashScript(root, codexBin, codexArgs = []) {
-  const logo = SKS_TMUX_LOGO;
-  const extraArgs = Array.isArray(codexArgs) ? codexArgs : [];
-  const lines = [
-    'clear',
-    `printf '%s\\n' ${shellEscape(logo)}`,
-    `printf '\\nProject: %s\\n' ${shellEscape(root)}`,
-    'printf \'Engine:  Codex CLI through SKS guardrails\\n\'',
-    'printf \'Tools:   Prefer Browser Use + Computer Use MCP plugins for QA/UI evidence\\n\'',
-    'printf \'Prompt:  use canonical $ commands only, for example $QA-LOOP\\n\\n\'',
-    'sleep 1',
-    `exec ${[shellEscape(codexBin), ...extraArgs.map(shellEscape), '--cd', shellEscape(root)].join(' ')}`
-  ];
-  return lines.join('; ');
-}
-
-export function tmuxStatusScript(root, sksBin) {
-  return `${shellEscape(process.execPath)} ${shellEscape(sksBin)} tmux status --watch --root ${shellEscape(root)}`;
-}
-
-export async function buildTmuxLaunchPlan(opts = {}) {
-  const root = path.resolve(opts.root || await projectRoot());
-  const session = sanitizeTmuxSessionName(opts.session || defaultTmuxSessionName(root));
-  const sksBin = opts.sksBin || path.join(packageRoot(), 'bin', 'sks.mjs');
-  const codex = opts.codex || await getCodexInfo().catch(() => ({}));
-  const tmux = opts.tmux || await tmuxAvailable();
-  const app = opts.app || await codexAppIntegrationStatus({ codex });
-  const codexArgs = Array.isArray(opts.codexArgs) ? opts.codexArgs : [];
-  return {
-    root,
-    session,
-    sksBin,
-    codex,
-    tmux,
-    app,
-    codexArgs,
-    ready: Boolean(tmux.ok && codex.bin && app.ok),
-    blockers: [
-      ...(!tmux.ok ? [`tmux missing. Install: ${platformTmuxInstallHint()}`] : []),
-      ...(!codex.bin ? ['Codex CLI missing. Install: npm i -g @openai/codex, or set SKS_CODEX_BIN.'] : []),
-      ...(!app.ok ? app.guidance : [])
-    ]
-  };
-}
-
-export function formatTmuxBanner(status = null) {
-  const lines = [
-    SKS_TMUX_LOGO,
-    '',
-    'ㅅㅋㅅ tmux runtime',
-    '',
-    'Canonical prompt commands:',
-    '  $DFix  $Answer  $SKS  $Team  $QA-LOOP  $Ralph  $Research  $AutoResearch  $DB  $GX  $Wiki  $Help',
-    '',
-    'Preferred QA/UI tools:',
-    '  Browser Use -> local browser targets, localhost, file://, current browser tab',
-    '  Computer Use -> desktop apps, screenshots, browser/app interaction evidence',
-    '',
-    'Useful terminal commands:',
-    '  sks commands',
-    '  sks dollar-commands',
-    '  sks codex-app check',
-    '  sks doctor --fix'
-  ];
-  if (status) lines.push('', formatCodexAppStatus(status));
-  return lines.join('\n');
-}
-
-export async function launchTmuxUi(args = [], opts = {}) {
-  const rootArg = readOption(args, '--root', opts.root);
-  const sessionArg = readOption(args, '--session', opts.session);
-  const plan = await buildTmuxLaunchPlan({ ...opts, root: rootArg, session: sessionArg });
-  if (args.includes('--json')) return { plan };
-  if (!plan.ready && !args.includes('--status-only')) {
-    console.log(formatTmuxBanner(plan.app));
-    console.log('\nLaunch blocked:\n');
-    for (const blocker of Array.from(new Set(plan.blockers))) console.log(`- ${blocker}`);
-    process.exitCode = 1;
-    return { plan };
-  }
-  const existing = await tmuxHasSession(plan.session);
-  if (!existing) {
-    const splash = tmuxSplashScript(plan.root, plan.codex.bin, plan.codexArgs);
-    const status = tmuxStatusScript(plan.root, plan.sksBin);
-    const create = spawnSync('tmux', ['new-session', '-d', '-P', '-F', '#{window_id} #{pane_id}', '-s', plan.session, '-n', 'codex', '-c', plan.root, splash], { encoding: 'utf8' });
-    if (create.status !== 0) {
-      process.exitCode = create.status || 1;
-      if (create.stderr) process.stderr.write(create.stderr);
-      return { plan };
-    }
-    const [windowTarget, mainPaneTarget] = String(create.stdout || '').trim().split(/\s+/);
-    const target = windowTarget || `${plan.session}:codex`;
-    spawnSync('tmux', ['split-window', '-h', '-p', '34', '-t', target, '-c', plan.root, status], { stdio: 'ignore' });
-    if (mainPaneTarget) spawnSync('tmux', ['select-pane', '-t', mainPaneTarget], { stdio: 'ignore' });
-    spawnSync('tmux', ['set-option', '-t', plan.session, 'status-left', ' ㅅㅋㅅ #[bold]#S #[default]'], { stdio: 'ignore' });
-    spawnSync('tmux', ['set-option', '-t', plan.session, 'status-right', ' #(date +%H:%M) '], { stdio: 'ignore' });
-  }
-  if (!args.includes('--no-attach')) {
-    const attach = spawnSync('tmux', ['attach-session', '-t', plan.session], { stdio: 'inherit' });
-    process.exitCode = attach.status || 0;
-  } else {
-    console.log(`SKS tmux session ready: ${plan.session}`);
-    console.log(`Attach: tmux attach-session -t ${plan.session}`);
-  }
-  return { plan, existing };
-}
-
-export async function runTmuxStatus(args = [], opts = {}) {
-  const root = path.resolve(readOption(args, '--root', opts.root || await projectRoot()));
-  const once = args.includes('--once') || !args.includes('--watch');
-  do {
-    const app = await codexAppIntegrationStatus();
-    console.clear();
-    console.log(formatTmuxBanner(app));
-    if (once) return app;
-    await new Promise((resolve) => setTimeout(resolve, 5000));
-  } while (true);
-}
-
-function readOption(args, name, fallback = null) {
-  const i = args.indexOf(name);
-  return i >= 0 && args[i + 1] ? args[i + 1] : fallback;
-}