@rch4com/agent-setup 1.16.0 → 1.18.0

package/install.mjs

@@ -6,6 +6,7 @@ import { withDeps } from './lib/deps.mjs'
 import { LocalizedError, createT, isLocaleForced, resolveLocale, toText } from './lib/i18n/index.mjs'
 import { detectLocale } from './lib/i18n/detect.mjs'
 import { labelWidth, pad } from './lib/width.mjs'
+import { scopedLabel } from './lib/labels.mjs'
 import {
   bootstrapUsage, designUsage, rootUsage, statusUsage, updateUsage,
   parseBootstrapArgs, parseDesignArgs, parseRootArgs, parseStatusArgs, parseUpdateArgs, preScanLang,
@@ -60,7 +61,7 @@ async function runClassic(root, { dryRun, listOnly, setArg, t }) {
   if (listOnly) {
     for (const s of states) {
       const detail = toText(t, s.detail)
-      console.log(`${pad(t(`status.${s.status}`), statusWidth)} ${s.item.id} — ${s.item.label}${detail ? ` (${detail})` : ''}`)
+      console.log(`${pad(t(`status.${s.status}`), statusWidth)} ${s.item.id} — ${scopedLabel(s.item, t)}${detail ? ` (${detail})` : ''}`)
     }
     return
   }
@@ -97,12 +98,12 @@ async function runClassic(root, { dryRun, listOnly, setArg, t }) {
     },
   })
   for (const r of results) {
-    console.log(`${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${r.item.label}${r.message ? ` — ${toText(t, r.message)}` : ''}`)
+    console.log(`${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${scopedLabel(r.item, t)}${r.message ? ` — ${toText(t, r.message)}` : ''}`)
   }
 
   const after = await scan(root, items)
   console.log(`\n${t('apply.finalState')}`)
-  for (const s of after) console.log(`  ${pad(t(`status.${s.status}`), statusWidth)} ${s.item.label}`)
+  for (const s of after) console.log(`  ${pad(t(`status.${s.status}`), statusWidth)} ${scopedLabel(s.item, t)}`)
   console.log(`\n${t('apply.seeGitDiff')}`)
   if (results.some((r) => !r.ok)) process.exitCode = 1
 }

package/lib/i18n/catalog/en.mjs

@@ -234,12 +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.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 project-scope item {item}',
+  '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.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',
   '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)',
@@ -282,6 +281,8 @@ export default {
   '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.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.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',
   // 커밋 템플릿은 CLI 배선이 아니라 저장소 규약이다 — note가 "무엇이 놓이고
@@ -331,11 +332,13 @@ export default {
   'tui.review.title': 'Review — {count} change(s)',
   'tui.review.more': '  …and {count} more',
   'tui.review.hint': 'Enter apply   Esc cancel   Ctrl+Q quit',
+  'tui.review.globalWarning': '{count} machine-global change(s) — settings outside this repo (~/.codex etc.) will change',
   'tui.notItemRow': 'Press Enter to run this row.',
   'tui.noPreview': 'This item has no preview.',
   'tui.opened': 'Opened: {target}',
   'tui.noChanges': 'Nothing to change.',
   'tui.submitCancelled': 'Submission cancelled.',
+  'tui.selectedGlobal': 'Machine-global item — applies to this whole computer',
   'tui.toggledAll': 'Selected every visible item in the {tab} tab.',
   'tui.toggledNone': 'Cleared every visible item in the {tab} tab.',
   // 배타 묶음에서 형제가 함께 꺼졌을 때. 조용히 뒤집히면 오조작으로 읽힌다.
@@ -373,6 +376,8 @@ export default {
   'tui.filter.empty': '  Nothing in this tab is wired for {cli}.',
 
   'item.location.user': 'installs to: user global',
+  'label.scope.project': '(repo)',
+  'label.scope.user': '(global)',
   'item.target': 'file: {path}',
   // 커버리지는 전부 지원할 때도 찍는다 — 표시가 없는 것과 "10/10"은 뜻이 다르다.
   'item.cliCoverage': 'CLI {covered}/{total}',
@@ -413,6 +418,9 @@ export default {
   // 대상 파일이 하나뿐인 배타 묶음이라 라디오 표시와 짝이 된다.
   'category.commit': 'Commit template · .gitmessage.txt · pick one',
   'category.service': 'External services',
+  // PLUGIN 탭 전용 범위 그룹 — 검토 화면(renderReview)의 소제목도 같은 키를 쓴다.
+  'category.scope-project': 'Repo scope — this repository only',
+  'category.scope-user': 'Machine global — applies to this whole computer',
   'design.localSuffix': '{id} (local)',
   'design.localTag': 'local',
   'design.unknownItem': '  unknown item: {token}',

package/lib/i18n/catalog/ko.mjs

@@ -227,12 +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.superpowersGlobalClaude': '저장소 범위 항목 superpowers (저장소)가 담당합니다',
   'item.unsupported.superpowersGlobalGrok': '상류 6.3.0에 grok plugin install superpowers@xai-official 명령이 있지만 감지·제거 경로를 실측하지 못해 아직 배선하지 않습니다',
   'item.unsupported.superpowersGlobalKimi': '상류 설치가 대화형 /plugins 명령뿐이라 헤드리스 경로가 없습니다',
-  'item.unsupported.globalProjectItem': '프로젝트 스코프 항목 {item}이 담당합니다',
+  '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에만 설치합니다',
   'item.unsupported.gstackShared': '상류 --host 경로는 사용자 스코프라 쓰지 않습니다. 대신 부트스트랩 저장소에서는 공유 .agents/skills Junction으로 닿고, 이 CLI는 재귀 스캔이라 개별 스킬까지 봅니다(2026-08-15 실측)',
@@ -275,6 +274,8 @@ export default {
   '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.prompt-master.note': 'AI 도구용 프롬프트를 만들고 다듬는 스킬. 프롬프트 작성·수정을 명시적으로 요청할 때만 활성화됩니다. 본문이 하네스 중립이라 10개 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는 프로젝트 설치를 아직 막습니다',
   // 커밋 템플릿은 CLI 배선이 아니라 저장소 규약이다 — en.mjs 쪽 주석 참고.
@@ -321,11 +322,13 @@ export default {
   'tui.review.title': '제출 검토 — 변경 {count}건',
   'tui.review.more': '  …외 {count}건',
   'tui.review.hint': 'Enter 적용   Esc 취소   Ctrl+Q 종료',
+  'tui.review.globalWarning': '머신 전역 변경 {count}건 — 이 저장소 밖 설정(~/.codex 등)이 바뀝니다',
   'tui.notItemRow': '이 행은 Enter로 실행합니다.',
   'tui.noPreview': '이 항목은 미리보기를 제공하지 않습니다.',
   'tui.opened': '열었습니다: {target}',
   'tui.noChanges': '변경할 항목이 없습니다.',
   'tui.submitCancelled': '제출을 취소했습니다.',
+  'tui.selectedGlobal': '머신 전역 항목 — 이 컴퓨터 전체에 적용됩니다',
   'tui.toggledAll': '{tab} 탭의 보이는 항목을 모두 선택했습니다.',
   'tui.toggledNone': '{tab} 탭의 보이는 항목을 모두 해제했습니다.',
   // 배타 묶음에서 형제가 함께 꺼졌을 때. en.mjs 쪽 주석 참고.
@@ -360,6 +363,8 @@ export default {
   'tui.filter.empty': '  이 탭에는 {cli}에 배선되는 항목이 없습니다.',
 
   'item.location.user': '설치 위치: 사용자 글로벌',
+  'label.scope.project': '(저장소)',
+  'label.scope.user': '(전역)',
   'item.target': '대상 파일: {path}',
   // en.mjs 쪽 주석 참고.
   'item.cliCoverage': 'CLI {covered}/{total}',
@@ -398,6 +403,9 @@ export default {
   // 헤더 하나가 무엇을 고르는 자리이고 규칙이 무엇인지 함께 말한다. en.mjs 쪽 주석 참고.
   'category.commit': '커밋 메시지 템플릿 · .gitmessage.txt · 하나만 고릅니다',
   'category.service': '외부 서비스',
+  // PLUGIN 탭 전용 범위 그룹 — 검토 화면(renderReview)의 소제목도 같은 키를 쓴다.
+  'category.scope-project': '저장소 범위 — 이 저장소에만 적용',
+  'category.scope-user': '머신 전역 — 이 컴퓨터 전체에 적용',
   'design.localSuffix': '{id} (로컬)',
   'design.localTag': '로컬',
   'design.unknownItem': '  알 수 없는 항목: {token}',

package/lib/items/global.ponytail.mjs

@@ -28,7 +28,7 @@ import { msg } from '../i18n/index.mjs'
 const SUPPORTS = ['codex', 'gemini', 'copilot']
 
 const CONFIG = {
-  id: 'global.ponytail', label: 'Ponytail (global)', group: '__token',
+  id: 'global.ponytail', label: 'Ponytail', group: '__token',
   note: 'item.global.ponytail.note',
   pluginName: 'ponytail',
   marketplaceRepo: 'DietrichGebert/ponytail',

package/lib/items/global.superpowers.mjs

@@ -26,7 +26,7 @@ import { msg } from '../i18n/index.mjs'
 const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot']
 
 const CONFIG = {
-  id: 'global.superpowers', label: 'superpowers (global)', group: '__flow',
+  id: 'global.superpowers', label: 'superpowers', group: '__flow',
   note: 'item.global.superpowers.note',
   pluginName: 'superpowers',
   marketplaceRepo: 'obra/superpowers-marketplace',

package/lib/items/plugin.mattpocock-skills.mjs

@@ -7,7 +7,7 @@ import { msg } from '../i18n/index.mjs'
 // 아니라 "우리가 플러그인 쪽을 골랐다"이고, 사유가 그렇게 말해야 레지스트리
 // 항목으로 옮길 수 있다는 것도 화면에서 읽힌다.
 export default definePlugin({
-  id: 'plugin.mattpocock-skills', label: 'Matt Pocock (plugin)', group: '__flow',
+  id: 'plugin.mattpocock-skills', label: 'Matt Pocock', group: '__flow',
   exclusive: 'mattpocock',
   installId: 'mattpocock-skills@mattpocock',
   detectIds: ['mattpocock-skills@mattpocock'],

package/lib/items/plugin.superpowers.mjs

@@ -13,7 +13,7 @@ import { msg } from '../i18n/index.mjs'
 const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok']
 
 export default definePlugin({
-  id: 'plugin.superpowers', label: 'superpowers (plugin)', group: '__flow',
+  id: 'plugin.superpowers', label: 'superpowers', group: '__flow',
   exclusive: 'superpowers',
   installId: 'superpowers@claude-plugins-official',
   detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],

package/lib/items/skill.prompt-master.mjs

@@ -0,0 +1,7 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+export default defineRegistrySkill({
+  id: 'skill.prompt-master', label: 'Prompt Master', group: '__flow',
+  source: 'https://github.com/nidhinjs/prompt-master',
+  skill: 'prompt-master',
+  note: 'item.skill.prompt-master.note',
+})

package/lib/items/skill.strix.mjs

@@ -0,0 +1,12 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// 상류가 skills/에 SKILL.md 9종을 두고 npx skills add usestrix/strix를 README로
+// 직접 안내한다. 스킬 본문은 strix CLI를 구동하는 지침이라 바이너리가 사실상
+// 전제다 — note가 알린다. 2026-09-02 스크래치 저장소에서 9종 설치와
+// skills-lock.json의 source(usestrix/strix) 기록을 실측했다.
+export default defineRegistrySkill({
+  id: 'skill.strix', label: 'Strix', group: '__service',
+  source: 'https://github.com/usestrix/strix',
+  skill: '*',
+  anchor: 'penetration-testing-with-strix',
+  note: 'item.skill.strix.note',
+})

package/lib/labels.mjs

@@ -0,0 +1,9 @@
+// 플러그인 항목 라벨에 설치 범위 접미사를 붙인다. 목록 밖(검토·진행·결과
+// 화면)에는 범위 그룹 헤더가 없어, 같은 이름의 두 판(superpowers 저장소/전역)을
+// 이 접미사만이 가른다. import가 없는 잎 모듈이어야 한다 — install.mjs가
+// 정적으로 당기므로, 의존성이 들어오면 npm install 없이 도는 부트스트랩
+// (bootstrap.isolation.test.mjs)이 깨진다.
+export function scopedLabel(item, t) {
+  if (item?.category !== 'plugin') return item?.label ?? ''
+  return `${item.label} ${t(`label.scope.${item.scope ?? 'project'}`)}`
+}

package/lib/tui/progress.mjs

@@ -4,6 +4,7 @@
 // 실제 시간에 묶여 "14초 경과"를 검증할 방법이 없다.
 import { createT } from '../i18n/index.mjs'
 import { cut, labelWidth, pad, width } from '../width.mjs'
+import { scopedLabel } from '../labels.mjs'
 
 const ESC = String.fromCharCode(27)
 const DIM = `${ESC}[2m`
@@ -66,7 +67,7 @@ function entryLines(entry, w, actionWidth, now, t) {
     tail = `  ${t('progress.skipped')}`
   }
   const mark = MARK[entry.state] ?? ' '
-  const out = [cut(`${mark} ${pad(t(`change.${entry.action}`), actionWidth)} ${entry.item.label}${tail}`, w)]
+  const out = [cut(`${mark} ${pad(t(`change.${entry.action}`), actionWidth)} ${scopedLabel(entry.item, t)}${tail}`, w)]
   // 명령은 실행 중일 때만. 끝난 뒤에도 남기면 화면이 명령 목록이 된다.
   if (entry.state === 'running' && entry.command) out.push(cut(`      ${entry.command}`, w))
   return out
@@ -150,7 +151,7 @@ export function plainLine(event, t = createT('en')) {
       index: event.index + 1,
       total: event.total,
       action: t(`change.${event.action}`),
-      label: event.item.label,
+      label: scopedLabel(event.item, t),
     })
   }
   if (event.phase === 'done') {

package/lib/tui/render.mjs

@@ -6,6 +6,7 @@ import { createT } from '../i18n/index.mjs'
 import { categoryLabel } from '../design-md/flow.mjs'
 import { cut, pad, width } from '../width.mjs'
 import { detailLines } from './detail.mjs'
+import { scopedLabel } from '../labels.mjs'
 
 // 폭 계산은 화면 전용이 아니다 — 비대화형 목록도 같은 열 맞춤이 필요해
 // lib/width.mjs에 있다. 여기서 다시 내보내는 것은 호출부(테스트 포함)가
@@ -244,23 +245,61 @@ export function renderReview(changes, opts = {}) {
   const title = `${t('tui.review.title', { count: changes.length })}${dryRun ? ' (dry-run)' : ''}`
   const lines = [color ? `${BOLD}${cut(title, w)}${RESET}` : cut(title, w), '']
 
-  const body = reviewBodyHeight(height)
-  const room = Math.max(1, body - 1)
-  const shown = changes.slice(0, room)
-  for (const c of shown) {
-    // 적용 직전 마지막 화면이다. 일부 CLI에만 들어가는 항목은 여기서도 그 사실을
-    // 밝힌다 — 목록에서 지나쳤더라도 되돌릴 수 있는 마지막 지점이다.
-    // 전부 지원하는 항목은 조용히 둔다: 경고가 흔해지면 아무도 읽지 않는다.
+  // 적용 직전 마지막 화면이다. 일부 CLI에만 들어가는 항목은 여기서도 그 사실을
+  // 밝힌다 — 목록에서 지나쳤더라도 되돌릴 수 있는 마지막 지점이다.
+  // 전부 지원하는 항목은 조용히 둔다: 경고가 흔해지면 아무도 읽지 않는다.
+  const changeLine = (c) => {
     const partial = c.item.supports && c.item.supports.length < CLI_IDS.length
     const cov = partial ? ` · ${t('item.cliCoverage', { covered: c.item.supports.length, total: CLI_IDS.length })}` : ''
-    lines.push(cut(`  ${CHANGE_MARK[c.action] ?? '?'} ${pad(t(`change.${c.action}`), 10)} ${c.item.label}${cov}`, w))
+    return cut(`  ${CHANGE_MARK[c.action] ?? '?'} ${pad(t(`change.${c.action}`), 10)} ${scopedLabel(c.item, t)}${cov}`, w)
+  }
+
+  // 전역 변경이 있을 때만 범위로 가른다 — 전부 저장소 범위인 흔한 경우에
+  // 소제목은 잡음이다. 가를 때는 저장소 묶음이 먼저다(목록 화면과 같은 순서).
+  const globals = changes.filter((c) => c.item.scope === 'user')
+  const split = globals.length > 0
+  const groups = split
+    ? [
+      { header: t('category.scope-project'), list: changes.filter((c) => c.item.scope !== 'user') },
+      { header: t('category.scope-user'), list: globals },
+    ].filter((g) => g.list.length > 0)
+    : [{ header: null, list: changes }]
+
+  // 소제목·경고 줄이 목록 지면을 갉아먹는다 — 그만큼 떼어 두지 않으면
+  // "…외 N건" 판정이 어긋나 화면이 넘친다. 지면이 소제목까지 감당 못 하면
+  // 소제목을 버리고 경고만 남긴다 — 경고가 범위 사실을 말하는 최후의 줄이고,
+  // 화면이 넘치면 alt 화면 전체가 밀린다.
+  const body = reviewBodyHeight(height)
+  let overhead = split ? groups.length + 1 : 0
+  let showHeaders = split
+  if (split && body - 1 - overhead < 1) {
+    showHeaders = false
+    overhead = 1
+  }
+  const room = Math.max(1, body - 1 - overhead)
+
+  let quota = room
+  for (const g of groups) {
+    // 소제목 지면조차 없으면 위에서 이미 강등돼(showHeaders=false) 이
+    // 지점에 오지 않는다 — 여기 온다는 건 소제목 지면은 남았다는 뜻이고,
+    // 그때는 목록 지면(quota)이 다해도 소제목만은 낸다: 전역 묶음이
+    // 통째로 잘리더라도 그 평면이 있다는 사실은 화면에 남아야 한다
+    // (경고 줄이 건수를 마저 말한다).
+    if (showHeaders && g.header !== null) lines.push(paint(DIM, cut(`  ${g.header}`, w)))
+    for (const c of g.list) {
+      if (quota <= 0) break
+      lines.push(changeLine(c))
+      quota--
+    }
   }
-  if (changes.length > shown.length) {
-    lines.push(paint(DIM, cut(t('tui.review.more', { count: changes.length - shown.length }), w)))
+  const shown = room - quota
+  if (changes.length > shown) {
+    lines.push(paint(DIM, cut(t('tui.review.more', { count: changes.length - shown }), w)))
   } else {
     lines.push('')
   }
-  for (let i = shown.length + 1; i < body; i++) lines.push('')
+  if (split) lines.push(paint(DIM, cut(t('tui.review.globalWarning', { count: globals.length }), w)))
+  while (lines.length < 2 + body) lines.push('')
 
   lines.push('')
   lines.push(paint(DIM, cut(t('tui.review.hint'), w)))

package/lib/tui/rows.mjs

@@ -12,6 +12,7 @@ import { loadCatalog, buildItems, netFetch, CATALOG_PATH } from '../design-md/ca
 import { discoverSources, extraDirsFromEnv } from '../design-md/scan.mjs'
 import { refreshCatalog, updateInstalled, findStale, categoryLabel } from '../design-md/flow.mjs'
 import { unsupportedGroups } from './detail.mjs'
+import { scopedLabel } from '../labels.mjs'
 
 // 섹션은 탭 이름이자 정렬 키이자 state.tabs의 원소다. 표시 문자열을 그대로
 // 쓰면 번역하는 순간 정렬이 깨진다 — id를 두고 render.mjs가 표시할 때만
@@ -29,7 +30,7 @@ export const SECTION_ORDER = [ACTION_SECTION, 'plugin', 'mcp', 'skill', 'config'
 // __commit은 CONFIG 탭에만 나오지만 규칙은 같다 — 헤더가 "무엇을 고르는
 // 자리인가"를 말한다. 커밋 템플릿은 대상 파일이 하나뿐이라 헤더에 그 파일
 // 이름과 "하나만"이라는 규칙까지 실어, 라디오 표시와 함께 읽히게 한다.
-export const GROUP_ORDER = ['__token', '__context', '__style', '__flow', '__commit', '__service']
+export const GROUP_ORDER = ['__scope-project', '__scope-user', '__token', '__context', '__style', '__flow', '__commit', '__service']
 
 function groupRank(group) {
   const i = GROUP_ORDER.indexOf(group)
@@ -109,7 +110,10 @@ export function designHint(state, multiProvider = false, t) {
 export function agentShortHint(item, state, t = createT('en')) {
   const parts = []
   if (state.status !== 'absent') parts.push(t(`status.${state.status}`))
-  if (item.supports) parts.push(t('item.cliCoverage', { covered: item.supports.length, total: CLI_IDS.length }))
+  // plugin은 수 대신 이름을 나열한다 — 어느 CLI에 설치되는가가 이 탭에서
+  // 고르는 기준이고, 가장 긴 나열(codex·gemini·opencode·copilot)도 자리에 든다.
+  if (item.category === 'plugin' && item.supports?.length) parts.push(item.supports.join('·'))
+  else if (item.supports) parts.push(t('item.cliCoverage', { covered: item.supports.length, total: CLI_IDS.length }))
   return parts.join(' · ')
 }
 
@@ -235,8 +239,13 @@ export function buildRows({ actions = [], agentStates = [], designStates = [], m
       itemRow({
         id: s.item.id,
         section: s.item.category,
-        group: s.item.group ?? null,
-        label: s.item.label,
+        // plugin 탭은 성격이 아니라 설치 범위로 가른다 — 같은 상류의 두 판
+        // (저장소/전역)이 무엇을 건드리는지가 이 탭에서 고르는 기준이다.
+        // 표시 계층의 오버라이드다: 항목의 group 필드는 성격의 진실로 남는다.
+        group: s.item.category === 'plugin'
+          ? (s.item.scope === 'user' ? '__scope-user' : '__scope-project')
+          : s.item.group ?? null,
+        label: scopedLabel(s.item, t),
         hint: agentShortHint(s.item, s, t),
         fullHint: agentHint(s.item, s, t),
         statusDetail: toText(t, s.detail) ?? null,

package/lib/tui/run.mjs

@@ -14,6 +14,7 @@ import {
 } from './state.mjs'
 import { render, renderReview, bodyHeight } from './render.mjs'
 import { createProgress, applyEvent, progressLines } from './progress.mjs'
+import { scopedLabel } from '../labels.mjs'
 
 const ESC = String.fromCharCode(27)
 const HIDE_CURSOR = `${ESC}[?25l`
@@ -183,6 +184,9 @@ export async function runTui(root, opts = {}) {
     // 화면 밖에 있을 때는 아예 무슨 일이 일어났는지 볼 수조차 없다.
     const dropped = state.rows.filter((r) => r.id !== row.id && before.has(r.id) && !state.selected.has(r.id))
     if (dropped.length > 0) return t('tui.exclusiveSwitched', { kept: row.label, dropped: dropped.map((r) => r.label).join(', ') })
+    // 전역 항목을 막 켰다면 알린다 — 이 체크 하나가 저장소 밖을 건드린다.
+    // 배타 전환 메시지가 우선한다: 상태줄은 한 줄뿐이고 선택이 뒤집힌 쪽이 급하다.
+    if (row.item?.scope === 'user' && state.selected.has(row.id) && !before.has(row.id)) return t('tui.selectedGlobal')
     return ''
   }
 
@@ -373,7 +377,7 @@ export async function runTui(root, opts = {}) {
             log('')
             for (const r of notable) {
               const message = toText(t, r.message)
-              log(`  ${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${r.item.label}${message ? ` — ${message}` : ''}`)
+              log(`  ${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${scopedLabel(r.item, t)}${message ? ` — ${message}` : ''}`)
             }
           }
           log(`\n${t('apply.seeGitDiff')}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",

package/lib/items/plugin.bkit.mjs

@@ -1,25 +0,0 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
-
-// 상류의 Codex·Gemini 지원은 이 플러그인이 아니라 별도 리포의 독립 포팅본이다
-// (bkit-codex: install 스크립트+MCP, 기능 241개 중 80개, hooks 없음 /
-// bkit-gemini: Gemini CLI extension). 플러그인 항목을 재사용할 수 없어 사유만 남긴다.
-// 예전에 "Gemini판은 Antigravity 승계 추정"이라 적었는데 근거가 없었다 —
-// bkit-gemini는 v2.0.7까지 Gemini CLI 확장 그대로이고 README에 Antigravity가
-// 한 번도 나오지 않는다. 다만 최종 푸시가 2026-05-20이라 Gemini CLI 종료
-// (2026-06-18) 이후로는 갱신이 없다. 추정 대신 그 사실만 적는다(2026-08-15 실측).
-const PORTS = ['codex', 'gemini']
-
-export default definePlugin({
-  id: 'plugin.bkit', label: 'bkit', group: '__flow',
-  installId: 'bkit@bkit-marketplace',
-  detectIds: ['bkit@bkit-marketplace'],
-  marketplace: { name: 'bkit-marketplace', repo: 'popup-studio-ai/bkit-claude-code' },
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      PORTS.includes(c) ? msg('item.unsupported.bkitPort') : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-})