@rch4com/agent-setup 1.17.0 → 1.19.0

package/lib/items/global.superpowers.mjs

@@ -14,31 +14,37 @@ import { msg } from '../i18n/index.mjs'
 //   opencode— 상류 .opencode/INSTALL.md가 전역 opencode.json의 plugin 배열에
 //             아래 항목 한 줄을 더하라고 안내한다.
 //
-// grok은 상류 명령(grok plugin install superpowers@xai-official --trust)이
-// 있지만 감지·제거 경로를 실측할 CLI가 없어 아직 배선하지 않고, kimi는 설치가
-// 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트 스코프 항목
-// (plugin.superpowers)의 자리다.
+//   grok    — 2026-09-05 이 머신(grok 1.0.5)에서 `grok plugin install
+//             superpowers@xai-official --trust`로 설치·감지·제거 왕복을 실측.
+//             기록은 ~/.grok/installed-plugins/registry.json(global-plugin.mjs).
+//
+// kimi는 설치가 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트
+// 스코프 항목(plugin.superpowers)의 자리다.
 //
 // skill.superpowers(공유 .agents/skills)와 배타로 묶지 않는다 — 저쪽은 이
 // 저장소에만, 이쪽은 머신 전체에 작용해 평면이 다르고, "claude는 프로젝트
 // 플러그인 + 나머지는 전역" 같은 조합이 정당하다. 겹치는 하니스가 같은 스킬을
 // 두 곳에서 본다는 것은 note에 적어 둔다.
-const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot']
+const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot', 'grok']
 
 const CONFIG = {
   id: 'global.superpowers', label: 'superpowers', group: '__flow',
   note: 'item.global.superpowers.note',
+  verified: '2026-09-05',
   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',
+  grok: 'superpowers@xai-official',
   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')
+      // 상류 README가 Antigravity 설치를 안내하지만 감지·제거 경로를 실측할
+      // CLI가 없다 — grok과 같은 기준으로 아직 배선하지 않는다.
+      : c === 'antigravity' ? msg('item.unsupported.unmeasuredUpstream')
       : msg('item.unsupported.upstreamNone'),
     ]),
   ),

package/lib/items/plugin.ecc.mjs

@@ -17,6 +17,7 @@ export default definePlugin({
   detectIds: ['ecc@ecc'],
   marketplace: { name: 'ecc', repo: 'affaan-m/ECC' },
   note: 'item.plugin.ecc.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/plugin.impeccable.mjs

@@ -15,13 +15,14 @@ import { msg } from '../i18n/index.mjs'
 // 상류 공식 프로바이더는 3.6.0 기준 16개(.agent=antigravity·.hermes가 새로
 // 들어옴 — README는 아직 수동 복사만 안내해 코드가 앞선다). 이 저장소의 CLI와
 // 겹치는 것은 아래 UPSTREAM 그대로다.
-const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot']
+const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot', 'antigravity']
 export default definePlugin({
   id: 'plugin.impeccable', label: 'impeccable', group: '__style',
   installId: 'impeccable@impeccable',
   detectIds: ['impeccable@impeccable'],
   marketplace: { name: 'impeccable', repo: 'pbakaus/impeccable' },
   note: 'item.plugin.impeccable.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

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

@@ -13,6 +13,7 @@ export default definePlugin({
   detectIds: ['mattpocock-skills@mattpocock'],
   marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },
   note: 'item.plugin.mattpocock-skills.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.mattpocockRegistry')]),
   ),

package/lib/items/plugin.ponytail.mjs

@@ -50,6 +50,7 @@ export default {
     ]),
   ),
   note: 'item.plugin.ponytail.note',
+  verified: '2026-08-15',
 
   async detect({ root }) {
     const present = []

package/lib/items/plugin.superpowers.mjs

@@ -10,7 +10,7 @@ import { msg } from '../i18n/index.mjs'
 // Grok은 6.2.0에는 없다가 6.3.0에서 들어왔다 — `### Grok Build CLI`의
 // `grok plugin install superpowers@xai-official --trust`다. Devin·Hermes도 같이
 // 늘었지만 둘 다 이 저장소가 다루는 CLI가 아니다.
-const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok']
+const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok', 'antigravity']
 
 export default definePlugin({
   id: 'plugin.superpowers', label: 'superpowers', group: '__flow',
@@ -18,6 +18,7 @@ export default definePlugin({
   installId: 'superpowers@claude-plugins-official',
   detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
   note: 'item.plugin.superpowers.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/plugin.understand-anything.mjs

@@ -15,6 +15,7 @@ export default definePlugin({
   detectIds: ['understand-anything@understand-anything'],
   marketplace: { name: 'understand-anything', repo: 'Egonex-AI/Understand-Anything' },
   note: 'item.plugin.understand-anything.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.uaUser')]),
   ),

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

@@ -13,4 +13,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/vercel-labs/agent-browser',
   skill: 'agent-browser',
   note: 'item.skill.agent-browser.note',
+  verified: '2026-08-15',
 })

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

@@ -9,4 +9,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/vercel-labs/skills',
   skill: 'find-skills',
   note: 'item.skill.find-skills.note',
+  verified: '2026-08-15',
 })

package/lib/items/skill.gsd.mjs

@@ -26,6 +26,7 @@ import { LocalizedError, msg } from '../i18n/index.mjs'
 //   kimi    `--kimi --local`이 "Project-level Kimi install semantics remain
 //           deferred"를 찍고 거부한다 — 전역 설치만 가능하다.
 //   kiro·grok·vscode  상류 런타임 목록에 없다.
+//   antigravity  --antigravity 플래그가 있지만 설치 경로를 실측하지 못했다.
 const RUNTIMES = [
   { cli: 'claude', dirs: ['.claude/commands', '.claude/skills'] },
   { cli: 'codex', dirs: ['.codex/skills'] },
@@ -56,11 +57,15 @@ export default defineSkill({
   id: 'skill.gsd', label: 'GSD (Get Shit Done)', group: '__flow', scope: 'project',
   note: 'item.skill.gsd.note',
   supports: SUPPORTS,
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
       c,
       c === 'gemini' ? msg('item.unsupported.gsdGemini')
         : c === 'kimi' ? msg('item.unsupported.gsdKimiLocal')
+          // --antigravity 플래그가 있지만 어느 경로에 무엇을 쓰는지 실측하지
+          // 못했다 — 실측 전에는 배선하지 않는다.
+          : c === 'antigravity' ? msg('item.unsupported.unmeasuredUpstream')
           : msg('item.unsupported.upstreamNone'),
     ]),
   ),

package/lib/items/skill.gstack.mjs

@@ -29,6 +29,7 @@ const SHARED_RECURSIVE = ['codex', 'opencode']
 export default defineSkill({
   id: 'skill.gstack', label: 'gstack', group: '__flow', scope: 'project',
   note: 'item.skill.gstack.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/skill.hallmark.mjs

@@ -7,4 +7,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/nutlope/hallmark',
   skill: 'hallmark',
   note: 'item.skill.hallmark.note',
+  verified: '2026-08-10',
 })

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

@@ -10,4 +10,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/anthropics/skills',
   skill: 'mcp-builder',
   note: 'item.skill.mcp-builder.note',
+  verified: '2026-08-15',
 })

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,13 @@
+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',
+  verified: '2026-09-02',
+})

package/lib/status.mjs

@@ -8,7 +8,17 @@ import { updateBlocks, updateFiles } from './bootstrap/apply.mjs'
 import { readRecord, toolVersion } from './bootstrap/record.mjs'
 import { createT } from './i18n/index.mjs'
 
-export async function collectStatus(root, { manifest = MANIFEST, items = [], latest } = {}) {
+// 미배선 사유는 상류를 실측한 날의 사실이다. 그 날짜(item.verified)가 이보다
+// 오래되면 status가 알린다 — 사유 문장이 화면에 낡은 채 남는 것을 막는 유일한
+// 장치다. 90일은 상류 하니스들의 릴리스 간격을 넉넉히 덮는 값이다.
+export const STALE_DAYS = 90
+
+function daysSince(iso, now) {
+  const ms = now - Date.parse(`${iso}T00:00:00Z`)
+  return Number.isFinite(ms) ? Math.floor(ms / 86_400_000) : 0
+}
+
+export async function collectStatus(root, { manifest = MANIFEST, items = [], latest, now = Date.now() } = {}) {
   const record = readRecord(root)
 
   // dry-run으로 갱신 판정만 얻는다 — 판정 로직을 두 벌 두면 status와 update가
@@ -35,6 +45,9 @@ export async function collectStatus(root, { manifest = MANIFEST, items = [], lat
   }
   const installed = states.filter((s) => s.status !== 'absent').map((s) => s.id)
   const intended = new Set(record?.items ?? [])
+  const stale = items
+    .filter((i) => i.verified && daysSince(i.verified, now) > STALE_DAYS)
+    .map((i) => ({ id: i.id, verified: i.verified }))
 
   return {
     hasRecord: Boolean(record),
@@ -53,6 +66,7 @@ export async function collectStatus(root, { manifest = MANIFEST, items = [], lat
       installed,
       recordOnly: [...intended].filter((id) => !installed.includes(id)),
       repoOnly: installed.filter((id) => !intended.has(id)),
+      stale,
     },
   }
 }
@@ -81,6 +95,10 @@ export function formatStatus(report, t = createT('en')) {
   lines.push(t('status.row.items', { list: items.installed.join(', ') || t('status.none') }))
   if (items.recordOnly.length) lines.push(t('status.row.recordOnly', { list: items.recordOnly.join(', ') }))
   if (items.repoOnly.length) lines.push(t('status.row.repoOnly', { list: items.repoOnly.join(', ') }))
+  if (items.stale?.length) {
+    lines.push(t('status.row.stale', { list: items.stale.map((s) => `${s.id} (${s.verified})`).join(', ') }))
+    lines.push(t('status.hint.stale', { days: STALE_DAYS }))
+  }
 
   return lines.join('\n')
 }

package/lib/tui/detail.mjs

@@ -47,27 +47,60 @@ function headLine(row, w, t) {
   return cut(`${item.label}   ${bits.filter(Boolean).join(' · ')}`, w)
 }
 
+// CLI 이름 나열(a·b·c)을 이름 경계에서만 접는다. width.wrap은 공백에서만
+// 끊어, 공백 없는 나열은 낱말 중간(`ant` / `igravity`)에서 갈라졌다.
+function wrapNames(names, limit) {
+  const lines = []
+  let cur = ''
+  for (const name of names) {
+    const next = cur ? `${cur}·${name}` : name
+    if (cur && width(next) > limit) {
+      lines.push(cur)
+      cur = name
+    } else {
+      cur = next
+    }
+  }
+  if (cur) lines.push(cur)
+  return lines
+}
+
 function wiredLines(item, w, lead, t) {
   const supports = item.supports ?? []
   if (supports.length === 0) return []
   // 경로는 MCP에서만 붙인다. 그때만 clis.mjs 어댑터가 경로의 유일한 진실이다 —
   // plugin·skill은 설치 자리가 항목마다 달라 어댑터가 알지 못한다.
   const showFile = item.category === 'mcp'
-  const nameWidth = Math.max(...supports.map((c) => width(c)))
-  return supports.map((cli, i) => {
-    const head = i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)
-    const file = showFile && CLIS[cli]?.file ? `  ${CLIS[cli].file}` : ''
-    // 이름 뒤에 열이 없으면 맞출 대상도 없다 — 경로가 붙는 mcp에서만 이름을 편다.
-    const name = showFile ? pad(cli, nameWidth) : cli
-    return cut(`${head}✔ ${name}${file}`, w)
-  })
+  // 경로가 없으면 세로로 늘어놓을 이유가 없다 — CLI 열한 개를 한 줄에 하나씩
+  // 놓으면 80×24에서 `배선 ✔ claude` 뒤가 `…외 9줄`로 잘려 정작 "어디에
+  // 되나"를 펼쳐야만 읽을 수 있었다. 이름을 ·로 이어 접는다(미배선과 같은 꼴).
+  if (!showFile) {
+    return wrapNames(supports, Math.max(1, w - lead - 2)).map((line, i) =>
+      cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
+  }
+  // MCP는 "CLI 경로" 쌍을 한 줄에 들어가는 만큼 채운다. 한 줄에 하나씩 놓으면
+  // 열 개가 열 줄이라 80×24 패널에서 절반이 `…외 N줄`로 접혔다. 폭이 좁으면
+  // 한 줄에 하나로 자연히 돌아간다.
+  const pairs = supports.map((cli) => (CLIS[cli]?.file ? `${cli} ${CLIS[cli].file}` : cli))
+  const colW = Math.max(...pairs.map((p) => width(p))) + 3
+  const room = Math.max(1, w - lead - 2)
+  const perLine = Math.max(1, Math.floor(room / colW))
+  const rows = []
+  for (let i = 0; i < pairs.length; i += perLine) {
+    const chunk = pairs.slice(i, i + perLine)
+    rows.push(chunk.map((p, j) => (j < chunk.length - 1 ? pad(p, colW) : p)).join(''))
+  }
+  return rows.map((line, i) => cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
 }
 
 function unwiredLines(item, w, lead, t) {
   const out = []
   unsupportedGroups(item, t).forEach((group, i) => {
     const head = i === 0 ? pad(t('detail.unwired'), lead) : ' '.repeat(lead)
-    out.push(cut(`${head}✖ ${group.clis.join('·')}`, w))
+    // 미배선 CLI 이름도 같은 규칙으로 접는다 — 11개를 한 줄에 두면 뒤가 잘린다.
+    wrapNames(group.clis, Math.max(1, w - lead - 2)).forEach((line, j) => {
+      out.push(cut(`${j === 0 ? head : ' '.repeat(lead)}${j === 0 ? '✖ ' : '  '}${line}`, w))
+    })
     // 사유는 한 칸 더 들여 이어 붙인다. 첫 줄만 └를 달아 어느 CLI 묶음의
     // 사유인지 눈으로 잇는다.
     wrap(group.why, Math.max(1, w - lead - 3)).forEach((line, j) => {

package/lib/tui/render.mjs

@@ -19,9 +19,73 @@ const BOLD = `${ESC}[1m`
 const REVERSE = `${ESC}[7m`
 const RESET = `${ESC}[0m`
 
-// 머리글·탭줄·검색줄·구분 공백·바닥글이 차지하는 줄 수.
+// 머리글·탭줄·검색줄·구분 공백·바닥글(한 줄)이 차지하는 줄 수.
+// 바닥글이 두 줄이 되면(footerHeight) 그만큼 더 뺀다.
 const CHROME = 6
 export const LABEL_WIDTH = 24
+// 라벨 열의 상한. 터미널이 넓으면 긴 라벨(`Understand Anything (저장소)`)을
+// 자르지 않도록 열을 늘리되, 힌트 자리(HINT_MIN)는 남긴다. 50칸은 80칸
+// 터미널의 힌트 자리(49칸)보다 커서, 80칸에서는 옛 24칸이 그대로 유지되고
+// 100칸쯤부터 늘기 시작한다 — 좁은 화면에서 라벨을 늘리면 전역 항목의
+// `gemini 없음` 같은 힌트 꼬리가 대신 잘렸다.
+const LABEL_MAX = 40
+const HINT_MIN = 50
+// rows.mjs의 NAME_LIMIT와 같은 규칙 — 넷 이하면 이름, 그보다 많으면 수.
+const NAME_LIMIT = 4
+
+// 행 라벨 열의 폭. 24칸 고정이면 넓은 화면에서도 긴 라벨이 잘렸다. 화면에
+// 있는 가장 긴 라벨까지 늘리되 상한과 힌트 자리를 지킨다.
+export function labelColumn(rows, w) {
+  const longest = Math.max(LABEL_WIDTH, ...rows.filter((r) => r.kind === 'item').map((r) => width(r.label ?? '')))
+  return Math.max(LABEL_WIDTH, Math.min(longest, LABEL_MAX, w - 6 - HINT_MIN))
+}
+
+// 넓은 화면에서는 전체 경로, 자리가 없으면 마지막 디렉터리 이름만.
+function repoLabel(repo, room) {
+  const full = String(repo ?? '')
+  if (width(full) <= room) return full
+  return full.split(/[\\/]/).filter(Boolean).pop() ?? full
+}
+
+// 힌트 항목 사이의 구분자. 카탈로그 문자열이 이 간격으로 항목을 나눈다 —
+// 좁은 폭에서 두 줄로 접을 때 이 경계에서만 끊는다.
+const HINT_SEP = '   '
+
+// 바닥글 힌트를 폭에 맞춰 최대 두 줄로 접는다. 예전에는 한 줄로 두고 뒤를
+// 잘랐는데, 80칸 한국어 화면에서 `Ctrl+A 전체   C…`에서 끊겨 CLI 필터(Ctrl+F)·
+// 상세 펼침(Ctrl+D)·미리보기(Ctrl+O)를 발견할 길이 없었다. 두 줄로도 모자라면
+// 둘째 줄을 자른다 — 세 줄은 목록 지면을 너무 갉아먹는다.
+export function hintLines(hint, room) {
+  const lines = []
+  let cur = ''
+  for (const seg of String(hint ?? '').split(HINT_SEP)) {
+    const next = cur ? `${cur}${HINT_SEP}${seg}` : seg
+    if (cur && width(next) > room) {
+      lines.push(cur)
+      cur = seg
+    } else {
+      cur = next
+    }
+  }
+  if (cur) lines.push(cur)
+  if (lines.length <= 2) return lines
+  return [lines[0], cut(lines.slice(1).join(HINT_SEP), room)]
+}
+
+// 힌트 오른쪽 끝의 종료 키를 뺀 나머지 자리. 8칸도 안 남으면 힌트를 버리고
+// 종료 키만 남긴다(render의 바닥글과 같은 판정).
+function hintRoom(w, t) {
+  return w - width(t('tui.hint.quit')) - 2
+}
+
+// 바닥글 줄 수(1 또는 2). 검색칸·목록 두 포커스의 힌트 중 긴 쪽으로 정한다 —
+// 포커스를 옮길 때마다 목록 높이가 바뀌면 화면이 출렁인다.
+export function footerHeight(columns = 80, t = createT('en')) {
+  const w = Math.max(24, columns - 1)
+  const room = hintRoom(w, t)
+  if (room < 8) return 1
+  return Math.max(hintLines(t('tui.hint.list'), room).length, hintLines(t('tui.hint.search'), room).length)
+}
 
 // 상세 패널은 목록과 화면을 나눠 갖는다. 높이를 커서가 아니라 **터미널
 // 크기로만** 정하는 것이 핵심이다 — 커서를 옮길 때마다 높이가 변하면
@@ -32,16 +96,17 @@ const PANEL_MAX = 12
 // 목록이 3줄 밑으로 내려가는 쪽이 패널이 사라지는 것보다 나쁘다.
 const PANEL_FLOOR = PANEL_MIN + 3
 
-export function panelHeight(height, expanded = false) {
-  const room = Math.max(0, height - CHROME)
+// footer는 바닥글 줄 수(footerHeight)다. 기본 1이면 옛 산식과 같다.
+export function panelHeight(height, expanded = false, footer = 1) {
+  const room = Math.max(0, height - CHROME - (footer - 1))
   if (expanded) return room
   if (room < PANEL_FLOOR) return 0
   return Math.min(PANEL_MAX, Math.max(PANEL_MIN, Math.round(room * PANEL_SHARE)))
 }
 
-export function bodyHeight(height, expanded = false) {
-  const room = Math.max(0, height - CHROME)
-  const panel = panelHeight(height, expanded)
+export function bodyHeight(height, expanded = false, footer = 1) {
+  const room = Math.max(0, height - CHROME - (footer - 1))
+  const panel = panelHeight(height, expanded, footer)
   // 패널이 없을 때는 예전과 같이 최소 3줄을 보장한다.
   return panel === 0 ? Math.max(3, room) : room - panel
 }
@@ -54,19 +119,41 @@ export function reviewBodyHeight(height) {
   return Math.max(3, height - CHROME)
 }
 
-const MARK = { action: '▶', on: '×', off: ' ' }
+// on = 설치돼 있고 그대로 둔다, add = 이번에 새로 고름(설치·보완 설치 예정),
+// remove = 설치돼 있는데 체크를 풀었다(제거 예정), off = 없고 안 고름.
+const MARK = { action: '▶', on: '×', add: '+', remove: '-', off: ' ' }
 
 // 대괄호는 "여러 개 고를 수 있다"는 보편적 신호다 — 한 파일에 한 벌만 놓이는
 // 배타 묶음(커밋 템플릿의 두 언어판)에 그대로 쓰면 화면이 거짓말을 한다.
 // 둥근 괄호로 바꿔 라디오임을 드러낸다. 안쪽 글자는 그대로 둔다: ×는 이미
 // 이 화면이 쓰는 글자라 폭 계산이 검증된 값이고, ●·•는 동아시아 폭이
 // 모호(Ambiguous)해 터미널에 따라 두 칸으로 그려져 열을 밀 수 있다.
+//
+// 표식은 "지금 체크됐나"가 아니라 "Enter를 누르면 무슨 일이 나나"를 말한다.
+// 예전에는 ×가 "설치됨(유지)"과 "새로 고름"에 똑같이 쓰였고, 설치된 항목의
+// 체크를 풀면 빈 칸이 돼 힌트의 '설치됨'과 조합해야 제거 예정임을 알 수
+// 있었다. +·-는 ASCII라 폭이 모호하지 않다(−·±는 동아시아 폭이 모호하다).
+export function changeMark(row, selected) {
+  const on = selected.has(row.id)
+  if (on) return row.status === 'installed' ? MARK.on : MARK.add
+  return row.status === 'absent' ? MARK.off : MARK.remove
+}
+
 function checkbox(row, selected) {
   if (row.kind === 'action') return `[${MARK.action}]`
-  const mark = selected.has(row.id) ? MARK.on : MARK.off
+  const mark = changeMark(row, selected)
   return row.exclusive ? `(${mark})` : `[${mark}]`
 }
 
+// Enter를 누르면 바뀔 항목 수 — engine.planChanges와 같은 판정이다.
+// add는 설치·보완 설치, remove는 제거다.
+export function pendingCounts(state) {
+  const marks = state.rows.filter((r) => r.kind === 'item').map((r) => changeMark(r, state.selected))
+  const add = marks.filter((m) => m === MARK.add).length
+  const remove = marks.filter((m) => m === MARK.remove).length
+  return { add, remove, total: add + remove }
+}
+
 // 탭 줄. 목록이 좁혀졌으면(검색어·CLI 필터 어느 쪽이든) 탭마다 적중 수를
 // 보여 준다 — 검색·필터는 활성 탭 안으로만 걸리므로, 다른 탭에 결과가
 // 있다는 사실을 여기서 알린다. 그래야 필터가 사용자를 빈 탭에 가둬 두고
@@ -109,10 +196,15 @@ export function tabBar(state, { width: limit, color = false, narrowed = false, t
 // 그대로 쓰이는데, 색 코드를 섞으면 ESC 시퀀스가 표시 폭에 끼어든다(폭은
 // 항상 색을 입히기 전에 재야 한다). 칠하는 일은 호출부가 폭 계산을 끝낸
 // 뒤 마지막에 한다.
+//
+// 위치는 CLI 사이에서만 센다. options[0]은 "전체"(null)라 순환 목록에는 있지만
+// 사용자에게는 CLI가 아니다 — 그것까지 세면 `codex (3/11)`처럼 CLI가 열
+// 개인데 열한 번째가 있다고 읽힌다.
 export function filterSegment(state, { t = createT('en'), options = [] } = {}) {
   if (!state.cliFilter) return ''
-  const at = options.indexOf(state.cliFilter)
-  const pos = at === -1 ? '' : ` (${t('tui.filter.position', { current: at + 1, total: options.length })})`
+  const clis = options.filter((o) => o !== null)
+  const at = clis.indexOf(state.cliFilter)
+  const pos = at === -1 ? '' : ` (${t('tui.filter.position', { current: at + 1, total: clis.length })})`
   return `${t('tui.filter.prefix')}${state.cliFilter}${pos}`
 }
 
@@ -157,8 +249,14 @@ export function render(state, opts = {}) {
   const picked = items.filter((r) => state.selected.has(r.id)).length
 
   const title = `agent-installer${dryRun ? ' (dry-run)' : ''}`
-  const counts = t('tui.counts', { picked, total: items.length })
-  const head = cut(`${title}  ${counts}  ${repo}`, w)
+  // 선택 수 옆에 변경 예정 건수를 둔다 — "선택 3 / 전체 106"은 설치 상태의
+  // 합계라 Enter를 누르면 무슨 일이 날지 말해 주지 않는다. 항상 찍는다:
+  // 0건이면 "지금 Enter는 아무것도 안 한다"는 뜻이라 그것대로 정보다.
+  const pending = pendingCounts(state)
+  const marks = pending.total > 0 ? t('tui.pendingMarks', { add: pending.add, remove: pending.remove }) : ''
+  const counts = `${t('tui.counts', { picked, total: items.length })}  ${t('tui.pending', { count: pending.total, marks })}`
+  const repoText = repoLabel(repo, w - width(`${title}  ${counts}  `))
+  const head = cut(`${title}  ${counts}  ${repoText}`, w)
   const searching = String(state.query ?? '').trim() !== ''
   // 목록이 좁혀졌는가 — 검색어·CLI 필터 어느 쪽이든 활성 탭 안에서만 걸리는
   // 좁힘이라, 다른 탭에 뭐가 남았는지 알리는 몫(탭 줄의 shown/total)은
@@ -167,13 +265,14 @@ export function render(state, opts = {}) {
 
   const filter = filterSegment(state, { t, options: cliOptions })
   const lines = [
-    color ? `${BOLD}${title}${RESET}${cut(`  ${counts}  ${repo}`, Math.max(0, w - width(title)))}` : head,
+    color ? `${BOLD}${title}${RESET}${cut(`  ${counts}  ${repoText}`, Math.max(0, w - width(title)))}` : head,
     tabBar(state, { width: w, color, narrowed, t }),
     searchLine(state, { limit: w, color, paint, t, filter }),
     '',
   ]
 
-  const body = bodyHeight(height, detailExpanded)
+  const footer = footerHeight(columns, t)
+  const body = bodyHeight(height, detailExpanded, footer)
   const all = displayList(state)
 
   if (all.length === 0) {
@@ -188,6 +287,7 @@ export function render(state, opts = {}) {
     for (let i = 1; i < body; i++) lines.push('')
   } else {
     const window = all.slice(state.offset, state.offset + body)
+    const labelCol = labelColumn(state.rows, w)
     for (const entry of window) {
       if (entry.type === 'header') {
         const count = entry.shown === entry.total ? `${entry.total}` : `${entry.shown}/${entry.total}`
@@ -199,8 +299,8 @@ export function render(state, opts = {}) {
       }
       const { row, index } = entry
       const here = index === state.cursor
-      const hintWidth = Math.max(0, w - LABEL_WIDTH - 6)
-      const text = cut(`${here ? '❯' : ' '} ${checkbox(row, state.selected)} ${pad(row.label, LABEL_WIDTH)} ${cut(row.hint, hintWidth)}`, w)
+      const hintWidth = Math.max(0, w - labelCol - 6)
+      const text = cut(`${here ? '❯' : ' '} ${checkbox(row, state.selected)} ${pad(row.label, labelCol)} ${cut(row.hint, hintWidth)}`, w)
       lines.push(here ? paint(REVERSE, text) : text)
     }
     for (let i = window.length; i < body; i++) lines.push('')
@@ -208,7 +308,7 @@ export function render(state, opts = {}) {
 
   // 상세 패널 — 목록 아래 고정 자리. 높이가 커서와 무관하므로 목록이
   // 출렁이지 않는다. 지면이 모자라면 panelHeight가 0을 돌려 통째로 빠진다.
-  const panel = panelHeight(height, detailExpanded)
+  const panel = panelHeight(height, detailExpanded, footer)
   if (panel > 0) {
     lines.push(paint(DIM, '─'.repeat(w)))
     const room = panel - 1
@@ -223,13 +323,25 @@ export function render(state, opts = {}) {
   // 빠져나가나"다 — 잘려도 되는 안내와 절대 사라지면 안 되는 안내를 같은
   // 줄에 이어 붙여 두면 늘 후자가 먼저 사라진다. 상태 메시지가 힌트를
   // 대신할 때도 이 자리는 그대로 남는다.
+  //
+  // 바닥글은 footer줄이다(1 또는 2). 힌트는 위에서부터 채우고 종료 키는 항상
+  // 마지막 줄 오른쪽 끝이다. 상태 메시지는 힌트를 통째로 대신하되 마지막
+  // 줄에 놓는다 — 폭이 달라져도 "맨 아랫줄 = 상태 + 종료 키"가 유지된다.
   const hint = state.focus === 'search' ? t('tui.hint.search') : t('tui.hint.list')
   const quit = t('tui.hint.quit')
-  const room = w - width(quit) - 2
+  const room = hintRoom(w, t)
   lines.push('')
-  lines.push(room < 8
-    ? paint(BOLD, cut(quit, w))
-    : `${paint(DIM, pad(status || hint, room))}  ${paint(BOLD, quit)}`)
+  if (room < 8) {
+    for (let i = 1; i < footer; i++) lines.push('')
+    lines.push(paint(BOLD, cut(quit, w)))
+    return lines
+  }
+  const shown = status ? [status] : hintLines(hint, room)
+  while (shown.length < footer) shown.unshift('')
+  shown.slice(0, footer).forEach((text, i) => {
+    const last = i === footer - 1
+    lines.push(last ? `${paint(DIM, pad(text, room))}  ${paint(BOLD, quit)}` : paint(DIM, cut(text, w)))
+  })
   return lines
 }
 
@@ -248,9 +360,15 @@ export function renderReview(changes, opts = {}) {
   // 적용 직전 마지막 화면이다. 일부 CLI에만 들어가는 항목은 여기서도 그 사실을
   // 밝힌다 — 목록에서 지나쳤더라도 되돌릴 수 있는 마지막 지점이다.
   // 전부 지원하는 항목은 조용히 둔다: 경고가 흔해지면 아무도 읽지 않는다.
+  // 목록과 같은 규칙으로 — 넷 이하면 이름을 적는다. 숫자만 있으면 어느
+  // CLI인지 알려고 Esc로 되돌아가야 했다.
   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 })}` : ''
+    const supports = c.item.supports
+    const partial = supports && supports.length < CLI_IDS.length
+    const covText = supports?.length > 0 && supports.length <= NAME_LIMIT
+      ? supports.join('·')
+      : t('item.cliCoverage', { covered: supports?.length ?? 0, total: CLI_IDS.length })
+    const cov = partial ? ` · ${covText}` : ''
     return cut(`  ${CHANGE_MARK[c.action] ?? '?'} ${pad(t(`change.${c.action}`), 10)} ${scopedLabel(c.item, t)}${cov}`, w)
   }
 
@@ -305,3 +423,17 @@ export function renderReview(changes, opts = {}) {
   lines.push(paint(DIM, cut(t('tui.review.hint'), w)))
   return lines
 }
+
+// 도움말 화면 — F1. 바닥글 두 줄로는 키의 뜻까지 담을 수 없어, 전체 키를
+// 설명과 함께 한 화면에 편다. 아무 키나 누르면 닫힌다.
+export function renderHelp(opts = {}) {
+  const { width: columns = 80, height = 24, color = false, t = createT('en') } = opts
+  const w = Math.max(24, columns - 1)
+  const paint = (code, text) => (color ? `${code}${text}${RESET}` : text)
+  const lines = [paint(BOLD, cut(t('help.title'), w)), '']
+  for (const line of t('help.lines').split('\n')) lines.push(cut(line, w))
+  while (lines.length < height - 2) lines.push('')
+  lines.push('')
+  lines.push(paint(DIM, cut(t('help.close'), w)))
+  return lines.slice(0, height)
+}