@rch4com/agent-setup 1.18.0 → 1.20.0

package/install.mjs

@@ -54,14 +54,21 @@ async function runClassic(root, { dryRun, listOnly, setArg, t }) {
   const { loadItems } = await withDeps(() => import('./lib/catalog.mjs'), t)
   const { scan, planChanges, apply, assertExclusive } = await withDeps(() => import('./lib/engine.mjs'), t)
   const { plainLine } = await withDeps(() => import('./lib/tui/progress.mjs'), t)
+  const { coverageText } = await withDeps(() => import('./lib/tui/rows.mjs'), t)
   const items = await loadItems()
   const states = await scan(root, items)
   const statusWidth = labelWidth(t, STATUS_KEYS)
 
   if (listOnly) {
+    // CI가 읽는 경로다 — 화면의 힌트와 같은 정보(커버리지·대상 파일·설치 위치)를
+    // 싣는다. 상태·이름만으로는 "내 CLI에서 되나"를 여기서 알 수 없었다.
     for (const s of states) {
       const detail = toText(t, s.detail)
-      console.log(`${pad(t(`status.${s.status}`), statusWidth)} ${s.item.id} — ${scopedLabel(s.item, t)}${detail ? ` (${detail})` : ''}`)
+      const extras = [coverageText(s.item, s, t)]
+      if (s.item.target) extras.push(t('item.target', { path: s.item.target }))
+      if (s.item.scope === 'user') extras.push(t('item.location.user'))
+      const tail = extras.filter(Boolean).map((x) => ` · ${x}`).join('')
+      console.log(`${pad(t(`status.${s.status}`), statusWidth)} ${s.item.id} — ${scopedLabel(s.item, t)}${tail}${detail ? ` (${detail})` : ''}`)
     }
     return
   }
@@ -118,7 +125,11 @@ async function main() {
   // 살아남는다. 조용히 되돌아가는 대신 화면이 그 사실을 알리게 한다.
   const localeForced = isLocaleForced({ flag, env: process.env })
 
-  if (root === null) throw new LocalizedError('error.notGitRepo')
+  // 도움말은 저장소가 필요 없다. 이 검사를 먼저 하면 `--help`가 Git 저장소
+  // 밖에서 "Run this inside a Git repository"로 죽는다 — 사용법을 보려는
+  // 사람에게 그 오류를 내밀 이유가 없다.
+  const wantsHelp = argv.includes('-h') || argv.includes('--help')
+  if (root === null && !wantsHelp) throw new LocalizedError('error.notGitRepo')
 
   if (argv[0] === 'bootstrap') {
     const opts = parseBootstrapArgs(argv.slice(1), t)
@@ -133,7 +144,8 @@ async function main() {
     if (opts.help) { console.log(updateUsage(t)); return }
     // 항목 수렴을 위해 스캔이 필요해 의존성 있는 모듈에 닿는다.
     const { runUpdate } = await withDeps(() => import('./lib/update.mjs'), t)
-    await runUpdate(root, { ...opts, t })
+    const { failed } = await runUpdate(root, { ...opts, t })
+    if (failed.length > 0) process.exitCode = 1
     return
   }
 

package/lib/catalog.mjs

@@ -3,7 +3,7 @@ import { join, dirname } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { execFile } from 'node:child_process'
 import { promisify } from 'node:util'
-import { CLIS, CLI_IDS } from './clis.mjs'
+import { CLIS, CLI_IDS, MCP_CLI_IDS } from './clis.mjs'
 import { isPluginEnabled, enablePlugin, disablePlugin } from './claude-plugins.mjs'
 import { repoPath, repoPathStrict } from './context.mjs'
 import { LocalizedError, msg } from './i18n/index.mjs'
@@ -61,10 +61,22 @@ export function shellQuote(text, platform = process.platform) {
 
 const execFileAsync = promisify(execFile)
 
+// 외부 명령 하나에 주는 시간. npx·git clone이 네트워크에서 멈추면 예전에는
+// 영원히 기다렸다 — Ctrl+C도 항목 경계에서만 보므로 그 항목이 끝나야 멈췄다.
+// 10분이면 gsd(3,500파일)·ECC 같은 큰 설치도 끝나고, 멈춘 명령은 결국 실패로
+// 보고된다. 호출부가 opts.timeout으로 바꿀 수 있다.
+export const EXEC_TIMEOUT_MS = 10 * 60 * 1000
+
+// 자식 출력의 상한. execFile 기본값(1MB)을 넘기면 Node가 자식을 **죽이고**
+// "maxBuffer length exceeded"로 실패시킨다 — gsd(3,500파일)·hallmark
+// (references 100개 이상)처럼 파일마다 한 줄씩 찍는 설치가 반쯤 깔린 채
+// 실패로 보고됐다. 64MB면 어떤 설치 로그도 넉넉히 담긴다.
+export const EXEC_MAX_BUFFER = 64 * 1024 * 1024
+
 // 비동기다. 동기 실행은 이벤트 루프를 통째로 막아, npx가 도는 수십 초 동안
 // 진행 화면을 한 번도 다시 그릴 수 없었다. 반환 형태({ ok, output })는
 // 그대로라 호출부는 await만 더하면 된다.
-export function makeExec(dryRun, log = console.log) {
+export function makeExec(dryRun, log = console.log, t = null) {
   return async (cmd, args, opts = {}) => {
     if (dryRun) {
       log(`  [dry-run] ${cmd} ${args.join(' ')}`)
@@ -84,6 +96,8 @@ export function makeExec(dryRun, log = console.log) {
       // 복원하려면 스폰 직후 우리가 직접 stdin을 닫아야 한다.
       const p = execFileAsync(file, fileArgs, {
         encoding: 'utf8',
+        timeout: EXEC_TIMEOUT_MS,
+        maxBuffer: EXEC_MAX_BUFFER,
         ...opts,
         shell,
       })
@@ -92,6 +106,13 @@ export function makeExec(dryRun, log = console.log) {
       const { stdout } = await p
       return { ok: true, output: stdout }
     } catch (err) {
+      // 시간 초과로 죽였으면 그 사실을 말한다 — stderr는 대개 비어 있어
+      // 아래 폴백만으로는 "왜 실패했는지"가 사라진다.
+      if (err.killed && err.signal) {
+        const seconds = Math.round((opts.timeout ?? EXEC_TIMEOUT_MS) / 1000)
+        const command = [cmd, ...args].join(' ')
+        return { ok: false, output: t ? t('error.commandTimeout', { seconds, command }) : `timed out after ${seconds}s: ${command}` }
+      }
       // spawn 자체가 실패하면(ENOENT 등) err.stderr가 undefined가 아니라
       // 빈 문자열로 온다 — ??는 빈 문자열을 "값 있음"으로 보고 통과시켜
       // err.message(바이너리 이름이 담긴 진단 텍스트)를 삼켜 버린다. ||로
@@ -101,11 +122,24 @@ export function makeExec(dryRun, log = console.log) {
   }
 }
 
-export function defineMcp({ id, label, server, supports = [...CLI_IDS], unsupported = {}, note, group = null }) {
+// supports 기본값은 프로젝트 MCP 파일이 있는 CLI(MCP_CLI_IDS)다. Antigravity는
+// 그 파일이 없어 빠지고, 사유가 기본으로 붙는다.
+//
+// stdio 서버도 copilot에 그대로 배선한다. Copilot CLI는 루트 .mcp.json(Claude
+// 파일)을 우선 읽고 거기엔 `type: "stdio"`가 쓰이는데, 한때 README는 그 형식이
+// 붙지 않는다고 적었다. 2026-09-05에 Copilot CLI 1.0.82의 app.js를 읽어 확인한
+// 바로는 로컬 서버 판정이 `type === undefined || type === "local" || type ===
+// "stdio"`이고 스키마도 `enum(["local", "stdio"])`라 stdio를 받는다 — 두 파일에
+// 각자 형식으로 써도 어느 쪽이 이기든 붙는다.
+export function defineMcp({ id, label, server, supports = [...MCP_CLI_IDS], unsupported: reasons = {}, note, group = null, verified = null }) {
+  const unsupported = { ...reasons }
+  for (const cli of CLI_IDS) {
+    if (!supports.includes(cli) && !unsupported[cli] && !MCP_CLI_IDS.includes(cli)) unsupported[cli] = msg('item.unsupported.noProjectMcp')
+  }
   assertReasons(id, supports, unsupported)
   const name = id.replace(/^mcp\./, '')
   return {
-    id, category: 'mcp', label, scope: 'project', supports, unsupported, note, group,
+    id, category: 'mcp', label, scope: 'project', supports, unsupported, note, group, verified,
     async detect({ root }) {
       const present = supports.filter((cli) => CLIS[cli].has(root, name))
       if (present.length === 0) return { status: 'absent' }
@@ -140,12 +174,12 @@ export function defineMcp({ id, label, server, supports = [...CLI_IDS], unsuppor
 // 배선은 Claude 한 곳이라도 미배선 "사유"는 CLI마다 다를 수 있다 — 상류가
 // 자체 경로로 지원하는 CLI에 일괄 "Claude 전용" 사유를 붙이면 거짓 정보가 된다.
 // 항목이 사유를 넘기면 그 CLI만 덮고, 나머지는 기본 사유로 채운다.
-export function definePlugin({ id, label, installId, detectIds, marketplace, note, group = null, exclusive = null, unsupported: reasons = {} }) {
+export function definePlugin({ id, label, installId, detectIds, marketplace, note, group = null, exclusive = null, unsupported: reasons = {}, verified = null }) {
   const unsupported = Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, reasons[c] ?? msg('item.unsupported.claudePlugin')]),
   )
   return {
-    id, category: 'plugin', label, scope: 'project', supports: ['claude'], unsupported, note, group, exclusive,
+    id, category: 'plugin', label, scope: 'project', supports: ['claude'], unsupported, note, group, exclusive, verified,
     async detect({ root }) {
       return { status: isPluginEnabled(root, detectIds) ? 'installed' : 'absent' }
     },
@@ -170,11 +204,11 @@ export function definePlugin({ id, label, installId, detectIds, marketplace, not
 // 대부분의 스킬 상류가 Claude 경로만 주기 때문이고, 상류가 런타임별 설치를
 // 주는 항목(skill.gsd)은 목록을 직접 넘긴다 — 넘긴 CLI는 미배선 사유 대상에서
 // 빠진다.
-export function defineSkill({ id, label, scope, detect, install, uninstall, note, group = null, supports = ['claude'], unsupported: reasons = {} }) {
+export function defineSkill({ id, label, scope, detect, install, uninstall, note, group = null, supports = ['claude'], unsupported: reasons = {}, verified = null }) {
   const unsupported = Object.fromEntries(
     CLI_IDS.filter((c) => !supports.includes(c)).map((c) => [c, reasons[c] ?? msg('item.unsupported.claudeSkill')]),
   )
-  return { id, category: 'skill', label, scope, supports: [...supports], unsupported, note, group, detect, install, uninstall }
+  return { id, category: 'skill', label, scope, supports: [...supports], unsupported, note, group, verified, detect, install, uninstall }
 }
 
 // 이 저장소가 공유 스킬 자리로 쓰는 디렉터리. vercel-labs/skills 레지스트리의
@@ -269,11 +303,11 @@ function pruneLock(root, names) {
 //
 // exclusive는 같은 상류를 플러그인으로도 넣을 수 있을 때 쓴다. 두 경로가 겹치면
 // 같은 스킬이 두 번 등록되므로 하나만 고르게 막는다.
-export function defineRegistrySkill({ id, label, source, skill, anchor = null, note, group = null, exclusive = null }) {
+export function defineRegistrySkill({ id, label, source, skill, anchor = null, note, group = null, exclusive = null, verified = null }) {
   const probe = anchor ?? skill
   if (skill === '*' && !anchor) throw new LocalizedError('error.registrySkillAnchor', { id })
   return {
-    id, category: 'skill', label, scope: 'project', supports: [...CLI_IDS], unsupported: {}, note, group, exclusive,
+    id, category: 'skill', label, scope: 'project', supports: [...CLI_IDS], unsupported: {}, note, group, exclusive, verified,
     async detect({ root }) {
       return { status: findSkillDir(root, probe) ? 'installed' : 'absent' }
     },

package/lib/clis.mjs

@@ -106,6 +106,17 @@ export const CLIS = {
         ? { type: 'http', url: s.url }
         : { type: 'stdio', command: s.command, args: s.args }),
   },
+  // Antigravity는 프로젝트 스코프 MCP 파일이 없다 — MCP는 홈 글로벌
+  // (~/.gemini/config/mcp_config.json)에서만 설정한다(bootstrap/manifest.mjs
+  // 주석·README). 그래서 어댑터(file·has·add·remove)가 없다. 그래도 목록에
+  // 두는 이유는 부트스트랩이 지원하는 11개 도구와 화면의 CLI 수가 어긋나면
+  // 안 되기 때문이다 — 공유 .agents/skills를 네이티브로 읽으므로 레지스트리
+  // 스킬은 실제로 닿고, MCP 항목은 "왜 안 닿는지"를 사유로 밝힌다.
+  antigravity: {
+    label: 'Antigravity',
+  },
 }
 
 export const CLI_IDS = Object.keys(CLIS)
+// 프로젝트 설정 파일에 MCP를 쓸 수 있는 CLI — 어댑터가 있는 것만.
+export const MCP_CLI_IDS = CLI_IDS.filter((id) => typeof CLIS[id].add === 'function')

package/lib/engine.mjs

@@ -6,7 +6,9 @@ export async function scan(root, items) {
   for (const item of items) {
     try {
       const r = await item.detect({ root })
-      states.push({ item, status: r.status, detail: r.detail })
+      // excluded는 전역 항목이 "이 머신에 없는 CLI"를 알리는 자리다 — 행 힌트가
+      // supports를 나열할 때 그 CLI를 빼고 따로 표시한다.
+      states.push({ item, status: r.status, detail: r.detail, excluded: r.excluded ?? [] })
     } catch (err) {
       states.push({ item, status: 'absent', detail: msg('item.scanFailed', { message: err.message }) })
     }
@@ -41,7 +43,7 @@ export function planChanges(states, selectedIds) {
 }
 
 export async function apply(root, changes, { dryRun = false, log = console.log, t = createT('en'), onProgress = null, shouldStop = null } = {}) {
-  const baseExec = makeExec(dryRun, log)
+  const baseExec = makeExec(dryRun, log, t)
   const results = []
   const total = changes.length
 

package/lib/global-plugin.mjs

@@ -12,6 +12,13 @@
 //   copilot  ~/.copilot/config.json의 installedPlugins[] (주석 있는 JSONC).
 //   gemini   ~/.gemini/extensions/<이름>/ (공식 extensions 문서).
 //   opencode 전역 opencode.json의 plugin 배열 (XDG_CONFIG_HOME 존중).
+//   grok     ~/.grok/installed-plugins/registry.json의 repos[*].plugins 키
+//            (2026-09-05 grok 1.0.5로 설치·제거 왕복 실측). 설치는
+//            `grok plugin install <소스> --trust`가 registry와 디렉터리를 만들고
+//            config.toml [plugins].enabled에도 이름을 넣는다. 제거
+//            (`grok plugin uninstall <이름> --confirm`)는 디렉터리·registry만
+//            지우고 enabled 항목은 남기므로, 감지의 근거는 registry여야 한다 —
+//            enabled를 보면 제거한 뒤에도 영원히 설치됨으로 읽힌다.
 import { existsSync, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { delimiter, join } from 'node:path'
@@ -67,13 +74,14 @@ function opencodePlugins(file) {
 //   installId       마켓플레이스 설치 id (<이름>@<마켓>)
 //   gemini          gemini extensions install에 줄 git URL, 없으면 null
 //   opencode        전역 opencode.json plugin 배열에 넣을 항목, 없으면 null
-// supports는 어댑터 유무로 정해진다 — codex·copilot은 항상, gemini·opencode는
+//   grok            grok plugin install에 줄 소스(마켓 id 또는 owner/repo), 없으면 null
+// supports는 어댑터 유무로 정해진다 — codex·copilot은 항상, gemini·opencode·grok은
 // 좌표가 있을 때만.
 export function defineGlobalPlugin(
-  { id, label, group, note, exclusive = null, unsupported = {}, pluginName, marketplaceRepo, installId, gemini = null, opencode = null },
+  { id, label, group, note, exclusive = null, unsupported = {}, pluginName, marketplaceRepo, installId, gemini = null, opencode = null, grok = null, verified = null },
   { home = null, env = process.env, hasBinary = defaultHasBinary } = {},
 ) {
-  const supports = ['codex', ...(gemini ? ['gemini'] : []), ...(opencode ? ['opencode'] : []), 'copilot']
+  const supports = ['codex', ...(gemini ? ['gemini'] : []), ...(opencode ? ['opencode'] : []), 'copilot', ...(grok ? ['grok'] : [])]
 
   const files = () => {
     const base = home ?? homedir()
@@ -82,19 +90,29 @@ export function defineGlobalPlugin(
       copilot: join(base, '.copilot', 'config.json'),
       gemini: join(base, '.gemini', 'extensions', pluginName),
       opencode: join(env.XDG_CONFIG_HOME || join(base, '.config'), 'opencode', 'opencode.json'),
+      grok: join(base, '.grok', 'installed-plugins', 'registry.json'),
     }
   }
 
+  // registry.json: { repos: { "<이름>-<해시>": { plugins: { "<이름>": {...} } } } }.
+  // 이름은 repos 키(해시가 붙는다)가 아니라 plugins 키에서 본다.
+  const grokInstalled = (file) => {
+    const repos = readJson(file)?.repos
+    if (!repos || typeof repos !== 'object') return false
+    return Object.values(repos).some((r) => Object.hasOwn(r?.plugins ?? {}, pluginName))
+  }
+
   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),
+    grok: (f) => grokInstalled(f.grok),
   }
 
   return {
-    id, category: 'plugin', label, scope: 'user', group, exclusive,
+    id, category: 'plugin', label, scope: 'user', group, exclusive, verified,
     supports: [...supports],
     unsupported,
     note,
@@ -108,11 +126,14 @@ export function defineGlobalPlugin(
       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 }
+      // excluded는 detail과 별도로 구조체로 넘긴다 — 행 힌트가 CLI 이름을
+      // 나열할 때 이 머신에 없는 것을 빼고 따로 적으려면 문장이 아니라 목록이 필요하다.
+      if (present.length === 0) return { status: 'absent', detail, excluded: noCli }
+      if (missing.length === 0) return { status: 'installed', detail, excluded: noCli }
       return {
         status: 'partial',
         detail: msg('item.plugin.partial', { present: present.join(', '), missing: missing.join(', ') }),
+        excluded: noCli,
       }
     },
 
@@ -148,6 +169,11 @@ export function defineGlobalPlugin(
         } else if (cli === 'gemini') {
           const r = await exec('gemini', ['extensions', 'install', gemini])
           if (!r.ok) fail(cli, r.output)
+        } else if (cli === 'grok') {
+          // --trust는 확인 프롬프트를 건너뛴다 — stdin이 닫힌 채 도는 실행이라
+          // 프롬프트가 뜨면 영원히 멈춘다.
+          const r = await exec('grok', ['plugin', 'install', grok, '--trust'])
+          if (!r.ok) fail(cli, r.output)
         } else {
           if (dryRun) {
             log(t('log.plugin.add', { cli: CLIS.opencode.label, name: opencode }))
@@ -195,6 +221,12 @@ export function defineGlobalPlugin(
           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 if (cli === 'grok') {
+          // --confirm은 한 저장소에 플러그인이 여럿일 때의 확인을 건너뛴다.
+          // config.toml [plugins].enabled의 이름은 상류가 남긴다 — 우리가
+          // 등록한 줄이라는 보장이 없어 건드리지 않는다(note에 적는다).
+          const r = await exec('grok', ['plugin', 'uninstall', pluginName, '--confirm'])
+          if (!r.ok) fail(cli, r.output)
         } else {
           const r = await exec('gemini', ['extensions', 'uninstall', pluginName])
           if (!r.ok) fail(cli, r.output)

package/lib/i18n/catalog/en.mjs

@@ -150,6 +150,7 @@ export default {
   'log.record.write': 'install record written: {path}',
   'error.recordUnreadable': 'Cannot read {path} ({code})',
   'error.recordNotJson': 'Cannot read {path} — not JSON ({message})',
+  'error.jsonInvalid': 'Cannot read {path} — invalid JSON: {message}. Fix the file by hand; nothing was written.',
   'error.recordVersion': '{path} has format version {found}. This tool uses {expected} — upgrade the tool or recreate the record.',
 
   'log.repoRoot': 'repository root: {path}',
@@ -213,6 +214,8 @@ export default {
   'status.row.items': 'items       installed   {list}',
   'status.row.recordOnly': '            record only {list}',
   'status.row.repoOnly': '            repo only   {list}',
+  'status.row.stale': '            stale check {list}',
+  'status.hint.stale': '                       → verified more than {days} days ago. Re-check upstream and update verified',
   'status.none': '(none)',
   'update.versionMove': 'pinned {pinned} → running {running}',
   'update.summary': '{updated} updated · {created} created · {drift} drifted',
@@ -232,13 +235,13 @@ export default {
   'item.unsupported.eccScale': 'upstream also supports OpenCode, Gemini and Kimi project-locally, but its skills/ holds 284 entries that would swamp the shared directory — only the plugin route is wired',
   'item.unsupported.uaUser': 'upstream install.sh clones into ~/.understand-anything and links from the home directory (user scope); the copilot plugin install offers no scope choice either',
   'item.unsupported.mattpocockRegistry': 'upstream also documents npx skills add (the shared .agents/skills), but this item wires the Claude Code plugin only',
+  'item.unsupported.unmeasuredUpstream': 'upstream has an install command, but the detect/remove path has not been verified, so it is not wired yet — you can install it by hand with the command in the upstream README',
+  'item.unsupported.noProjectMcp': 'no project-scoped MCP file — MCP is configured only in the home global (~/.gemini/config/mcp_config.json), so register it there by hand if needed',
   '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 repo-scope item superpowers (repo)',
-  '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 repo-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.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',
   'item.unsupported.gstackShared': 'the upstream --host route is user-scoped, so it is not used. In a bootstrapped repository the shared .agents/skills junction reaches this CLI instead, and it scans recursively, so it sees the individual skills too (measured 2026-08-15)',
@@ -264,8 +267,8 @@ export default {
   '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 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.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, grok plugin install superpowers@xai-official for grok. CLIs missing from this machine are skipped. Removing from grok leaves the name in ~/.grok/config.toml [plugins].enabled (upstream behavior). 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, grok plugin install DietrichGebert/ponytail for grok. 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',
@@ -273,15 +276,15 @@ export default {
   'item.plugin.understand-anything.note': 'turns the codebase into an explorable knowledge graph. The script for other CLIs clones into ~/.understand-anything (user scope), so only the plugin is wired',
   'item.skill.caveman.note': 'cuts output tokens by answering in caveman-speak; code and errors stay byte-exact. Toggle with /caveman',
   'item.skill.taste.note': 'anti-slop frontend skill for landing pages, portfolios and redesigns (skill name: design-taste-frontend)',
-  '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.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 11 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.superpowers.note': 'copies 14 skills into the shared .agents/skills so all 11 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 11 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 11 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 11 CLIs',
+  'item.skill.mattpocock-skills.note': 'copies 35 skills into the shared .agents/skills so all 11 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.prompt-master.note': 'a skill that writes and refines prompts for AI tools. Activates only when explicitly asked to write or fix a prompt. Harness-neutral body shared by all 10 CLIs',
+  'item.skill.prompt-master.note': 'a skill that writes and refines prompts for AI tools. Activates only when explicitly asked to write or fix a prompt. Harness-neutral body shared by all 11 CLIs',
   'item.skill.strix.note': 'copies 9 security-testing skills (pentesting, OWASP Top 10, vulnerability discovery and fix flows) into the shared .agents/skills. The skills drive the Strix agent, so the strix binary is required on PATH — self-hosted needs pipx install strix-agent plus Docker and STRIX_LLM/LLM_API_KEY, managed needs strix cloud login. Use only against targets you are authorized to test',
   'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally. In a bootstrapped repository .claude/skills is a junction, so the files land in the shared .agents/skills — codex and opencode scan recursively and see the individual skills too',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project — wires five runtimes in one run: claude, codex, opencode, copilot, kilo (.claude/commands, .codex/skills, .opencode/skills, .github/skills, .kilo/skills). Each runtime writes roughly 700 files. gemini was dropped upstream and kimi still blocks project installs',
@@ -307,6 +310,7 @@ export default {
   'error.itemFieldMissing': '{file}: {field} missing',
   'error.itemReasonMissing': '{id}: needs a reason for unsupported CLI \'{cli}\' (unsupported.{cli})',
   'error.shellQuote': 'The argument contains a double quote that cannot be passed to the shell: {value}',
+  'error.commandTimeout': 'stopped after {seconds}s without finishing: {command}',
 
   // TUI 탭 이름. rows.mjs의 SECTION_ORDER id(action·plugin·mcp·skill·design)를
   // 그대로 따른다 — 탭 순서·검색 스코프는 id로 갈리고, 여기서는 표시만 맡는다.
@@ -321,12 +325,16 @@ export default {
   // buildActions가 쓴다. action.*.label과 section.*는 LABEL_WIDTH(24) 안에
   // 들어야 한다 — i18n.test.mjs가 검사한다.
   'tui.counts': 'selected {picked} / {total}',
+  // 머리글의 변경 예정 건수 — Enter 전에 무슨 일이 일어날지 알린다.
+  'tui.pending': '{count} pending change(s){marks}',
+  // 0건이 아닐 때 붙는 내역. 행의 [+]·[-] 표식과 같은 글자다.
+  'tui.pendingMarks': ' (+{add} -{remove})',
   'tui.search.prefix': 'Search › ',
   'tui.search.placeholder': 'type to search · ↓ for the list',
   'tui.empty.filtered': '  Nothing matches in this tab. Press Tab to try another.',
   'tui.empty.none': '  Nothing here.',
-  'tui.hint.search': 'type to search (spaces included)   ↓ to list   Tab tab   Esc clear   Ctrl+F CLI   Ctrl+D detail',
-  'tui.hint.list': 'Space select   ↑↓ move (↑ at top = search)   Tab tab   Enter run/submit   Ctrl+A all   Ctrl+O preview   Ctrl+F CLI   Ctrl+D detail',
+  'tui.hint.search': 'type to search (spaces included)   ↓ to list   Tab tab   Esc clear   Ctrl+F CLI   Ctrl+D detail   F1 help',
+  'tui.hint.list': 'Space select   ↑↓ move   Tab tab   Enter run/submit   Ctrl+A all   Ctrl+O preview   Ctrl+F CLI   Ctrl+D detail   F1 help',
   // 힌트 줄 오른쪽 끝의 고정 자리. 나머지 힌트가 다 잘려 나가도 이 자리는 남는다.
   'tui.hint.quit': 'Ctrl+Q quit',
   'tui.review.title': 'Review — {count} change(s)',
@@ -347,6 +355,25 @@ export default {
   'tui.pressAnyKey': 'Press any key to continue…',
   'tui.confirmSuffix': ' [y/N] ',
 
+  // 도움말 화면(F1). 키마다 한 줄 — 바닥글에 담기지 않는 뜻까지 적는다.
+  'help.title': 'Keys',
+  'help.lines': [
+    '  any character · /    move up to the search box (Space is part of the query there)',
+    '  ↓ · Enter (search)   go down to the list',
+    '  ↑↓ · PgUp PgDn       move the cursor · ↑ at the top returns to the search box',
+    '  Home · End           first · last row',
+    '  Space                select/deselect — [+] to install · [-] to remove · [×] installed',
+    '  Tab · Shift+Tab · ←→  switch tabs (selections accumulate across tabs)',
+    '  Enter                run a [▶] action row; otherwise submit (review → apply all)',
+    '  Ctrl+A               select/deselect every visible item in this tab',
+    '  Ctrl+O               preview the item under the cursor (design.md opens a browser)',
+    '  Ctrl+F · Ctrl+B      cycle the CLI filter forward / backward (All → one CLI)',
+    '  Ctrl+D               expand/collapse the detail panel to full screen',
+    '  Esc                  clear the query → to the list → press again to quit',
+    '  Ctrl+Q               quit (from any screen, in one press)',
+  ],
+  'help.close': 'Press any key to go back',
+
   // 진행 화면(tui/progress.mjs) 문구. Task 9의 이벤트(start·command·done)를
   // 사람이 읽는 줄로 바꾼다. plain*은 비TTY(CI·파이프)용 한 줄 출력이다.
   'progress.title': 'Applying — {count} change(s){suffix}',
@@ -381,6 +408,8 @@ export default {
   'item.target': 'file: {path}',
   // 커버리지는 전부 지원할 때도 찍는다 — 표시가 없는 것과 "10/10"은 뜻이 다르다.
   'item.cliCoverage': 'CLI {covered}/{total}',
+  // 전역 항목의 짧은 힌트 — 이 머신에 없는 CLI를 나열에서 빼고 따로 적는다.
+  'item.cliMissing': '{list} missing',
   'item.unsupportedList': 'not wired for {count}: {groups}',
   'item.unsupportedGroup': '{clis} — {why}',
   'detail.wired': 'wired',

package/lib/i18n/catalog/ko.mjs

@@ -144,6 +144,7 @@ export default {
   'log.record.write': '설치 기록 기록: {path}',
   'error.recordUnreadable': '{path}을 읽을 수 없습니다 ({code})',
   'error.recordNotJson': '{path}을 읽을 수 없습니다 — JSON이 아닙니다 ({message})',
+  'error.jsonInvalid': '{path}을 읽을 수 없습니다 — JSON이 깨져 있습니다: {message}. 파일을 손으로 고치세요. 아무것도 쓰지 않았습니다.',
   'error.recordVersion': '{path}의 형식 버전이 {found}입니다. 이 도구는 {expected}을 씁니다 — 도구를 올리거나 기록을 다시 만드세요.',
 
   'log.repoRoot': '저장소 루트: {path}',
@@ -208,6 +209,8 @@ export default {
   'status.row.items': '항목        설치됨     {list}',
   'status.row.recordOnly': '            기록에만   {list}',
   'status.row.repoOnly': '            저장소에만 {list}',
+  'status.row.stale': '            실측 오래됨 {list}',
+  'status.hint.stale': '                       → {days}일 넘은 실측 사유입니다. 상류를 다시 확인하고 verified를 갱신하세요',
   'status.none': '(없음)',
   'update.versionMove': '고정 {pinned} → 실행 중 {running}',
   'update.summary': '갱신 {updated}건 · 신규 {created}건 · 드리프트 {drift}건',
@@ -226,12 +229,12 @@ export default {
   'item.unsupported.uaUser': '상류 install.sh가 ~/.understand-anything에 클론하고 홈에 링크를 겁니다(사용자 스코프). copilot 플러그인 설치도 스코프 선택이 없습니다',
   'item.unsupported.mattpocockRegistry': '상류가 npx skills add(공유 .agents/skills)도 안내하지만 이 항목은 Claude Code 플러그인만 배선합니다',
   'item.unsupported.upstreamNone': '상류에 공식 설치 경로가 없습니다',
+  'item.unsupported.unmeasuredUpstream': '상류에 설치 명령이 있지만 감지·제거 경로를 실측하지 못해 아직 배선하지 않습니다 — 상류 README의 명령으로 직접 설치할 수 있습니다',
+  'item.unsupported.noProjectMcp': '프로젝트 스코프 MCP 파일이 없습니다 — 홈 글로벌(~/.gemini/config/mcp_config.json)에서만 설정하므로 필요하면 그 파일에 직접 등록하세요',
   'item.unsupported.superpowersSeparate': '상류가 하니스별 별도 설치로 지원합니다 — 이 항목은 Claude Code 플러그인만 배선합니다',
   'item.unsupported.superpowersGlobalClaude': '저장소 범위 항목 superpowers (저장소)가 담당합니다',
-  '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.impeccableJunction': '상류는 지원하지만 npx impeccable install이 공유 .agents/skills 연결을 끊어 플러그인 경로만 배선합니다',
   'item.unsupported.gstackHost': '상류는 ./setup --host로 지원합니다 — 이 항목은 Claude Code에만 설치합니다',
   'item.unsupported.gstackShared': '상류 --host 경로는 사용자 스코프라 쓰지 않습니다. 대신 부트스트랩 저장소에서는 공유 .agents/skills Junction으로 닿고, 이 CLI는 재귀 스캔이라 개별 스킬까지 봅니다(2026-08-15 실측)',
@@ -257,8 +260,8 @@ export default {
   '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·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.global.superpowers.note': 'superpowers를 하니스별 공식 명령으로 사용자 전역에 설치합니다 — codex·copilot은 마켓플레이스, gemini는 extensions, opencode는 전역 opencode.json, grok은 grok plugin install superpowers@xai-official. 이 머신에 없는 CLI는 건너뜁니다. grok 제거는 ~/.grok/config.toml [plugins].enabled의 이름을 남깁니다(상류 동작). skill.superpowers와 함께 켜면 겹치는 CLI는 같은 스킬을 두 곳에서 봅니다',
+  'item.global.ponytail.note': 'Ponytail을 하니스별 공식 명령으로 사용자 전역에 설치합니다 — codex·copilot은 마켓플레이스(DietrichGebert/ponytail), gemini는 extensions, grok은 grok plugin install DietrichGebert/ponytail. 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개가 들어 있어 공유 스킬 디렉터리에 복사하지 않고 플러그인으로 설치합니다',
@@ -266,15 +269,15 @@ export default {
   'item.plugin.understand-anything.note': '코드베이스를 탐색 가능한 지식 그래프로 만듭니다. 다른 CLI용 스크립트는 ~/.understand-anything에 클론하는 사용자 스코프라 플러그인만 배선합니다',
   'item.skill.caveman.note': '원시인 말투로 답해 출력 토큰을 줄입니다. 코드와 오류는 그대로 둡니다. /caveman으로 켜고 끕니다',
   'item.skill.taste.note': '랜딩 페이지·포트폴리오·리디자인용 안티슬롭 프런트엔드 스킬 (스킬 이름: design-taste-frontend)',
-  'item.skill.hallmark.note': '네 가지 동사(신규 제작·audit·redesign·study)를 갖춘 안티 AI슬롭 디자인 스킬. 테마 21종과 슬롭 테스트 57종. 상류는 Cursor·Codex 경로도 안내하지만 공유 스킬 디렉터리 하나로 10개 CLI가 함께 봅니다',
+  'item.skill.hallmark.note': '네 가지 동사(신규 제작·audit·redesign·study)를 갖춘 안티 AI슬롭 디자인 스킬. 테마 21종과 슬롭 테스트 57종. 상류는 Cursor·Codex 경로도 안내하지만 공유 스킬 디렉터리 하나로 11개 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.superpowers.note': '공유 .agents/skills에 스킬 14종을 복사해 11개 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가 제공합니다. 본문이 하네스 중립이라 11개 CLI가 함께 씁니다(allowed-tools 줄만 Claude 문법)',
+  'item.skill.find-skills.note': '공개 스킬 레지스트리를 검색해 설치를 안내하는 스킬. npx skills 명령만 지시하는 하네스 중립 문서라 11개 CLI가 함께 씁니다',
+  'item.skill.mcp-builder.note': 'MCP 서버 제작 가이드(Python FastMCP·Node MCP SDK). reference/ 문서 4종과 Apache-2.0 LICENSE.txt가 스킬 디렉터리에 함께 복사됩니다. 내용이 하네스 중립이라 11개 CLI가 함께 씁니다',
+  'item.skill.mattpocock-skills.note': '공유 .agents/skills에 스킬 35종을 복사해 11개 CLI가 함께 봅니다. 상류가 직접 안내하는 경로이며 훅이 없어 플러그인 판에 견줘 잃는 것이 없습니다. 둘 중 하나만 고를 수 있습니다',
   'item.skill.karpathy.note': '과설계와 모호한 완료 기준을 줄이는 행동 지침',
-  'item.skill.prompt-master.note': 'AI 도구용 프롬프트를 만들고 다듬는 스킬. 프롬프트 작성·수정을 명시적으로 요청할 때만 활성화됩니다. 본문이 하네스 중립이라 10개 CLI가 함께 씁니다',
+  'item.skill.prompt-master.note': 'AI 도구용 프롬프트를 만들고 다듬는 스킬. 프롬프트 작성·수정을 명시적으로 요청할 때만 활성화됩니다. 본문이 하네스 중립이라 11개 CLI가 함께 씁니다',
   'item.skill.strix.note': '보안 테스트 스킬 9종(침투 테스트·OWASP Top 10·취약점 탐지와 수정 흐름)을 공유 .agents/skills에 복사합니다. 스킬이 Strix 에이전트를 구동하므로 PATH에 strix 바이너리가 필요합니다 — 자체 호스팅은 pipx install strix-agent에 Docker와 STRIX_LLM·LLM_API_KEY, 관리형은 strix cloud login. 승인된 대상에만 쓰세요',
   'item.skill.gstack.note': '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음. 부트스트랩 저장소에서는 .claude/skills가 Junction이라 실물이 공유 .agents/skills에 앉습니다 — codex·opencode는 재귀 스캔이라 개별 스킬까지 함께 봅니다',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core 프로젝트 로컬 설치 — claude·codex·opencode·copilot·kilo 다섯 런타임을 한 번에 배선합니다(.claude/commands, .codex/skills, .opencode/skills, .github/skills, .kilo/skills). 런타임마다 700개 안팎의 파일이 생깁니다. gemini는 상류가 제거했고 kimi는 프로젝트 설치를 아직 막습니다',
@@ -299,6 +302,7 @@ export default {
   'error.itemFieldMissing': '{file}: {field} 누락',
   'error.itemReasonMissing': '{id}: 미지원 CLI \'{cli}\'의 사유(unsupported.{cli})가 필요합니다',
   'error.shellQuote': '셸에 넘길 수 없는 큰따옴표가 인자에 있습니다: {value}',
+  'error.commandTimeout': '{seconds}초 안에 끝나지 않아 중단했습니다: {command}',
 
   // TUI 탭 이름. en.mjs 쪽 주석 참고. PLUGIN·MCP·SKILL·DESIGN.MD는 형식·브랜드
   // 이름이라 번역하지 않는다 — 두 로케일에서 값이 같은 게 맞다.
@@ -311,12 +315,16 @@ export default {
 
   // TUI 목록·검토 화면 문구. en.mjs 쪽 주석 참고.
   'tui.counts': '선택 {picked} / 전체 {total}',
+  // 머리글의 변경 예정 건수 — Enter 전에 무슨 일이 일어날지 알린다.
+  'tui.pending': '변경 예정 {count}건{marks}',
+  // 0건이 아닐 때 붙는 내역. 행의 [+]·[-] 표식과 같은 글자다.
+  'tui.pendingMarks': ' (+{add} -{remove})',
   'tui.search.prefix': '검색 › ',
   'tui.search.placeholder': '타이핑하면 검색 · ↓ 로 목록',
   'tui.empty.filtered': '  이 탭에는 일치하는 항목이 없습니다. Tab으로 다른 탭을 보세요.',
   'tui.empty.none': '  항목이 없습니다.',
-  'tui.hint.search': '입력=검색어   ↓ 목록으로   Tab 탭이동   Esc 검색해제   Ctrl+F CLI   Ctrl+D 상세',
-  'tui.hint.list': 'Space 선택   ↑↓ 이동   Tab 탭   Enter 실행/제출   Ctrl+A 전체   Ctrl+O 미리보기   Ctrl+F CLI   Ctrl+D 상세',
+  'tui.hint.search': '입력=검색어   ↓ 목록으로   Tab 탭이동   Esc 검색해제   Ctrl+F CLI   Ctrl+D 상세   F1 도움말',
+  'tui.hint.list': 'Space 선택   ↑↓ 이동   Tab 탭   Enter 실행/제출   Ctrl+A 전체   Ctrl+O 미리보기   Ctrl+F CLI   Ctrl+D 상세   F1 도움말',
   // 힌트 줄 오른쪽 끝의 고정 자리. en.mjs 쪽 주석 참고.
   'tui.hint.quit': 'Ctrl+Q 종료',
   'tui.review.title': '제출 검토 — 변경 {count}건',
@@ -337,6 +345,25 @@ export default {
   'tui.pressAnyKey': '계속하려면 아무 키나 누르세요…',
   'tui.confirmSuffix': ' [y/N] ',
 
+  // 도움말 화면(F1). 키마다 한 줄 — 바닥글에 담기지 않는 뜻까지 적는다.
+  'help.title': '키 안내',
+  'help.lines': [
+    '  아무 글자 · /        검색칸으로 올라가 검색 (검색칸에서는 Space도 검색어)',
+    '  ↓ · Enter (검색칸)   목록으로 내려간다',
+    '  ↑↓ · PgUp PgDn       커서 이동 · 맨 위에서 ↑는 검색칸으로',
+    '  Home · End           목록 처음 · 끝',
+    '  Space                선택/해제 — [+] 설치 예정 · [-] 제거 예정 · [×] 설치됨',
+    '  Tab · Shift+Tab · ←→  탭 이동 (선택은 탭을 넘나들며 누적)',
+    '  Enter                [▶] 작업 행은 실행, 그 밖에는 제출(검토 → 일괄 적용)',
+    '  Ctrl+A               지금 탭에서 보이는 항목 전체 선택/해제',
+    '  Ctrl+O               커서 항목 미리보기 (design.md는 브라우저)',
+    '  Ctrl+F · Ctrl+B      CLI 필터 앞 / 뒤로 (전체 → CLI 하나씩)',
+    '  Ctrl+D               상세 패널 전체 화면 펼치기/접기',
+    '  Esc                  검색어 지우기 → 목록으로 → 한 번 더 누르면 종료',
+    '  Ctrl+Q               종료 (어느 화면에서나 한 번에)',
+  ],
+  'help.close': '아무 키나 누르면 돌아갑니다',
+
   // 진행 화면(tui/progress.mjs) 문구. en.mjs 쪽 주석 참고.
   'progress.title': '적용 중 — 변경 {count}건{suffix}',
   'progress.counter': '{done}/{total}  {percent}%',
@@ -368,6 +395,8 @@ export default {
   'item.target': '대상 파일: {path}',
   // en.mjs 쪽 주석 참고.
   'item.cliCoverage': 'CLI {covered}/{total}',
+  // 전역 항목의 짧은 힌트 — 이 머신에 없는 CLI를 나열에서 빼고 따로 적는다.
+  'item.cliMissing': '{list} 없음',
   'item.unsupportedList': '미배선 {count}곳: {groups}',
   'item.unsupportedGroup': '{clis} — {why}',
   'detail.wired': '배선',