@rch4com/agent-setup 1.12.0 → 1.15.0

package/install.mjs

@@ -70,7 +70,20 @@ async function runClassic(root, { dryRun, listOnly, setArg, t }) {
   for (const id of selectedIds) if (!known.has(id)) throw new LocalizedError('error.unknownItem', { id })
   assertExclusive(items, selectedIds)
 
-  const changes = planChanges(states, selectedIds)
+  // 전역(scope: 'user') 항목은 --set 생략만으로 지우지 않는다. --set은 "저장소가
+  // 가질 상태"의 선언이라 목록 밖 항목을 제거하는데, 전역 항목까지 그 규칙에
+  // 태우면 무관한 --set 실행 하나가 머신 전체 설치를 걷어 간다 — 스크래치
+  // 저장소에서 스킬 둘을 --set 하다가 copilot의 전역 superpowers가 함께
+  // 제거되는 것을 실측했다(2026-08-15). 전역 항목의 제거는 TUI에서 명시적으로
+  // 해제해 검토 화면을 거친다.
+  const changes = []
+  for (const c of planChanges(states, selectedIds)) {
+    if (c.action === 'uninstall' && c.item.scope === 'user') {
+      console.log(t('run.keepUserScope', { id: c.item.id }))
+      continue
+    }
+    changes.push(c)
+  }
   if (changes.length === 0) { console.log(t('apply.noChanges')); return }
 
   // 비대화형 경로다 — 바를 그리지 않고 평문 한 줄씩 흘린다.

package/lib/global-plugin.mjs

@@ -0,0 +1,207 @@
+// 사용자 전역(scope: 'user') 플러그인 항목의 공통 기구. 상류가 하니스별 전역
+// 설치만 지원하는 도구(superpowers, ponytail)가 공유한다 — 항목 파일
+// (lib/items/global.*.mjs)은 상류별 좌표와 미배선 사유만 든다.
+//
+// 전역 파일을 만지므로 repoPath 계열 가드를 일부러 안 쓴다 — 저장소 이탈이
+// 목적인 기구다. 항목 파일에 두지 않는 이유는 gitmessage.mjs와 같다:
+// loadItems가 items/의 모든 .mjs를 항목으로 읽는다.
+//
+// 하니스별 기록 위치(2026-08-15 실측, 상세는 global.superpowers.mjs):
+//   codex    $CODEX_HOME/config.toml의 [plugins."<이름>@…"] — CODEX_HOME
+//            재지정을 실제로 쓰는 환경(Orca)이 있어 환경변수를 따라간다.
+//   copilot  ~/.copilot/config.json의 installedPlugins[] (주석 있는 JSONC).
+//   gemini   ~/.gemini/extensions/<이름>/ (공식 extensions 문서).
+//   opencode 전역 opencode.json의 plugin 배열 (XDG_CONFIG_HOME 존중).
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { delimiter, join } from 'node:path'
+import { parse as parseToml } from 'smol-toml'
+import { CLIS } from './clis.mjs'
+import { readJson, setKey, removeKey } from './jsonfile.mjs'
+import { msg, LocalizedError } from './i18n/index.mjs'
+
+// 실행은 cmd 셸을 거치므로(catalog.mjs makeExec) win32에서는 PATHEXT 확장자가
+// 있어야 실제로 부를 수 있다 — copilot.ps1만 있는 PATH는 "없음"이 맞다.
+function defaultHasBinary(name, env = process.env) {
+  const dirs = (env.PATH ?? '').split(delimiter).filter(Boolean)
+  const exts = process.platform === 'win32'
+    ? (env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
+    : ['']
+  return dirs.some((dir) => exts.some((ext) => existsSync(join(dir, name + ext))))
+}
+
+// superpowers@openai-curated처럼 다른 마켓플레이스로 설치된 판도 잡아야
+// 하므로(실측: 이런 머신이 실제로 있다) 이름이 아니라 접두사로 고른다.
+// 제거도 여기서 찾은 id를 그대로 쓴다 — 감지가 "있다"고 말한 판을 지워야
+// 상태가 맞아떨어진다.
+function codexPluginIds(file, pluginName) {
+  if (!existsSync(file)) return []
+  try {
+    const data = parseToml(readFileSync(file, 'utf8'))
+    return Object.keys(data.plugins ?? {}).filter((id) => id.startsWith(`${pluginName}@`))
+  } catch {
+    // 깨진 config.toml은 미설치로 둔다 — 설치를 시도하면 codex가 스스로
+    // 진단하고, "설치됨"으로 오판해 제거를 그리로 보내는 것보다 낫다.
+    return []
+  }
+}
+
+function copilotInstalled(file, pluginName) {
+  const list = readJson(file)?.installedPlugins
+  return Array.isArray(list) && list.some((p) => p?.name === pluginName)
+}
+
+// ponytail(items/plugin.ponytail.mjs)과 같은 규칙: plugin 키가 배열이 아니면
+// 손대지 않는다.
+function opencodePlugins(file) {
+  const value = readJson(file)?.plugin
+  if (value === undefined) return []
+  if (!Array.isArray(value)) return null
+  return value
+}
+
+// config:
+//   pluginName      감지·제거가 쓰는 상류 이름 (codex 접두사, copilot name,
+//                   gemini 확장 디렉터리 이름)
+//   marketplaceRepo codex·copilot 마켓플레이스 (owner/repo)
+//   installId       마켓플레이스 설치 id (<이름>@<마켓>)
+//   gemini          gemini extensions install에 줄 git URL, 없으면 null
+//   opencode        전역 opencode.json plugin 배열에 넣을 항목, 없으면 null
+// supports는 어댑터 유무로 정해진다 — codex·copilot은 항상, gemini·opencode는
+// 좌표가 있을 때만.
+export function defineGlobalPlugin(
+  { id, label, group, note, exclusive = null, unsupported = {}, pluginName, marketplaceRepo, installId, gemini = null, opencode = null },
+  { home = null, env = process.env, hasBinary = defaultHasBinary } = {},
+) {
+  const supports = ['codex', ...(gemini ? ['gemini'] : []), ...(opencode ? ['opencode'] : []), 'copilot']
+
+  const files = () => {
+    const base = home ?? homedir()
+    return {
+      codex: join(env.CODEX_HOME || join(base, '.codex'), 'config.toml'),
+      copilot: join(base, '.copilot', 'config.json'),
+      gemini: join(base, '.gemini', 'extensions', pluginName),
+      opencode: join(env.XDG_CONFIG_HOME || join(base, '.config'), 'opencode', 'opencode.json'),
+    }
+  }
+
+  const isOurEntry = (p) => String(p).startsWith(`${pluginName}@`)
+  const wired = {
+    codex: (f) => codexPluginIds(f.codex, pluginName).length > 0,
+    copilot: (f) => copilotInstalled(f.copilot, pluginName),
+    gemini: (f) => existsSync(f.gemini),
+    opencode: (f) => (opencodePlugins(f.opencode) ?? []).some(isOurEntry),
+  }
+
+  return {
+    id, category: 'plugin', label, scope: 'user', group, exclusive,
+    supports: [...supports],
+    unsupported,
+    note,
+
+    // 상태는 "이 머신에 있는 하니스" 기준이다. CLI가 없는 하니스까지 누락으로
+    // 세면 gemini 없는 머신은 영원히 partial이라 apply가 매번 헛돈다.
+    async detect() {
+      const f = files()
+      const present = supports.filter((c) => wired[c](f))
+      const machine = supports.filter((c) => hasBinary(c))
+      const noCli = supports.filter((c) => !machine.includes(c))
+      const missing = machine.filter((c) => !present.includes(c))
+      const detail = noCli.length > 0 ? msg('item.global.noCli', { list: noCli.join(', ') }) : undefined
+      if (present.length === 0) return { status: 'absent', detail }
+      if (missing.length === 0) return { status: 'installed', detail }
+      return {
+        status: 'partial',
+        detail: msg('item.plugin.partial', { present: present.join(', '), missing: missing.join(', ') }),
+      }
+    },
+
+    async install({ dryRun, exec, log = () => {}, t }) {
+      const f = files()
+      // opencode 설정이 손댈 수 없는 꼴이면 아무것도 만지기 전에 멈춘다 —
+      // 절반만 설치된 채 실패하는 것보다 통째로 거절이 낫다.
+      const needsOpencode = opencode && !wired.opencode(f) && hasBinary('opencode')
+      if (needsOpencode && !dryRun && opencodePlugins(f.opencode) === null) {
+        throw new LocalizedError('error.globalOpencodePlugin', { file: f.opencode, entry: opencode })
+      }
+      const skipped = []
+      const failures = []
+      const fail = (cli, output) => failures.push(`${cli}: ${String(output).trim().split('\n')[0]}`)
+      for (const cli of supports) {
+        if (wired[cli](f)) continue
+        if (!hasBinary(cli)) {
+          skipped.push(cli)
+          continue
+        }
+        if (cli === 'codex') {
+          // 마켓 등록은 이미 있어도 해가 없다 — 성패는 add가 판정한다.
+          await exec('codex', ['plugin', 'marketplace', 'add', marketplaceRepo])
+          const r = await exec('codex', ['plugin', 'add', installId])
+          if (!r.ok) fail(cli, r.output)
+        } else if (cli === 'copilot') {
+          await exec('copilot', ['plugin', 'marketplace', 'add', marketplaceRepo])
+          // 실측(2026-08-15): 다른 copilot 세션이 떠 있으면 os error 5로 한 번
+          // 실패하고 재시도에 성공한다. 한 번만 다시 시도한다.
+          let r = await exec('copilot', ['plugin', 'install', installId])
+          if (!r.ok) r = await exec('copilot', ['plugin', 'install', installId])
+          if (!r.ok) fail(cli, r.output)
+        } else if (cli === 'gemini') {
+          const r = await exec('gemini', ['extensions', 'install', gemini])
+          if (!r.ok) fail(cli, r.output)
+        } else {
+          if (dryRun) {
+            log(t('log.plugin.add', { cli: CLIS.opencode.label, name: opencode }))
+            continue
+          }
+          const list = opencodePlugins(f.opencode) ?? []
+          if (list.length === 0) setKey(f.opencode, ['plugin'], [opencode])
+          else setKey(f.opencode, ['plugin', list.length], opencode)
+        }
+      }
+      if (failures.length > 0) throw new LocalizedError('error.globalExec', { detail: failures.join(' / ') })
+      if (skipped.length > 0) return { message: msg('item.global.skipped', { list: skipped.join(', ') }) }
+    },
+
+    async uninstall({ dryRun, exec, log = () => {}, t }) {
+      const f = files()
+      const skipped = []
+      const failures = []
+      const fail = (cli, output) => failures.push(`${cli}: ${String(output).trim().split('\n')[0]}`)
+      for (const cli of supports) {
+        if (!wired[cli](f)) continue
+        if (cli === 'opencode') {
+          if (dryRun) {
+            log(t('log.plugin.remove', { cli: CLIS.opencode.label, name: opencode }))
+            continue
+          }
+          const kept = (opencodePlugins(f.opencode) ?? []).filter((p) => !isOurEntry(p))
+          // 우리 항목만 빼고 비면 키째 지운다 — 빈 배열은 우리가 남긴 흔적이다.
+          if (kept.length === 0) removeKey(f.opencode, ['plugin'])
+          else setKey(f.opencode, ['plugin'], kept)
+          continue
+        }
+        if (!hasBinary(cli)) {
+          skipped.push(cli)
+          continue
+        }
+        if (cli === 'codex') {
+          for (const pid of codexPluginIds(f.codex, pluginName)) {
+            const r = await exec('codex', ['plugin', 'remove', pid])
+            if (!r.ok) fail(cli, r.output)
+          }
+          // 마켓플레이스 등록은 남긴다 — 우리가 등록했다는 보장이 없고,
+          // 같은 마켓의 다른 플러그인이 쓰고 있을 수 있다.
+        } else if (cli === 'copilot') {
+          let r = await exec('copilot', ['plugin', 'uninstall', pluginName])
+          if (!r.ok) r = await exec('copilot', ['plugin', 'uninstall', pluginName])
+          if (!r.ok) fail(cli, r.output)
+        } else {
+          const r = await exec('gemini', ['extensions', 'uninstall', pluginName])
+          if (!r.ok) fail(cli, r.output)
+        }
+      }
+      if (failures.length > 0) throw new LocalizedError('error.globalExec', { detail: failures.join(' / ') })
+      if (skipped.length > 0) return { message: msg('item.global.skipped', { list: skipped.join(', ') }) }
+    },
+  }
+}

package/lib/i18n/catalog/en.mjs

@@ -234,6 +234,11 @@ export default {
   'item.unsupported.mattpocockRegistry': 'upstream also documents npx skills add (the shared .agents/skills), but this item wires the Claude Code plugin only',
   'item.unsupported.upstreamNone': 'no official install path upstream',
   'item.unsupported.superpowersSeparate': 'upstream supports it via a separate per-harness install — this item wires the Claude Code plugin only',
+  'item.unsupported.superpowersGlobalClaude': 'covered by the project-scope item superpowers (plugin)',
+  'item.unsupported.superpowersGlobalGrok': 'upstream 6.3.0 ships grok plugin install superpowers@xai-official, but the detect/remove paths are unverified — not wired yet',
+  'item.unsupported.superpowersGlobalKimi': 'upstream installs only via the interactive /plugins command — no headless path',
+  'item.unsupported.globalProjectItem': 'covered by the project-scope item {item}',
+  'item.unsupported.ponytailGlobalGrok': 'upstream ships grok plugin install DietrichGebert/ponytail --trust, but the detect/remove paths are unverified — not wired yet',
   'item.unsupported.bkitPort': 'upstream ships separate ports (bkit-codex / bkit-gemini) installed apart from this plugin; the Gemini port is still a Gemini CLI extension and has had no update since the 2026-06-18 sunset',
   'item.unsupported.impeccableJunction': 'upstream supports it, but npx impeccable install breaks the shared .agents/skills link, so only the plugin route is wired',
   'item.unsupported.gstackHost': 'upstream supports it via ./setup --host — this item installs for Claude Code only',
@@ -241,6 +246,9 @@ export default {
   'item.unsupported.gsdGemini': 'upstream dropped Gemini CLI (sunset 2026-06) — Antigravity succeeds it via --antigravity',
   'item.mcp.partial': 'registered: {present} / missing: {missing}',
   'item.plugin.partial': 'wired: {present} / missing: {missing}',
+  'item.global.noCli': 'CLI not on this machine: {list} — excluded from the target set',
+  'run.keepUserScope': '· {id} is a user-global item and is not removed by omission from --set — uncheck it in the TUI to remove it',
+  'item.global.skipped': 'skipped (no CLI): {list}',
   'item.plugin.deferred': 'recorded in config — it downloads on the next Claude Code run',
   'item.scanFailed': 'detection failed: {message}',
   'log.mcp.add': '  [dry-run] register {name} in the {cli} config',
@@ -254,7 +262,9 @@ export default {
   'item.mcp.codebase-memory.note': 'needs the codebase-memory-mcp binary on PATH. Install: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
   'item.mcp.graphify.note': 'needs the graphify-mcp binary on PATH. Install: uv tool install "graphifyy[mcp]". Reads graphify-out/graph.json — build it first with /graphify .',
   'item.mcp.headroom.note': 'needs the headroom binary on PATH. Install: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". The proxy (headroom wrap) is a way of launching, not repo config',
-  'item.plugin.superpowers.note': 'official marketplace plugin. Upstream supports 11 harnesses (Codex, Antigravity, …) via per-harness installs',
+  'item.plugin.superpowers.note': 'official marketplace plugin. Upstream supports 14 harnesses (Codex, Grok Build, …) via per-harness installs',
+  'item.global.superpowers.note': 'installs superpowers user-globally with each harness\'s official command — marketplace for codex/copilot, extensions for gemini, the global opencode.json for OpenCode. CLIs missing from this machine are skipped. With skill.superpowers also on, overlapping CLIs see the same skills twice',
+  'item.global.ponytail.note': 'installs Ponytail user-globally with each harness\'s official command — the DietrichGebert/ponytail marketplace for codex/copilot, extensions for gemini. After the codex install, check hook registration once via /hooks. Upstream recommends scripts/uninstall.js to clean ~/.config/ponytail before removal — this item removes the plugin only',
   'item.plugin.mattpocock-skills.note': '35 engineering and productivity skills (code-review, diagnosing-bugs, domain-modeling, …)',
   'item.plugin.ponytail.note': 'lean-code ruleset. Wires the Claude Code plugin and the OpenCode plugin entry, both repo-scoped',
   'item.plugin.ecc.note': 'skills, instincts, memory and security for agent harnesses. Installed as a plugin — its skills/ holds 284 entries, too many to copy into the shared skills directory',
@@ -265,6 +275,9 @@ export default {
   'item.skill.hallmark.note': 'anti-AI-slop design skill with four verbs (build, audit, redesign, study). 21 themes and 57 slop-test gates. Upstream also documents Cursor and Codex paths; the shared skills directory covers all 10 CLIs at once',
   'item.skill.diagram-design.note': 'draws 27 diagram types in HTML/SVG using your brand colors and fonts; also redraws Mermaid and draw.io sources. The default fonts (Instrument Serif, Geist) carry no CJK glyphs — swap them in style-guide.md — and PNG export needs Playwright and Chromium separately. The three upstream slash commands are left out, but the references/ they delegate to come along',
   'item.skill.superpowers.note': 'copies 14 skills into the shared .agents/skills so all 10 CLIs see them. Only one of this and the plugin edition can be chosen — this route has no session-start hook, so nothing is injected at the start of a conversation and skills are invoked on demand',
+  'item.skill.agent-browser.note': 'a skill that drives the browser-automation CLI. Requires the agent-browser binary on PATH — npm i -g agent-browser, then agent-browser install once (downloads Chrome for Testing). The SKILL.md is a discovery stub; the real workflow guidance is served by the installed CLI. The body is harness-neutral, so all 10 CLIs share it (only the allowed-tools line is Claude syntax)',
+  'item.skill.find-skills.note': 'a skill that searches the public skills registry and guides installs. It only instructs npx skills commands — harness-neutral, shared by all 10 CLIs',
+  'item.skill.mcp-builder.note': 'a guide for building MCP servers (Python FastMCP, Node MCP SDK). Its four reference/ documents and the Apache-2.0 LICENSE.txt are copied along inside the skill directory. Harness-neutral content shared by all 10 CLIs',
   'item.skill.mattpocock-skills.note': 'copies 35 skills into the shared .agents/skills so all 10 CLIs see them. Upstream documents this route itself, and with no hooks involved nothing is lost against the plugin edition. Only one of the two can be chosen',
   'item.skill.karpathy.note': 'behavioral guidelines that curb overbuilding and vague success criteria',
   'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally.',
@@ -284,6 +297,8 @@ export default {
   'error.gsdInstall': 'GSD install failed: {output}',
   'error.gsdUninstall': 'GSD uninstall failed: {output}',
   'error.ponytailOpencodePlugin': '{file}: the plugin key is not an array. Leaving it alone — add "@dietrichgebert/ponytail" by hand.',
+  'error.globalExec': 'a harness command failed — {detail}',
+  'error.globalOpencodePlugin': '{file}: the plugin key is not an array. Leaving it alone — add "{entry}" by hand.',
   'error.registrySkillInstall': 'skill registry install failed ({skill}): {output}',
   'error.registrySkillAnchor': "{id}: when skill is '*', an anchor skill must be named for detect to look at",
   'error.itemFieldMissing': '{file}: {field} missing',

package/lib/i18n/catalog/ko.mjs

@@ -227,6 +227,11 @@ export default {
   'item.unsupported.mattpocockRegistry': '상류가 npx skills add(공유 .agents/skills)도 안내하지만 이 항목은 Claude Code 플러그인만 배선합니다',
   'item.unsupported.upstreamNone': '상류에 공식 설치 경로가 없습니다',
   'item.unsupported.superpowersSeparate': '상류가 하니스별 별도 설치로 지원합니다 — 이 항목은 Claude Code 플러그인만 배선합니다',
+  'item.unsupported.superpowersGlobalClaude': '프로젝트 스코프 항목 superpowers (plugin)이 담당합니다',
+  'item.unsupported.superpowersGlobalGrok': '상류 6.3.0에 grok plugin install superpowers@xai-official 명령이 있지만 감지·제거 경로를 실측하지 못해 아직 배선하지 않습니다',
+  'item.unsupported.superpowersGlobalKimi': '상류 설치가 대화형 /plugins 명령뿐이라 헤드리스 경로가 없습니다',
+  'item.unsupported.globalProjectItem': '프로젝트 스코프 항목 {item}이 담당합니다',
+  'item.unsupported.ponytailGlobalGrok': '상류 명령(grok plugin install DietrichGebert/ponytail --trust)이 있지만 감지·제거 경로 미실측이라 배선하지 않습니다',
   'item.unsupported.bkitPort': '상류가 별도 배포판(bkit-codex·bkit-gemini)으로 지원합니다 — 이 플러그인과 별개 설치입니다. Gemini판은 Gemini CLI 확장 그대로이고 2026-06-18 종료 이후 갱신이 없습니다',
   'item.unsupported.impeccableJunction': '상류는 지원하지만 npx impeccable install이 공유 .agents/skills 연결을 끊어 플러그인 경로만 배선합니다',
   'item.unsupported.gstackHost': '상류는 ./setup --host로 지원합니다 — 이 항목은 Claude Code에만 설치합니다',
@@ -234,6 +239,9 @@ export default {
   'item.unsupported.gsdGemini': '상류가 Gemini CLI 지원을 제거했습니다(2026-06 종료) — Antigravity가 --antigravity로 승계합니다',
   'item.mcp.partial': '등록됨: {present} / 누락: {missing}',
   'item.plugin.partial': '배선됨: {present} / 누락: {missing}',
+  'item.global.noCli': 'CLI 없음: {list} — 이 머신 대상에서 제외',
+  'run.keepUserScope': '· {id}는 사용자 전역 항목이라 --set 생략으로는 제거하지 않습니다 — 제거하려면 TUI에서 해제하세요',
+  'item.global.skipped': 'CLI가 없어 건너뜀: {list}',
   'item.plugin.deferred': '설정 기록됨 — 다음 Claude Code 실행 시 다운로드됩니다',
   'item.scanFailed': '감지 실패: {message}',
   'log.mcp.add': '  [dry-run] {cli} 설정에 {name} 등록',
@@ -247,7 +255,9 @@ export default {
   'item.mcp.codebase-memory.note': 'PATH에 codebase-memory-mcp 바이너리 필요. 설치: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
   'item.mcp.graphify.note': 'PATH에 graphify-mcp 바이너리 필요. 설치: uv tool install "graphifyy[mcp]". graphify-out/graph.json을 읽으므로 /graphify .로 그래프를 먼저 만드세요',
   'item.mcp.headroom.note': 'PATH에 headroom 바이너리 필요. 설치: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". 프록시(headroom wrap)는 실행 방식이라 저장소 설정 대상이 아닙니다',
-  'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인. 상류는 Codex·Antigravity 등 11개 하니스를 하니스별 설치로 지원합니다',
+  'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인. 상류는 Codex·Grok Build 등 14개 하니스를 하니스별 설치로 지원합니다',
+  'item.global.superpowers.note': 'superpowers를 하니스별 공식 명령으로 사용자 전역에 설치합니다 — codex·copilot은 마켓플레이스, gemini는 extensions, opencode는 전역 opencode.json. 이 머신에 없는 CLI는 건너뜁니다. skill.superpowers와 함께 켜면 겹치는 CLI는 같은 스킬을 두 곳에서 봅니다',
+  'item.global.ponytail.note': 'Ponytail을 하니스별 공식 명령으로 사용자 전역에 설치합니다 — codex·copilot은 마켓플레이스(DietrichGebert/ponytail), gemini는 extensions. codex는 설치 후 /hooks에서 훅 등록을 한 번 확인해야 합니다. 상류는 제거 전 scripts/uninstall.js로 ~/.config/ponytail 정리를 안내합니다 — 이 항목은 플러그인만 제거합니다',
   'item.plugin.mattpocock-skills.note': '엔지니어링·생산성 스킬 35종 (code-review, diagnosing-bugs, domain-modeling 등)',
   'item.plugin.ponytail.note': '군더더기 없는 코드 규칙 묶음. Claude Code 플러그인과 OpenCode plugin 항목을 저장소 범위로 배선합니다',
   'item.plugin.ecc.note': '에이전트 하네스용 스킬·본능·메모리·보안 묶음. skills/에 284개가 들어 있어 공유 스킬 디렉터리에 복사하지 않고 플러그인으로 설치합니다',
@@ -258,6 +268,9 @@ export default {
   'item.skill.hallmark.note': '네 가지 동사(신규 제작·audit·redesign·study)를 갖춘 안티 AI슬롭 디자인 스킬. 테마 21종과 슬롭 테스트 57종. 상류는 Cursor·Codex 경로도 안내하지만 공유 스킬 디렉터리 하나로 10개 CLI가 함께 봅니다',
   'item.skill.diagram-design.note': '브랜드 색·폰트로 다이어그램 27종을 그리는 HTML/SVG 스킬. Mermaid·draw.io 원본도 다시 그립니다. 기본 폰트(Instrument Serif·Geist)에 한글 글리프가 없어 style-guide.md에서 바꿔야 하고, PNG 내보내기는 Playwright·Chromium이 따로 필요합니다. 상류 플러그인의 명령 3개는 빠지지만 그 본문인 references/는 그대로 옵니다',
   'item.skill.superpowers.note': '공유 .agents/skills에 스킬 14종을 복사해 10개 CLI가 함께 봅니다. 플러그인 판과 하나만 고를 수 있습니다 — 이쪽은 session-start 훅이 없어 대화 시작 시 자동 주입이 되지 않고, 스킬을 불러서 씁니다',
+  'item.skill.agent-browser.note': '브라우저 자동화 CLI를 쓰게 하는 스킬. PATH에 agent-browser 바이너리 필요 — npm i -g agent-browser 후 최초 1회 agent-browser install(Chrome for Testing 다운로드). SKILL.md는 안내 스텁이라 실제 지침은 설치된 CLI가 제공합니다. 본문이 하네스 중립이라 10개 CLI가 함께 씁니다(allowed-tools 줄만 Claude 문법)',
+  'item.skill.find-skills.note': '공개 스킬 레지스트리를 검색해 설치를 안내하는 스킬. npx skills 명령만 지시하는 하네스 중립 문서라 10개 CLI가 함께 씁니다',
+  'item.skill.mcp-builder.note': 'MCP 서버 제작 가이드(Python FastMCP·Node MCP SDK). reference/ 문서 4종과 Apache-2.0 LICENSE.txt가 스킬 디렉터리에 함께 복사됩니다. 내용이 하네스 중립이라 10개 CLI가 함께 씁니다',
   'item.skill.mattpocock-skills.note': '공유 .agents/skills에 스킬 35종을 복사해 10개 CLI가 함께 봅니다. 상류가 직접 안내하는 경로이며 훅이 없어 플러그인 판에 견줘 잃는 것이 없습니다. 둘 중 하나만 고를 수 있습니다',
   'item.skill.karpathy.note': '과설계와 모호한 완료 기준을 줄이는 행동 지침',
   'item.skill.gstack.note': '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음.',
@@ -276,6 +289,8 @@ export default {
   'error.gsdInstall': 'GSD 설치 실패: {output}',
   'error.gsdUninstall': 'GSD 제거 실패: {output}',
   'error.ponytailOpencodePlugin': '{file}: plugin 키가 배열이 아닙니다. 덮어쓰지 않고 그대로 둡니다 — "@dietrichgebert/ponytail"을 직접 추가하세요.',
+  'error.globalExec': '하니스 명령이 실패했습니다 — {detail}',
+  'error.globalOpencodePlugin': '{file}: plugin 키가 배열이 아닙니다. 덮어쓰지 않고 그대로 둡니다 — "{entry}"을 직접 추가하세요.',
   'error.registrySkillInstall': '스킬 레지스트리 설치 실패 ({skill}): {output}',
   'error.registrySkillAnchor': "{id}: skill이 '*'이면 detect가 볼 대표 스킬을 anchor로 지정해야 합니다",
   'error.itemFieldMissing': '{file}: {field} 누락',

package/lib/items/global.ponytail.mjs

@@ -0,0 +1,52 @@
+import { defineGlobalPlugin } from '../global-plugin.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
+
+// Ponytail의 하니스별 전역 설치 판. 공통 기구는 global-plugin.mjs에 있다.
+//
+// 하니스별 근거(2026-08-15 상류 README 재검증):
+//   codex   — `codex plugin marketplace add DietrichGebert/ponytail` +
+//             `codex plugin add ponytail@ponytail`. 상류는 설치 후 codex에서
+//             /hooks로 라이프사이클 훅 등록을 확인하고 새 스레드를 시작하라는
+//             대화형 후속 단계를 안내한다 — 명령으로 대신할 수 없어 note에
+//             적는다. 제거는 `codex plugin remove <id>`.
+//   copilot — `copilot plugin marketplace add` + `copilot plugin install
+//             ponytail@ponytail`. 상류 README에 제거 명령은 없지만
+//             `copilot plugin uninstall <이름>`은 copilot CLI 자체의 범용
+//             명령이다(--help 실측).
+//   gemini  — `gemini extensions install https://github.com/DietrichGebert/ponytail`.
+//
+// opencode는 프로젝트 항목(plugin.ponytail)이 opencode.jsonc의 plugin 배열로
+// 이미 배선한다 — 전역 판에서 겹치면 같은 플러그인이 두 번 등록된다. claude도
+// 같은 이유로 프로젝트 항목의 자리다. grok은 상류 명령이 있으나 감지·제거
+// 경로를 실측할 CLI가 없어 superpowers 전역 판과 같은 기준으로 제외한다.
+// kiro·vscode는 상류가 룰 파일 수동 배치만 안내하고, kilo·kimi는 경로가 없다.
+//
+// 상류는 플러그인 제거 전에 node scripts/uninstall.js로 ~/.config/ponytail
+// 설정과 statusLine 항목을 정리하라고 안내한다 — 하니스마다 스크립트 위치가
+// 달라 자동화하지 않고 note로 알린다. 이 항목은 플러그인만 제거한다.
+const SUPPORTS = ['codex', 'gemini', 'copilot']
+
+const CONFIG = {
+  id: 'global.ponytail', label: 'Ponytail (global)', group: '__token',
+  note: 'item.global.ponytail.note',
+  pluginName: 'ponytail',
+  marketplaceRepo: 'DietrichGebert/ponytail',
+  installId: 'ponytail@ponytail',
+  gemini: 'https://github.com/DietrichGebert/ponytail',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
+      c,
+      ['claude', 'opencode'].includes(c) ? msg('item.unsupported.globalProjectItem', { item: 'Ponytail' })
+      : c === 'grok' ? msg('item.unsupported.ponytailGlobalGrok')
+      : ['kiro', 'vscode'].includes(c) ? msg('item.unsupported.ponytailRules')
+      : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
+}
+
+export function createItem(deps = {}) {
+  return defineGlobalPlugin(CONFIG, deps)
+}
+
+export default createItem()

package/lib/items/global.superpowers.mjs

@@ -0,0 +1,52 @@
+import { defineGlobalPlugin } from '../global-plugin.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
+
+// superpowers를 프로젝트 스코프로 배선할 길이 없는 하니스에 상류의 하니스별
+// 전역 설치("install separately for each one")를 대신 해 주는 항목. 공통
+// 기구는 global-plugin.mjs에 있고, 여기는 상류 좌표와 사유만 든다.
+//
+// 하니스별 근거(2026-08-15, v6.3.0):
+//   codex   — 이 머신에서 marketplace add + plugin add를 실측. 기록은
+//             $CODEX_HOME/config.toml의 [plugins."superpowers@…"].
+//   copilot — 이 머신에서 설치·목록·제거를 실측(~/.copilot/config.json).
+//   gemini  — 공식 extensions 기구. 로컬 CLI가 없어 문서 근거다.
+//   opencode— 상류 .opencode/INSTALL.md가 전역 opencode.json의 plugin 배열에
+//             아래 항목 한 줄을 더하라고 안내한다.
+//
+// grok은 상류 명령(grok plugin install superpowers@xai-official --trust)이
+// 있지만 감지·제거 경로를 실측할 CLI가 없어 아직 배선하지 않고, kimi는 설치가
+// 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트 스코프 항목
+// (plugin.superpowers)의 자리다.
+//
+// skill.superpowers(공유 .agents/skills)와 배타로 묶지 않는다 — 저쪽은 이
+// 저장소에만, 이쪽은 머신 전체에 작용해 평면이 다르고, "claude는 프로젝트
+// 플러그인 + 나머지는 전역" 같은 조합이 정당하다. 겹치는 하니스가 같은 스킬을
+// 두 곳에서 본다는 것은 note에 적어 둔다.
+const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot']
+
+const CONFIG = {
+  id: 'global.superpowers', label: 'superpowers (global)', group: '__flow',
+  note: 'item.global.superpowers.note',
+  pluginName: 'superpowers',
+  marketplaceRepo: 'obra/superpowers-marketplace',
+  installId: 'superpowers@superpowers-marketplace',
+  gemini: 'https://github.com/obra/superpowers',
+  opencode: 'superpowers@git+https://github.com/obra/superpowers.git',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
+      c,
+      c === 'claude' ? msg('item.unsupported.superpowersGlobalClaude')
+      : c === 'grok' ? msg('item.unsupported.superpowersGlobalGrok')
+      : c === 'kimi' ? msg('item.unsupported.superpowersGlobalKimi')
+      : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
+}
+
+// 테스트가 홈·환경·PATH 탐지를 갈아끼울 수 있게 공장으로 노출한다.
+export function createItem(deps = {}) {
+  return defineGlobalPlugin(CONFIG, deps)
+}
+
+export default createItem()

package/lib/items/plugin.impeccable.mjs

@@ -6,12 +6,15 @@ import { msg } from '../i18n/index.mjs'
 // 부트스트랩이 만든 `.agents/skills` Junction을 끊는다 — 공유 스킬이 전부
 // Claude Code 화면에서 사라진다. 버그가 아니라 설계다: 상류
 // `cli/bin/commands/skills.mjs`의 isInProjectProviderLink가 "프로젝트 안 다른
-// 프로바이더를 가리키는 링크"를 의도적으로 unlink한다(3.5.0 재확인, 2026-08-02).
+// 프로바이더의 skills를 가리키는 링크"를 의도적으로 unlink한다(3.6.0 재확인,
+// 2026-08-15 — 저장소 밖을 가리키는 링크는 보존하지만, 부트스트랩 Junction은
+// 프로젝트 안 `.agents/skills`를 가리켜 여전히 파괴 대상이다).
 // 플러그인 경로는 `.claude/skills`를 건드리지 않는다.
 // 또 그 명령은 `--providers`와 `--scope`를 함께 주지 않으면 대화형으로 물으며,
 // 비TTY에서는 조용히 global을 골라 홈에 설치한다.
-// 상류 공식 프로바이더 14개 중 이 저장소의 CLI와 겹치는 것(아래 UPSTREAM).
-// Antigravity는 README에만 있고 설치 CLI는 거부한다(수동 복사 전용).
+// 상류 공식 프로바이더는 3.6.0 기준 16개(.agent=antigravity·.hermes가 새로
+// 들어옴 — README는 아직 수동 복사만 안내해 코드가 앞선다). 이 저장소의 CLI와
+// 겹치는 것은 아래 UPSTREAM 그대로다.
 const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot']
 export default definePlugin({
   id: 'plugin.impeccable', label: 'impeccable', group: '__style',

package/lib/items/skill.agent-browser.mjs

@@ -0,0 +1,16 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// SKILL.md는 안내 스텁이다 — 실제 워크플로 지침은 설치된 CLI가 런타임에 준다
+// (`agent-browser skills get core`). 그래서 스킬 복사만으로는 반쪽이고, PATH의
+// agent-browser 바이너리(npm i -g agent-browser)와 최초 1회
+// `agent-browser install`(Chrome for Testing 다운로드)이 사실상 전제다 —
+// note가 알린다. 본문은 Bash로 agent-browser를 부르라는 하네스 중립 문서라
+// 공유 디렉터리의 10개 CLI가 함께 쓴다. frontmatter의 allowed-tools와
+// hidden: true는 Claude Code 문법이라 다른 CLI는 무시한다.
+// (2026-08-15 확인: skills/agent-browser/SKILL.md 단일 스킬, npm agent-browser
+// 0.34.0 = vercel-labs 리포, 네이티브 바이너리는 Windows x64 포함.)
+export default defineRegistrySkill({
+  id: 'skill.agent-browser', label: 'agent-browser', group: '__service',
+  source: 'https://github.com/vercel-labs/agent-browser',
+  skill: 'agent-browser',
+  note: 'item.skill.agent-browser.note',
+})

package/lib/items/skill.find-skills.mjs

@@ -0,0 +1,12 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// vercel-labs/skills는 이 저장소의 레지스트리 항목들이 쓰는 `npx skills` CLI
+// 본체 리포인데, 자체 배포 스킬은 find-skills 하나다(skills/find-skills/
+// SKILL.md, 2026-08-15 확인). 본문은 npx skills find/add/update 명령만
+// 지시하는 하네스 중립 문서다. README 예시에 나오는 web-design-guidelines
+// 등은 별도 리포(vercel-labs/agent-skills) 소속이라 이 항목과 무관하다.
+export default defineRegistrySkill({
+  id: 'skill.find-skills', label: 'find-skills', group: '__flow',
+  source: 'https://github.com/vercel-labs/skills',
+  skill: 'find-skills',
+  note: 'item.skill.find-skills.note',
+})

package/lib/items/skill.mcp-builder.mjs

@@ -0,0 +1,13 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// anthropics/skills 17종 중 mcp-builder 하나만 --skill로 고른다. 본문이
+// reference/*.md 넷을 상대경로로 참조하는데 레지스트리 --copy가 스킬
+// 디렉터리를 통째로 복사하므로 함께 온다 — 스킬별 LICENSE.txt(Apache-2.0)도
+// 같은 디렉터리에 실려 고지가 유지된다(2026-08-15 확인, 리포 단위 라이선스는
+// 없고 스킬별로 갈린다). Python(FastMCP)·Node(MCP SDK) 서버 작성 가이드라
+// Claude 전용 도구 없이 하네스 중립이다.
+export default defineRegistrySkill({
+  id: 'skill.mcp-builder', label: 'mcp-builder', group: '__service',
+  source: 'https://github.com/anthropics/skills',
+  skill: 'mcp-builder',
+  note: 'item.skill.mcp-builder.note',
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.12.0",
+  "version": "1.15.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",
@@ -20,10 +20,21 @@
   },
   "license": "MIT",
   "type": "module",
-  "engines": { "node": ">=20" },
-  "bin": { "agent-setup": "install.mjs" },
-  "files": ["install.mjs", "lib/", "README.md", "LICENSE"],
-  "publishConfig": { "access": "public" },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "agent-setup": "install.mjs"
+  },
+  "files": [
+    "install.mjs",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "start": "node install.mjs",
     "test": "node --test",