@kaydash9999/banker-plugins 0.20.5 → 0.22.0

package/skills/setup-bypass-permissions/scripts/codex-bypass.mjs

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+/*
+ * setup-bypass-permissions 의 Codex 대상. Claude Code 의 bypassPermissions 에 해당하는 Codex 설정을 켜고 끈다:
+ * `$CODEX_HOME/config.toml` 최상위의 approval_policy = "never", sandbox_mode = "danger-full-access"
+ * (Codex 의 --dangerously-bypass-approvals-and-sandbox 와 같은 조합).
+ *
+ * - 켜기 전 두 키의 값(없으면 없음)을 config.toml.bypass-permissions.json 에 기록하고, 원본 바이트를
+ *   config.toml.bypass-permissions.bak 에 둔다. off 는 기록대로 되돌린다. 기록이 없으면 이 스크립트가 쓰는 값과
+ *   같은 키만 뺀다.
+ * - 조직 정책(/etc/codex/requirements.toml 의 allowed_approval_policies, allowed_sandbox_modes)이 이 값을 허용하지
+ *   않으면 켜지 않는다.
+ *
+ * 사용: node codex-bypass.mjs <on --yes|off|status>
+ * 종료: 0 완료 또는 이미 그 상태, 1 거부(파일은 그대로), 2 예기치 못한 오류, 3 이 계정이 쓸 수 없음(샌드박스 등)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { codexConfigFile, denied, eolOf, findKey, readToml, Refused, removeKey, setKey, tablesSetting, writeToml } from './codex-config.mjs';
+
+const WANT = { approval_policy: '"never"', sandbox_mode: '"danger-full-access"' };
+const KEYS = Object.keys(WANT);
+const POLICY_FILES = ['/etc/codex/requirements.toml', '/etc/codex/managed_config.toml'];
+
+const recordOf = (file) => `${file}.bypass-permissions.json`;
+const backupOf = (file) => `${file}.bypass-permissions.bak`;
+const valueOf = (text, key) => findKey(text, '', key)?.raw ?? null;
+const isOn = (text) => KEYS.every((k) => valueOf(text, k) === WANT[k]);
+
+// 조직 정책이 이 값을 막거나 정책 파일을 읽을 수 없으면 그 이유, 아니면 ''.
+export function policyBlock(files = POLICY_FILES) {
+  for (const f of files) {
+    let text = '';
+    try {
+      text = fs.readFileSync(f, 'utf8');
+    } catch (e) {
+      if (e.code === 'ENOENT') continue;
+      return `조직 정책 파일을 읽을 수 없음(${e.code}): ${f}`;
+    }
+    for (const [key, want] of [['allowed_approval_policies', 'never'], ['allowed_sandbox_modes', 'danger-full-access']]) {
+      const hit = findKey(text, '', key);
+      if (hit && !new RegExp(`["']${want}["']`).test(hit.raw)) return `${f} 의 ${key} 가 ${want} 를 허용하지 않음`;
+    }
+    // 옛 managed_config.toml 은 값 자체를 덮어쓴다. 다른 값이면 사용자 설정이 적용되지 않는다.
+    for (const k of KEYS) {
+      const forced = findKey(text, '', k)?.raw;
+      if (forced && forced.replace(/'/g, '"') !== WANT[k]) return `${f} 가 ${k} 를 ${forced} 로 정함`;
+    }
+  }
+  return '';
+}
+
+// 최상위 profile 이 고른 기본 프로필이 두 키를 따로 정하면 그 값이 이긴다. 그 프로필 이름, 없으면 ''.
+export function overridingProfile(text) {
+  const raw = findKey(text, '', 'profile')?.raw ?? '';
+  const m = /^"([^"]+)"$|^'([^']+)'$/.exec(raw);
+  if (!m) return '';
+  const name = m[1] ?? m[2];
+  const table = `profiles."${name}"`;
+  // [profiles.<이름>] 표의 키, 또는 최상위의 점 키 profiles.<이름>.<키>.
+  const sets = KEYS.some((k) => findKey(text, table, k) || findKey(text, '', `${table}.${k}`));
+  return sets ? `profiles.${name}` : '';
+}
+
+export function turnOn({ file = codexConfigFile(), policies = POLICY_FILES } = {}) {
+  const why = policyBlock(policies);
+  if (why) return { code: 1, msg: `켜지 않음: ${why}` };
+  const { text, mode, exists } = readToml(file);
+  const prof = overridingProfile(text);
+  if (prof) return { code: 1, msg: `켜지 않음: 기본 프로필 ${prof} 가 approval_policy 나 sandbox_mode 를 정해 최상위 값이 적용되지 않음. 그 프로필의 값을 직접 바꾸십시오` };
+  if (isOn(text)) return { code: 0, msg: '이미 켜져 있음' };
+  const before = Object.fromEntries(KEYS.map((k) => [k, valueOf(text, k)]));
+  let next = text;
+  for (const k of KEYS) next = setKey(next, '', k, WANT[k]);
+  if (!fs.existsSync(path.dirname(file))) return { code: 1, msg: `Codex 설정 폴더가 없음: ${path.dirname(file)}` };
+  // 켜져 있지 않은 상태에서 켜므로 지금 값이 되돌릴 값이다. 예전 기록이 남아 있어도(켬, 손으로 바꿈, 다시 켬) 지금 값으로 바꾼다.
+  // 설정을 먼저 쓰고 기록을 쓴다. 설정 쓰기가 실패하면 앞선 기록이 그대로 남는다.
+  const nl = eolOf(text);
+  writeToml(file, next.endsWith(nl) || !next ? next : `${next}${nl}`, { mode, backup: exists ? backupOf(file) : null });
+  writeToml(recordOf(file), `${JSON.stringify({ before, existed: exists })}\n`);
+  return { code: 0, msg: '켬: approval_policy = "never", sandbox_mode = "danger-full-access"' };
+}
+
+export function turnOff({ file = codexConfigFile() } = {}) {
+  const { text, mode, exists } = readToml(file);
+  let record = null;
+  try { record = JSON.parse(fs.readFileSync(recordOf(file), 'utf8')); } catch { /* 기록 없음 */ }
+  let next = text;
+  // 기록이 없으면 두 키가 모두 이 스크립트의 값일 때만 뺀다. 사용자가 스스로 둔 approval_policy = "never" 하나는 남긴다.
+  const ours = record || isOn(text);
+  for (const k of KEYS) {
+    const was = record?.before?.[k];
+    if (typeof was === 'string') next = setKey(next, '', k, was);
+    else if (ours) next = removeKey(next, '', k);
+  }
+  if (next !== text && exists) writeToml(file, next, { mode });
+  fs.rmSync(recordOf(file), { force: true });
+  return { code: 0, msg: next === text ? '이미 꺼져 있음' : record ? '끔: 켜기 전 값으로 되돌림' : '끔: 이 스크립트가 쓰는 두 값의 키를 뺌' };
+}
+
+export function status({ file = codexConfigFile(), policies = POLICY_FILES } = {}) {
+  const { text } = readToml(file);
+  const out = [`${isOn(text) ? '켜짐' : '꺼짐'}: approval_policy = ${valueOf(text, 'approval_policy') ?? '(없음)'}, sandbox_mode = ${valueOf(text, 'sandbox_mode') ?? '(없음)'}`];
+  const prof = overridingProfile(text);
+  if (prof) out.push(`기본 프로필 ${prof} 가 값을 정해 최상위 값이 적용되지 않음`);
+  const profiles = [...new Set(KEYS.flatMap((k) => tablesSetting(text, 'profiles', k)))];
+  if (profiles.length) out.push(`프로필이 따로 정함(그 프로필로 시작하면 그 값): ${profiles.join(', ')}`);
+  const why = policyBlock(policies);
+  if (why) out.push(`조직 정책: ${why}`);
+  if (fs.existsSync(recordOf(file))) out.push(`되돌리기 기록: ${recordOf(file)}`);
+  return { code: 0, msg: out.join('\n') };
+}
+
+function run(argv) {
+  const [cmd] = argv;
+  if (cmd === 'on' && !argv.includes('--yes')) return { code: 1, msg: '켜기는 확인을 받은 뒤 --yes 와 함께 실행' };
+  if (cmd === 'on') return turnOn();
+  if (cmd === 'off') return turnOff();
+  return status();
+}
+
+function main(argv) {
+  let r;
+  try {
+    r = run(argv);
+  } catch (e) {
+    r = e instanceof Refused ? { code: 1, msg: `거부: ${e.message}` } : denied(e) ? { code: 3, msg: `쓸 수 없음(${e.code}): ${e.path ?? ''}${e.code === 'EPERM' && process.platform === 'win32' ? '. 다른 프로그램(Codex, 편집기)이 파일을 잡고 있을 수 있음' : ''}` } : { code: 2, msg: `오류: ${e.message}` };
+  }
+  console.log(`${r.msg}\n설정 파일: ${codexConfigFile()}`);
+  return r.code;
+}
+
+const same = (a, b) => { try { return fs.realpathSync(a) === fs.realpathSync(b); } catch { return false; } };
+if (process.argv[1] && same(fileURLToPath(import.meta.url), path.resolve(process.argv[1]))) process.exitCode = main(process.argv.slice(2));

package/skills/setup-bypass-permissions/scripts/codex-config.mjs

@@ -0,0 +1,210 @@
+/*
+ * Codex 의 config.toml 을 줄 단위로 읽고 고치는 공통 모듈. setup-bypass-permissions 가 정본이고 setup-omc-hud 의
+ * assets/ 에 같은 사본을 둔다(scripts/sync-adapter.js 가 지킴).
+ *
+ * TOML 전체를 다시 쓰지 않는다. 바꾸는 키의 줄만 고쳐 주석, 순서, 다른 표는 그대로 둔다.
+ * - 줄을 훑으며 문자열(한 줄, 여러 줄)과 괄호 깊이를 따라가, 여러 줄 문자열이나 배열 안의 줄을 표 머리나 키로 보지 않는다.
+ * - 키 이름은 따옴표를 벗겨 비교한다(`"approval_policy"` 도 approval_policy). 값 끝의 주석은 값으로 보지 않는다.
+ * - 최상위가 표를 점 키나 인라인 표로 정했는지(definedInline) 알려, 그런 파일에 같은 표를 더하지 않게 한다.
+ * - 파일이 링크이거나 일반 파일이 아니면 고치지 않는다. 쓰기 전 원본을 백업(이 계정만 읽음)하고, 새 파일에 쓴 뒤
+ *   바꿔 넣으며 파일 모드를 지킨다.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+// Codex 처럼 상대 경로 CODEX_HOME 은 지금 폴더 기준으로 푼다.
+export function codexConfigFile(env = process.env) {
+  const home = env.CODEX_HOME ? path.resolve(env.CODEX_HOME) : path.join(os.homedir(), '.codex');
+  return path.join(home, 'config.toml');
+}
+
+export class Refused extends Error {}
+
+// { text, mode, exists }. 없으면 빈 글. 링크나 일반 파일이 아니면 Refused.
+export function readToml(file) {
+  let st;
+  try {
+    st = fs.lstatSync(file);
+  } catch (e) {
+    if (e.code === 'ENOENT') return { text: '', mode: null, exists: false };
+    throw e;
+  }
+  if (!st.isFile()) throw new Refused(`${file} 이 일반 파일이 아님(링크이거나 다른 종류)`);
+  return { text: fs.readFileSync(file, 'utf8'), mode: st.mode & 0o7777, exists: true };
+}
+
+// 원본을 backup 에 복사한 뒤(원본이 있을 때) 새 파일에 써서 바꿔 넣는다.
+export function writeToml(file, text, { mode = null, backup = null } = {}) {
+  if (backup && fs.existsSync(file)) {
+    fs.copyFileSync(file, backup);
+    fs.chmodSync(backup, 0o600); // 원본에 비밀 값이 있을 수 있다
+  }
+  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+  try {
+    fs.writeFileSync(tmp, text, { flag: 'wx', mode: mode ?? 0o600 });
+    if (mode !== null) fs.chmodSync(tmp, mode);
+    fs.renameSync(tmp, file);
+  } catch (e) {
+    fs.rmSync(tmp, { force: true });
+    throw e;
+  }
+}
+
+const lines = (text) => text.split(/\r?\n/);
+const eol = (text) => (text.includes('\r\n') ? '\r\n' : '\n');
+// 파일이 쓰는 줄바꿈(CRLF 가 하나라도 있으면 CRLF).
+export const eolOf = eol;
+const TRIPLE = ['"""', "'''"];
+
+// 키나 표 이름을 낱말 배열로. 따옴표 안의 점은 나누지 않는다(`profiles."a.b"` 는 ['profiles', 'a.b']).
+export const nameParts = (s) => (s.match(/"[^"]*"|'[^']*'|[^.\s]+/g) ?? []).map((p) => p.replace(/^"(.*)"$|^'(.*)'$/, '$1$2'));
+// 비교용 이름. 낱말 사이를 \u0000 으로 이어, 점이 든 낱말과 점으로 나뉜 낱말을 구분한다.
+const plainName = (s) => nameParts(s).join('\u0000');
+
+// 한 줄을 문자열 밖에서 훑는다. { d: 괄호 깊이 변화, multi: 줄 끝에 열려 있는 여러 줄 문자열 구분자, cut: 주석 시작 위치 }.
+function scanLine(s, multi = '') {
+  let d = 0;
+  for (let i = 0; i < s.length; i++) {
+    if (multi) {
+      if (s.startsWith(multi, i)) { i += 2; multi = ''; } else if (multi === TRIPLE[0] && s[i] === '\\') i++;
+      continue;
+    }
+    const c = s[i];
+    if (TRIPLE.some((t) => s.startsWith(t, i))) { multi = s.slice(i, i + 3); i += 2; }
+    else if (c === '"') { for (i++; i < s.length && s[i] !== '"'; i++) if (s[i] === '\\') i++; }
+    else if (c === "'") { const k = s.indexOf("'", i + 1); i = k < 0 ? s.length : k; }
+    else if (c === '#') return { d, multi, cut: i };
+    else if (c === '[' || c === '{') d++;
+    else if (c === ']' || c === '}') d--;
+  }
+  return { d, multi, cut: s.length };
+}
+
+// 표 머리. 이름 안의 따옴표 친 낱말에는 ] 가 들어갈 수 있다(`[projects."/a]b"]`).
+// 이름 부분은 탐욕 한 번으로 읽는다(겹치는 공백 패턴은 긴 줄에서 역추적이 폭증한다). 앞뒤 공백은 nameParts 가 지운다.
+const HEADER_RE = /^\s*\[\[?((?:"[^"]*"|'[^']*'|[^\]"'])+)\]\]?\s*(#.*)?$/;
+const KEY_RE = /^\s*((?:"[^"]*"|'[^']*'|[A-Za-z0-9_-]+)(?:\s*\.\s*(?:"[^"]*"|'[^']*'|[A-Za-z0-9_-]+))*)\s*=(.*)$/;
+
+// 줄마다 { kind: 'header'|'key'|'inside'|'other', name, end }. header 의 name 은 표 이름, key 의 name 은 키 이름이고
+// end 는 값이 끝나는 줄 다음. 여러 줄 문자열이나 배열 안의 줄은 inside.
+export function scan(text) {
+  const ls = lines(text);
+  const out = ls.map(() => ({ kind: 'other' }));
+  for (let i = 0; i < ls.length; i++) {
+    const header = HEADER_RE.exec(ls[i]);
+    if (header) { out[i] = { kind: 'header', name: plainName(header[1]) }; continue; }
+    const key = KEY_RE.exec(ls[i]);
+    if (!key) continue;
+    let { d, multi } = scanLine(key[2]);
+    let j = i + 1;
+    for (; (d > 0 || multi) && j < ls.length; j++) {
+      out[j] = { kind: 'inside' };
+      const r = scanLine(ls[j], multi);
+      d += r.d;
+      multi = r.multi;
+    }
+    out[i] = { kind: 'key', name: plainName(key[1]), end: j };
+    i = j - 1;
+  }
+  return out;
+}
+
+// 표의 줄 범위 [from, to). table '' 은 최상위. 표가 없으면 null.
+function tableRange(info, table) {
+  table = table.includes('\u0000') || !table ? table : plainName(table);
+  let from = table ? -1 : 0;
+  for (let i = 0; i < info.length; i++) {
+    if (info[i].kind !== 'header') continue;
+    if (from >= 0) return [from, i];
+    if (info[i].name === table) from = i + 1;
+  }
+  return from >= 0 ? [from, info.length] : null;
+}
+
+function keysOf(text, table) {
+  const info = scan(text);
+  const range = tableRange(info, table);
+  if (!range) return [];
+  const keys = [];
+  for (let i = range[0]; i < range[1]; i++) if (info[i].kind === 'key') keys.push({ at: i, end: info[i].end, name: info[i].name });
+  return keys;
+}
+
+// 키의 { at, end, raw }. raw 는 값 끝의 주석을 뺀 글. 없으면 null.
+export function findKey(text, table, key) {
+  const want = nameParts(key).join('\u0000');
+  const hit = keysOf(text, plainName(table)).find((k) => k.name === want);
+  if (!hit) return null;
+  const ls = lines(text).slice(hit.at, hit.end);
+  const parts = [ls[0].slice(ls[0].indexOf('=') + 1), ...ls.slice(1)];
+  let multi = '';
+  for (const part of parts.slice(0, -1)) multi = scanLine(part, multi).multi;
+  const last = parts.length - 1;
+  parts[last] = parts[last].slice(0, scanLine(parts[last], multi).cut); // 마지막 줄의 주석을 뗀다
+  const raw = parts.join('\n');
+  return { at: hit.at, end: hit.end, raw: raw.trim() };
+}
+
+// 최상위가 이 표를 점 키나 인라인 표로 정했는지(`tui.x = 1`, `tui = { ... }`). 그런 파일에 [표] 를 더하면 키가 겹쳐
+// Codex 가 설정을 읽지 못한다.
+export function definedInline(text, table) {
+  const t = plainName(table);
+  return keysOf(text, '').some((k) => k.name === t || k.name.startsWith(`${t}\u0000`));
+}
+
+// 키를 rawValue 로 둔다. 있으면 그 줄을 바꾸고, 없으면 표 끝(최상위는 첫 표 머리 앞)에 넣는다. 표가 없으면 끝에 만든다.
+// comment 가 있으면 키 바로 위에 그 주석 줄을 둔다.
+export function setKey(text, table, key, rawValue, comment = '') {
+  const ls = lines(text);
+  const nl = eol(text);
+  const line = [...(comment ? [comment] : []), `${key} = ${rawValue}`];
+  const hit = findKey(text, table, key);
+  if (hit) {
+    const above = comment && ls[hit.at - 1] === comment ? 1 : 0;
+    ls.splice(hit.at - above, hit.end - hit.at + above, ...line);
+    return ls.join(nl);
+  }
+  const range = tableRange(scan(text), table);
+  if (!range) {
+    while (ls.length && ls[ls.length - 1] === '') ls.pop();
+    return [...ls, ...(ls.length ? [''] : []), `[${table}]`, ...line, ''].join(nl);
+  }
+  // 다음 표 머리에 붙은 주석(`# MCP servers` 처럼 머리 바로 위의 주석 줄)과 그 앞 빈 줄은 건너뛰고 넣는다.
+  let at = range[1];
+  if (range[1] < ls.length) while (at > range[0] && ls[at - 1].trim().startsWith('#')) at--;
+  while (at > range[0] && ls[at - 1].trim() === '') at--;
+  ls.splice(at, 0, ...line);
+  return ls.join(nl);
+}
+
+// 키를 뺀다. comment 와 같은 주석 줄이 바로 위에 있으면 그것도 뺀다.
+export function removeKey(text, table, key, comment = '') {
+  const hit = findKey(text, table, key);
+  if (!hit) return text;
+  const ls = lines(text);
+  const above = comment && ls[hit.at - 1] === comment ? 1 : 0;
+  ls.splice(hit.at - above, hit.end - hit.at + above);
+  return ls.join(eol(text));
+}
+
+// 표에 키도 주석도 없으면 그 머리와 뒤의 빈 줄을 뺀다.
+export function dropEmptyTable(text, table) {
+  const info = scan(text);
+  const range = tableRange(info, table);
+  if (!range) return text;
+  const ls = lines(text);
+  if (ls.slice(range[0], range[1]).some((l) => l.trim())) return text;
+  ls.splice(range[0] - 1, range[1] - range[0] + 1);
+  return ls.join(eol(text));
+}
+
+// 이름이 prefix 로 시작하는 표들 중 key 를 정한 표 이름(예: profiles.* 의 approval_policy).
+export function tablesSetting(text, prefix, key) {
+  const p = plainName(prefix);
+  const names = scan(text).filter((x) => x.kind === 'header' && x.name.startsWith(`${p}\u0000`)).map((x) => x.name);
+  return [...new Set(names)].filter((n) => findKey(text, n, key)).map((n) => n.split('\u0000').join('.'));
+}
+
+// 쓰기 실패가 이 계정의 권한(샌드박스, 읽기 전용, 다른 소유자) 때문인지.
+export const denied = (e) => ['EACCES', 'EPERM', 'EROFS'].includes(e?.code);

package/skills/setup-bypass-permissions/scripts/fallback/bypass-permissions.py

@@ -21,6 +21,7 @@ Exit status: 0 done, or nothing to do. 1 refused. 2 unexpected error. 3 this acc
 the file or its folder. Every result ends with the line `settings file: <path>` on stdout.
 Python 3.6 or later.
 """
+
 import errno
 import json
 import os
@@ -43,7 +44,9 @@ def settings_path():
 
 def policy_home():
     # The override exists for this skill's tests alone.
-    if os.environ.get("BANKER_BYPASS_TEST") == "1" and os.environ.get("BANKER_BYPASS_POLICY_HOME"):
+    if os.environ.get("BANKER_BYPASS_TEST") == "1" and os.environ.get(
+        "BANKER_BYPASS_POLICY_HOME"
+    ):
         return os.environ["BANKER_BYPASS_POLICY_HOME"]
     return POLICY_HOMES.get(sys.platform, "/etc/claude-code")
 
@@ -59,7 +62,11 @@ ABSENT = (errno.ENOENT, errno.ENOTDIR, errno.EISDIR)
 
 
 def unreadable_policy(path):
-    return Refused("this machine's managed policy cannot be read (" + path + "); ask the administrator whether it allows the mode")
+    return Refused(
+        "this machine's managed policy cannot be read ("
+        + path
+        + "); ask the administrator whether it allows the mode"
+    )
 
 
 def policy_files():
@@ -73,7 +80,12 @@ def policy_files():
         if e.errno not in ABSENT:
             raise unreadable_policy(drop)
         names = []
-    files += [os.path.join(drop, n) for n in sorted(n for n in names if n.endswith(".json") and not n.startswith("."))]
+    files += [
+        os.path.join(drop, n)
+        for n in sorted(
+            n for n in names if n.endswith(".json") and not n.startswith(".")
+        )
+    ]
     return files
 
 
@@ -108,6 +120,7 @@ def load(path):
         raise Refused("settings.json is not valid UTF-8")
     if not text.strip():
         return {}, raw
+
     def reject(token):
         raise ValueError("the constant " + token + " is not JSON")
 
@@ -134,7 +147,9 @@ def replace(path, data, mode):
         except OSError as e:
             if e.errno not in (errno.EBUSY, errno.EXDEV):
                 raise
-            with open(path, "wb") as target:  # a bind-mounted single file refuses the rename: write in place
+            with open(
+                path, "wb"
+            ) as target:  # a bind-mounted single file refuses the rename: write in place
                 target.write(data)
             os.remove(tmp)
     except BaseException:
@@ -148,21 +163,34 @@ def save(path, data, raw):
     real = os.path.realpath(path)
     mode = os.stat(real).st_mode & 0o777 if os.path.exists(real) else 0o600
     bom = BOM if raw is not None and raw.startswith(BOM) else b""
-    replace(real, bom + (json.dumps(data, indent=2, ensure_ascii=False) + "\n").encode("utf-8"), mode)
+    replace(
+        real,
+        bom + (json.dumps(data, indent=2, ensure_ascii=False) + "\n").encode("utf-8"),
+        mode,
+    )
 
 
 def check_on(path, data):
     # Claude Code lets root use the mode inside a sandbox it recognises: IS_SANDBOX exactly "1", or
     # CLAUDE_CODE_BUBBLEWRAP set to a true value (2.1.289 reads 1, true, yes, on; 0 or false is not one).
-    bubblewrap = os.environ.get("CLAUDE_CODE_BUBBLEWRAP", "").strip().lower() in ("1", "true", "yes", "on")
+    bubblewrap = os.environ.get("CLAUDE_CODE_BUBBLEWRAP", "").strip().lower() in (
+        "1",
+        "true",
+        "yes",
+        "on",
+    )
     sandboxed = os.environ.get("IS_SANDBOX") == "1" or bubblewrap
     if hasattr(os, "geteuid") and os.geteuid() == 0 and not sandboxed:
-        raise Refused("Claude Code will not start in bypassPermissions as root; IS_SANDBOX=1 marks a real sandbox")
+        raise Refused(
+            "Claude Code will not start in bypassPermissions as root; IS_SANDBOX=1 marks a real sandbox"
+        )
     blocked = policy_block()
     if blocked:
         raise Refused("managed policy forbids bypassPermissions: " + blocked)
     if forbids(data):
-        raise Refused("settings.json itself sets permissions.disableBypassPermissionsMode")
+        raise Refused(
+            "settings.json itself sets permissions.disableBypassPermissionsMode"
+        )
 
 
 def forget_record(path):
@@ -176,7 +204,9 @@ def forget_record(path):
 
 def turn_on(path):
     if not os.path.isdir(os.path.dirname(path)):
-        raise Refused("there is no Claude Code config folder at " + os.path.dirname(path))
+        raise Refused(
+            "there is no Claude Code config folder at " + os.path.dirname(path)
+        )
     data, raw = load(path)
     check_on(path, data)
     if data.get("permissions", {}).get("defaultMode") == MODE:
@@ -197,13 +227,21 @@ def turn_off(path):
     data, raw = load(path)
     current = data.get("permissions", {}).get("defaultMode")
     if current != MODE:
-        print("defaultMode = " + str(current) + " (not bypassPermissions, nothing changed)")
+        print(
+            "defaultMode = "
+            + str(current)
+            + " (not bypassPermissions, nothing changed)"
+        )
         return 0
-    if not os.access(path, os.W_OK):  # a read-only settings file is a lock: off honours it as on does
+    if not os.access(
+        path, os.W_OK
+    ):  # a read-only settings file is a lock: off honours it as on does
         raise PermissionError(errno.EACCES, "this account may not write", path)
     del data["permissions"]["defaultMode"]
     save(path, data, raw)
-    forget_record(path)  # only after the write: if it failed, the record is still the way back
+    forget_record(
+        path
+    )  # only after the write: if it failed, the record is still the way back
     print("defaultMode removed (Claude Code's default start mode)")
     return 0
 
@@ -212,7 +250,10 @@ def outcome(argv, path):
     actions = {("on", "--yes"): turn_on, ("off",): turn_off}
     action = actions.get(tuple(argv[1:]))
     if action is None:
-        print("refused: usage is `bypass-permissions.py on --yes` or `bypass-permissions.py off`", file=sys.stderr)
+        print(
+            "refused: usage is `bypass-permissions.py on --yes` or `bypass-permissions.py off`",
+            file=sys.stderr,
+        )
         return 1
     try:
         return action(path)
@@ -221,12 +262,22 @@ def outcome(argv, path):
         return 1
     except OSError as e:
         if e.errno in (errno.EACCES, errno.EPERM, errno.EROFS):
-            print("write blocked: " + str(e) + "; settings.json left as it was", file=sys.stderr)
+            print(
+                "write blocked: " + str(e) + "; settings.json left as it was",
+                file=sys.stderr,
+            )
             return 3
         print("unexpected error: " + str(e) + "; check settings.json", file=sys.stderr)
         return 2
     except Exception as e:  # anything else stopped it partway too
-        print("unexpected error: " + type(e).__name__ + ": " + str(e) + "; check settings.json", file=sys.stderr)
+        print(
+            "unexpected error: "
+            + type(e).__name__
+            + ": "
+            + str(e)
+            + "; check settings.json",
+            file=sys.stderr,
+        )
         return 2
 
 

package/skills/setup-omc-hud/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: setup-omc-hud
-description: "Claude Code 상태표시줄 omc_hud 래퍼를 스킬에 든 파일로 설치. 내려받지 않고 오프라인에서 모든 OS 같은 명령으로 동작하며, PL 칸에 쓰는 payload-mon 모듈도 켬. Codex 는 OMX 의 `hud` 스킬을 씀. 'setup-omc-hud'/'omc_hud 설치'/'상태표시줄 설치' 또는 `/banker:setup` 시 사용."
+description: "Claude Code 상태표시줄 omc_hud 래퍼를 스킬에 든 파일로 설치. 내려받지 않고 오프라인에서 모든 OS 같은 명령으로 동작하며, PL 칸에 쓰는 payload-mon 모듈도 켬. Codex 는 TUI 상태표시줄(`[tui] status_line`)을 OMX 프리셋으로 켜고 끔. 'setup-omc-hud'/'omc_hud 설치'/'상태표시줄 설치' 또는 `/banker:setup` 시 사용."
 argument-hint: "[off|status]"
 ---
 
@@ -12,9 +12,39 @@ argument-hint: "[off|status]"
 - Windows, Linux, macOS 모두 `node` 명령 하나로 같은 절차를 밟는다.
 - 설치 파일: `apply-hud.mjs`(설치 스크립트), `omc-hud-custom.mjs`(래퍼 v4), `hud-config.json`(HUD 설정), `LICENSE-omc_hud`(원본 omc_hud 의 MIT 라이선스)
 
-**런타임:** Claude Code 상태표시줄(`<설정 폴더>/settings.json` 의 `statusLine`)이 대상이다. Codex 런타임에서는 oh-my-codex(OMX)가 자체 `hud` 스킬을 주므로 이 스킬 대신 OMX 의 `hud` 를 쓴다.
+**런타임:** Claude Code 상태표시줄(`<설정 폴더>/settings.json` 의 `statusLine`)이 대상이다.
+Codex 에서 실행했고 요청이 대상을 말하지 않으면, 설치 전에 어느 쪽인지 묻는다(질문 도구가 없으면 번호 선택지를 평문으로). 인자가 `off`, `status` 여도 같다.
 
-**인자가 `off` 또는 `status` 일 때:** 0~3단계를 건너뛰고 "인자 off, status" 절만 실행한다.
+| 대상 | 할 일 |
+|---|---|
+| Codex 자신의 상태표시줄 | 아래 "Codex 상태표시줄" 절을 한다 |
+| 같은 머신의 Claude Code 상태표시줄 | 아래 0~3단계를 그대로 한다 |
+
+- 물을 수 없는 실행(`codex exec` 등)이고 대상이 없으면 아무것도 설치하지 않고 두 선택지를 알린다. 시험한 두 모델이 대상 없는 요청에 서로 다른 쪽을 설치했다.
+- Claude Code 쪽 설치는 `~/.claude` 에 쓴다. Codex 의 `workspace-write` 샌드박스가 이 쓰기를 막으므로, `apply-hud.mjs` 와 `payload-mon on` 은 샌드박스 밖 실행으로 승인을 요청해 돌린다. 승인한 실행은 Codex 0.144.5 에서 확인했다. 승인을 요청할 수 없거나(승인 정책 `never`) 거부되면, 같은 명령을 Codex 입력창에서 `!` 를 붙여 사용자가 직접 실행하게 안내한다(예: `!node "<이 스킬 디렉터리 절대경로>/assets/apply-hud.mjs"`). 사용자가 친 `!` 명령은 샌드박스 밖에서 돈다(Codex 0.144.5, `-a never` 에서 실측). `codex exec` 처럼 사람이 없는 실행이면 그 명령을 보고하고 멈춘다. `--add-dir ~/.claude` 처럼 설정 폴더를 통째로 여는 방법은 쓰지 않는다. 그 세션이 훅과 설정을 고칠 수 있게 되어 샌드박스가 무력해진다.
+- OMX 의 `omx hud --tmux` 는 지금 tmux 창을 나눠 HUD 칸을 새로 띄운다. 사용자가 그 칸을 원한다고 했을 때만 실행한다.
+
+**인자가 `off` 또는 `status` 일 때:** 대상이 Claude Code 면 0~3단계를 건너뛰고 "인자 off, status" 절만 실행한다. 대상이 Codex 면 아래 "Codex 상태표시줄" 절의 `off`, `status` 만 실행하고 그 밖의 절(`claude-update-last` 포함)은 하지 않는다.
+
+### Codex 상태표시줄
+
+Codex TUI 의 상태표시줄은 `$CODEX_HOME/config.toml`(기본 `~/.codex/config.toml`)의 `[tui]` `status_line` 이다. OMX 는 `omx setup` 에서 이 줄을 `# omx:managed-status-line` 표시와 함께 관리한다.
+
+```bash
+node "<이 스킬 디렉터리 절대경로>/assets/codex-status-line.mjs" on [--preset focused|minimal]
+node "<이 스킬 디렉터리 절대경로>/assets/codex-status-line.mjs" off
+node "<이 스킬 디렉터리 절대경로>/assets/codex-status-line.mjs" status
+```
+
+- `on` 은 `status_line` 이 없을 때만 OMX 프리셋 항목(기본 `focused`: 모델과 추론 강도, git 브랜치, 남은 컨텍스트, 입력과 출력 토큰, 5시간과 주간 한도)으로 넣고 `# banker:status-line` 표시를 붙인다. OMX 나 사용자가 둔 줄은 바꾸지 않고 누가 둔 것인지 알린다.
+- `off` 는 banker 표시가 붙은 줄만 뺀다. 쓰기 전 원본은 `config.toml.banker-hud.bak` 에 있다.
+- 종료 코드: 0 완료 또는 이미 그 상태, 1 거부(설정 파일이 링크이거나 일반 파일이 아님, 설정 폴더 없음, 모르는 프리셋), 2 예기치 못한 오류, 3 이 계정이 쓸 수 없음.
+- `~/.codex` 쓰기라 Codex 의 `workspace-write` 샌드박스에서는 종료 3 이 된다. 그 명령만 샌드박스 밖 실행 승인을 요청한다. 승인을 요청할 수 없거나 거부되면 사용자가 입력창에서 `!` 를 붙여 직접 실행하게 안내한다. `--add-dir ~/.codex` 는 쓰지 않는다.
+- 결과를 보고하고 Codex 를 다시 열어야 보인다고 알린다. 이 경로에서는 위 0~3단계를 하지 않는다.
+- OMX 의 별도 HUD 칸(`omx hud --tmux`)은 지금 tmux 창을 나눈다. 사용자가 그 칸을 원한다고 했을 때만 실행한다.
+- `omx setup` 은 `[tui]` 를 다시 쓰며 주석을 버릴 수 있다. 그러면 banker 표시가 사라져 그 줄은 사용자의 줄로 보이고, `off` 는 건드리지 않는다. `omx setup --force` 는 OMX 프리셋으로 바꿔 넣는다. 둘 다 설정은 깨지지 않는다.
+- Codex 의 `/statusline` 으로 항목을 바꾸면, 표시가 사라졌거나 값이 프리셋과 다를 때 `off` 는 그 줄을 사용자의 것으로 보고 남긴다.
+- `off` 뒤 `[tui]` 표에 키도 주석도 남지 않으면 그 머리도 뺀다.
 
 ## 표시 형식