tabby-agentdeck 1.1.3 → 1.2.0

package/hooks/agentdeck-statusline.mjs

@@ -0,0 +1,351 @@
+/**
+ * Claude Code statusLine 을 한 겹 감싸서, 그 stdin JSON 을 AgentDeck 사이드바로 넘긴다.
+ *
+ * 왜 감싸나 — 모델·effort·컨텍스트%·5h/7d 한도% 는 **statusLine stdin 에만** 내려온다.
+ * 훅(JSON)에는 없고 대화기록(jsonl)에는 모델까지만 있다. 사이드바 하단의 "지금 이 탭" 줄이
+ * 원하는 값이 전부 여기 있으므로, 이미 걸려 있는 statusLine 명령 앞에 이 스크립트를 끼워
+ * 같은 stdin 을 그대로 흘려보내면서 한 벌 베껴 둔다.
+ *
+ * **이 스크립트의 첫 번째 계약은 "원래 statusLine 을 절대 죽이지 않는다" 이다.**
+ * statusLine 은 사용자가 매 렌더마다 보는 것이라, 우리가 실패해도 안쪽 명령의 출력은
+ * 그대로 나가야 한다. 그래서 베껴 쓰는 일은 전부 try/catch 로 감싸고, 종료코드도
+ * 안쪽 명령의 것을 그대로 쓴다. 안쪽이 없거나 못 띄우면 조용히 아무것도 출력하지 않는다
+ * (여기서 에러 문구를 뱉으면 그게 사용자의 statusLine 자리에 박힌다).
+ *
+ * 안쪽 명령은 설치할 때 `statusline-inner.json` 으로 옮겨 둔 **원래 설정 그대로**다
+ * (src/statusLine.ts). 체인 순서는 상관없다 — 이 스크립트는 stdin 을 바꾸지 않고
+ * stdout 을 건드리지 않으므로, 누가 우리를 또 감싸도 각 겹이 같은 JSON 을 본다.
+ */
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import * as https from 'node:https'
+
+const ROOT = path.join(
+    process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'),
+    'tabby-agentdeck',
+)
+/** 사이드바가 읽는 곳. 상태 보고(`status/`)와 폴더를 나눈다 — 그쪽 폴링은 자기 형식만 알아본다 */
+const META_DIR = path.join(ROOT, 'meta')
+const INNER_FILE = path.join(ROOT, 'statusline-inner.json')
+/** 모델별 주간 한도(Fable 등) 캐시 — stdin 에 없는 값이라 따로 물어본 것을 여기 둔다 */
+const SCOPED_FILE = path.join(ROOT, 'scoped-limit.json')
+/** 캐시를 낡았다고 보는 기준. statusLine 은 초 단위로 불리므로 매번 물어보면 안 된다 */
+const SCOPED_TTL_MS = 60_000
+/**
+ * **못 받았을 때는 더 오래 쉰다.**
+ *
+ * 실패는 대개 곧 풀리지 않는다 — 토큰이 없거나(API 키·게이트웨이), 그 요금제에 모델별 한도가
+ * 없거나, 레지스트리가 우리를 막은 경우다. 1분마다 두드리면 마지막 것은 **더 오래 막힌다**:
+ * 2026-09-15 실측으로 이 API 가 실제로 429 를 돌려줬다(앞서 캐시 도장이 없어 렌더마다
+ * 요청이 나가던 판의 결과다).
+ */
+const SCOPED_FAIL_TTL_MS = 10 * 60_000
+
+function readStdin () {
+    try {
+        // fd 0 을 통째로 읽는다. Claude Code 는 JSON 한 덩이를 주고 stdin 을 닫는다
+        return fs.readFileSync(0)
+    } catch {
+        return Buffer.alloc(0)
+    }
+}
+
+/**
+ * 계정 — statusLine stdin 에는 없다. 설정 파일에서 읽는다.
+ *
+ * `CLAUDE_CONFIG_DIR` 이 걸려 있으면 그 아래를 먼저 본다. 그 환경변수는 이 프로세스가
+ * claude 에서 그대로 물려받은 것이라, **탭마다 계정을 갈라 쓰는 경우에도 이 값이 맞다.**
+ * (`$CLAUDE_CONFIG_DIR/.claude.json` 위치는 근거 미확인이라 홈 폴더로 폴백한다.)
+ */
+function readAccount () {
+    const dirs = []
+    if (process.env.CLAUDE_CONFIG_DIR) {
+        dirs.push(process.env.CLAUDE_CONFIG_DIR)
+    }
+    dirs.push(os.homedir())
+    for (const dir of dirs) {
+        try {
+            const file = path.join(dir, '.claude.json')
+            const acc = JSON.parse(fs.readFileSync(file, 'utf8'))?.oauthAccount
+            if (acc?.emailAddress) {
+                return {
+                    account: String(acc.emailAddress),
+                    org: acc.organizationName ? String(acc.organizationName) : '',
+                    configDir: dir,
+                }
+            }
+        } catch {
+            // 없거나 아직 못 읽는다 — 다음 후보로
+        }
+    }
+    return { account: '', org: '', configDir: '' }
+}
+
+function pct (v) {
+    const n = Number(v)
+    return Number.isFinite(n) ? Math.round(n) : null
+}
+
+// ---------- 모델별 주간 한도 (Fable 등) ----------
+//
+// statusLine stdin 의 `rate_limits` 는 `five_hour` / `seven_day` 만 조립한다. 모델별 주간 한도
+// (내부명 `seven_day_overage_included`, 화면 이름 `Fable`)는 **거기 없다** — 진본은
+// `GET /api/oauth/usage` 의 `limits[]` 중 `kind=weekly_scoped` 다.
+//
+// 렌더를 막으면 안 되므로 **읽기는 캐시에서만** 한다. 캐시가 낡았으면 자기 자신을
+// `--refresh-scoped` 로 떼어 내 띄우고(detached), 이번 렌더는 낡은 값 그대로 쓴다.
+// 다음 렌더에 새 값이 들어온다 — statusLine 은 몇 초에 한 번씩 다시 불린다.
+
+/** OAuth 토큰 — 계정 파일과 같은 후보 폴더를 본다 (탭마다 계정을 갈라 써도 맞는다) */
+function readOauthToken () {
+    const dirs = []
+    if (process.env.CLAUDE_CONFIG_DIR) {
+        dirs.push(process.env.CLAUDE_CONFIG_DIR)
+    }
+    dirs.push(path.join(os.homedir(), '.claude'), os.homedir())
+    for (const dir of dirs) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, '.credentials.json'), 'utf8')
+            const token = JSON.parse(raw)?.claudeAiOauth?.accessToken
+            if (token) {
+                return String(token)
+            }
+        } catch {
+            // 없거나 못 읽는다 — 다음 후보로
+        }
+    }
+    return ''
+}
+
+function readScopedCache () {
+    try {
+        return JSON.parse(fs.readFileSync(SCOPED_FILE, 'utf8'))
+    } catch {
+        return null
+    }
+}
+
+/** 캐시가 낡았으면 갱신을 떼어 낸다 — 부모(이 렌더)는 기다리지 않는다 */
+function armScopedRefresh (cache) {
+    // 직전이 실패였으면(`ok: false`) 더 길게 쉰다 — SCOPED_FAIL_TTL_MS 주석
+    const ttl = cache && cache.ok === false ? SCOPED_FAIL_TTL_MS : SCOPED_TTL_MS
+    if (cache && Date.now() - Number(cache.ts || 0) < ttl) {
+        return
+    }
+    try {
+        const child = spawn(process.execPath, [fileURLToPath(import.meta.url), '--refresh-scoped'], {
+            detached: true,
+            stdio: 'ignore',
+            env: { ...process.env, AGENTDECK_SL_DEPTH: '0' },
+        })
+        child.unref()
+    } catch {
+        // 못 띄우면 다음 렌더가 다시 시도한다
+    }
+}
+
+/**
+ * 실제로 물어보고 캐시에 남긴다 (`--refresh-scoped` 로 따로 뜬 프로세스에서만 돈다).
+ *
+ * `fetch` 가 아니라 `node:https` 를 쓴다 — undici 는 응답을 다 읽은 뒤에도 소켓을 쥐고 있어서,
+ * 다 쓰고 `process.exit` 하면 Windows 에서 libuv 가 죽는다 (실측: `Assertion failed:
+ * !(handle->flags & UV_HANDLE_CLOSING)`, rc 127). 여기서는 응답이 끝나면 이벤트 루프가
+ * 저절로 비어 프로세스가 정상 종료된다.
+ */
+function requestUsage (token) {
+    return new Promise((resolve, reject) => {
+        const req = https.request({
+            host: 'api.anthropic.com',
+            path: '/api/oauth/usage',
+            method: 'GET',
+            headers: {
+                'authorization': `Bearer ${token}`,
+                'anthropic-beta': 'oauth-2025-04-20',
+                'accept': 'application/json',
+            },
+            timeout: 10_000,
+        }, res => {
+            const chunks = []
+            res.on('data', c => chunks.push(c))
+            res.on('end', () => {
+                if (res.statusCode !== 200) {
+                    reject(new Error('http ' + res.statusCode))
+                    return
+                }
+                try {
+                    resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')))
+                } catch (e) {
+                    reject(e)
+                }
+            })
+        })
+        req.on('timeout', () => req.destroy(new Error('timeout')))
+        req.on('error', reject)
+        req.end()
+    })
+}
+
+/**
+ * 갱신 결과를 캐시에 남긴다.
+ *
+ * **못 받았을 때도 반드시 부른다.** `armScopedRefresh` 는 "캐시가 있고 TTL 안" 일 때만 건너뛰는데,
+ * 실패했다고 아무것도 안 쓰면 캐시가 영원히 없어서 **statusLine 이 불릴 때마다**(초 단위)
+ * 새 프로세스가 뜬다 — 토큰이 없는 계정(API 키·게이트웨이)에서는 영영 성공하지 못하므로
+ * 그 상태가 계속된다 (2026-09-15 코드리뷰 지적).
+ */
+/**
+ * **실패해도 마지막 정상값은 지운다 — 가 아니라 지킨다.** 예전에는 실패하면 이름·퍼센트를 빈 값으로
+ * 덮어써서, 일시적 오류 한 번에 `Fable` 칸이 사라지고 실패 TTL(10분) 동안 빈 채로 있다가
+ * 다음 성공에서야 돌아왔다 (2026-09-16 실측: 10:28 실패 → 10:38 복귀, 사용자 "왜 안 나오다 또
+ * 나오나"). 몇 분 전 값이라도 빈 칸보다 낫다 — 한도는 분 단위로 크게 안 움직인다.
+ * 그래서 `scoped` 가 없으면 `prev` 의 이름·퍼센트·리셋 시각을 그대로 옮기고, 도장(`ts`)과
+ * 판정(`ok`)만 새로 찍는다. `ok:false` 는 여전히 재시도 간격을 가르는 데만 쓰인다.
+ *
+ * `err` 는 왜 비었는지 남기는 자리다 — 상태코드·타임아웃을 삼키면 이런 문제를 영영 못 찾는다.
+ */
+function writeScoped (scoped, prev, err) {
+    const name = scoped ? (scoped.scope?.model?.display_name ?? scoped.scope?.model?.id ?? '') : ''
+    // `resets_at` 은 여기서만 ISO 문자열이다 (stdin 쪽은 epoch 초) — 초로 맞춰 둔다
+    const resetsAt = scoped ? Math.round(Date.parse(scoped.resets_at ?? '') / 1000) || 0 : 0
+    const keep = !scoped && prev && prev.name ? prev : null
+    fs.mkdirSync(ROOT, { recursive: true })
+    const tmp = SCOPED_FILE + '.' + process.pid + '.tmp'
+    fs.writeFileSync(tmp, JSON.stringify({
+        ts: Date.now(),
+        // 다음 갱신 간격을 가르는 값 — 못 받았으면 오래 쉰다 (`armScopedRefresh`)
+        ok: !!scoped,
+        name: keep ? String(keep.name) : String(name),
+        pct: keep ? keep.pct : (scoped ? pct(scoped.percent) : null),
+        resetsAt: keep ? Number(keep.resetsAt) || 0 : resetsAt,
+        // 실패 사유 (성공이면 비운다). 값을 지킨 경우 `stale: true` 로 표시만 해 둔다
+        ...(scoped ? {} : { err: String(err ?? 'unknown'), stale: !!keep }),
+    }), 'utf8')
+    fs.renameSync(tmp, SCOPED_FILE)
+}
+
+async function refreshScoped () {
+    const prev = readScopedCache()
+    const token = readOauthToken()
+    if (!token) {
+        // 토큰이 없다 (로그인 안 함·API 키 사용) — 칸이 안 생길 뿐이지만 **도장은 찍는다**
+        writeScoped(null, prev, 'no-token')
+        return
+    }
+    let body
+    try {
+        body = await requestUsage(token)
+    } catch (e) {
+        // 네트워크·상태코드·타임아웃 — 마지막 정상값을 지키고 사유만 남긴다 (writeScoped 주석)
+        writeScoped(null, prev, e?.message || 'request-failed')
+        return
+    }
+    // 모델별 주간 한도는 여러 개일 수 있다 — 가장 많이 쓴 칸 하나만 보인다 (줄이 하나뿐이다)
+    const scoped = (Array.isArray(body?.limits) ? body.limits : [])
+        .filter(l => l?.kind === 'weekly_scoped')
+        .sort((a, b) => Number(b?.percent ?? 0) - Number(a?.percent ?? 0))[0]
+    // 모델별 한도가 없는 요금제도 있다 — 그때도 도장을 찍어야 다시 묻지 않는다.
+    // 이 경우는 실패가 아니라 "없다" 가 답이므로 옛 값을 지키지 않는다 (prev 를 안 넘긴다)
+    writeScoped(scoped ?? null, null, scoped ? undefined : 'no-scoped-limit')
+}
+
+/** stdin JSON 에서 사이드바가 쓸 것만 뽑는다 — 원문을 통째로 두면 대화 비용·경로까지 남는다 */
+function snapshot (data) {
+    const model = data.model ?? {}
+    const ctx = data.context_window ?? {}
+    const lim = data.rate_limits ?? {}
+    const { account, org, configDir } = readAccount()
+    const scoped = readScopedCache()
+    armScopedRefresh(scoped)
+    return {
+        sessionId: String(data.session_id ?? ''),
+        ts: Date.now(),
+        agent: 'claude',
+        model: String(model.display_name ?? model.id ?? ''),
+        modelId: String(model.id ?? ''),
+        effort: String(data.effort?.level ?? ''),
+        version: String(data.version ?? ''),
+        fastMode: !!data.fast_mode,
+        account,
+        org,
+        configDir,
+        cwd: String(data.cwd ?? data.workspace?.current_dir ?? ''),
+        contextPct: pct(ctx.used_percentage),
+        limits: {
+            fiveHourPct: pct(lim.five_hour?.used_percentage),
+            fiveHourResetsAt: Number(lim.five_hour?.resets_at) || 0,
+            sevenDayPct: pct(lim.seven_day?.used_percentage),
+            sevenDayResetsAt: Number(lim.seven_day?.resets_at) || 0,
+            scopedName: scoped?.name ?? '',
+            scopedPct: scoped?.pct ?? null,
+            scopedResetsAt: Number(scoped?.resetsAt) || 0,
+        },
+    }
+}
+
+function writeSnapshot (raw) {
+    const data = JSON.parse(raw.toString('utf8'))
+    const snap = snapshot(data)
+    if (!snap.sessionId) {
+        return // 누구 것인지 모르면 쓰지 않는다 — 사이드바가 세션 id 로만 탭에 묶는다
+    }
+    fs.mkdirSync(META_DIR, { recursive: true })
+    // 같은 파일을 사이드바가 400ms 마다 읽는다. 쓰다 만 파일을 읽히지 않도록 임시 파일 + rename
+    const file = path.join(META_DIR, snap.sessionId + '.json')
+    const tmp = file + '.' + process.pid + '.tmp'
+    fs.writeFileSync(tmp, JSON.stringify(snap), 'utf8')
+    fs.renameSync(tmp, file)
+}
+
+/** 원래 걸려 있던 statusLine 을 그대로 실행하고 stdout/stderr 을 넘겨준다 */
+function runInner (raw) {
+    let inner = null
+    try {
+        inner = JSON.parse(fs.readFileSync(INNER_FILE, 'utf8'))
+    } catch {
+        // 안쪽이 없다 = 원래 statusLine 이 없던 사용자다. 출력 없이 끝낸다
+    }
+    const command = inner && inner.type === 'command' ? String(inner.command ?? '') : ''
+    if (!command || command.includes('agentdeck-statusline')) {
+        // 우리 자신을 안쪽으로 두면 무한히 겹친다 — 설치가 꼬였을 때의 안전판
+        process.exit(0)
+    }
+    // 겹 세기. 남의 래퍼(원래 명령을 백업해 두는 종류)가 우리를 자기 안쪽에 넣어
+    // 버리면 `우리 -> 남 -> 우리 -> ...` 고리가 생긴다. 직접 검사(위 includes)로는 한 겹밖에
+    // 못 보므로, 물려주는 env 에 깊이를 실어 두 겹을 넘으면 조용히 멈춘다. 그 화면은
+    // statusLine 이 비어 보이지만(설치를 다시 하면 풀린다) 프로세스가 무한히 늘지는 않는다
+    const depth = Number(process.env.AGENTDECK_SL_DEPTH || 0) + 1
+    if (depth > 2) {
+        process.exit(0)
+    }
+    // stdout/stderr 은 그대로 물려준다(inherit) — 우리가 중계하면 버퍼 한 겹만 늘어난다
+    const child = spawn(command, {
+        shell: true,
+        stdio: ['pipe', 'inherit', 'inherit'],
+        env: { ...process.env, AGENTDECK_SL_DEPTH: String(depth) },
+    })
+    child.on('error', () => process.exit(0))
+    child.on('close', code => process.exit(code ?? 0))
+    child.stdin.on('error', () => { /* 안쪽이 stdin 을 안 읽고 끝냈다 — 정상 */ })
+    child.stdin.end(raw)
+}
+
+// 갱신 전용 실행 — 떼어 낸 프로세스가 여기로 들어온다. stdin 도 statusLine 도 건드리지 않는다
+if (process.argv.includes('--refresh-scoped')) {
+    // exit 을 부르지 않는다 — 응답이 끝나면 루프가 비어 저절로 끝난다 (requestUsage 주석)
+    refreshScoped().catch(() => {
+        // 네트워크·토큰 문제. **여기서도 도장을 찍는다** — 안 찍으면 TTL 게이트가 비어
+        // 렌더마다 새 프로세스가 뜬다 (writeScoped 주석)
+        try { writeScoped(null, readScopedCache(), 'unhandled') } catch { /* 디스크까지 막혔으면 할 수 있는 게 없다 */ }
+    })
+} else {
+    const raw = readStdin()
+    try {
+        writeSnapshot(raw)
+    } catch {
+        // 베끼기 실패는 사이드바 한 줄이 안 뜨는 것으로 끝난다. statusLine 은 계속 나가야 한다
+    }
+    runInner(raw)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tabby-agentdeck",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Run AI coding agents side by side in Tabby - a live deck of agent sessions with status, a preview panel for the files they touch, agent-friendly hotkeys and image paste",
   "keywords": [
     "tabby-plugin",
@@ -15,12 +15,14 @@
   "typings": "dist/index.d.ts",
   "scripts": {
     "build": "webpack --mode production",
+    "build:release": "node tools/sync-version.js && webpack --mode production --env release",
+    "prepack": "npm run build:release && node tools/check-release.js",
     "watch": "webpack --progress --color --watch",
     "test": "npm run test:existing && npm run test:codex",
     "prebuild": "node tools/sync-version.js",
     "sync-version": "node tools/sync-version.js",
     "release": "node tools/release.js",
-    "test:existing": "tsc src/prompt.ts src/detect.ts src/claudeHooks.ts src/screen.ts src/bind.ts src/order.ts src/reason.ts src/tabenv.ts src/viewer.ts src/markdown.ts src/ime.ts src/gitDiff.ts src/agents.ts src/group.ts src/project-root.ts src/gitCommit.ts src/diag.ts src/subagents.ts src/nav.ts src/sessionLedger.ts src/update.ts src/api.ts src/dock.ts src/status.service.ts src/profile.service.ts src/recovery.service.ts --outDir .tmp --module commonjs --target es2019 --skipLibCheck --experimentalDecorators --esModuleInterop && node test/version.test.js && node test/tags.test.js && node test/prompt.test.js && node test/detect.test.js && node test/claudeHooks.test.js && node test/screen.test.js && node test/bind.test.js && node test/order.test.js && node test/reason.test.js && node test/tabenv.test.js && node test/viewer.test.js && node test/markdown.test.js && node test/ime.test.js && node test/gitDiff.test.js && node test/agents.test.js && node test/group.test.js && node test/gitCommit.test.js && node test/diag.test.js && node test/subagents.test.js && node test/nav.test.js && node test/sessionLedger.test.js && node test/update.test.js && node test/api.test.js && node test/dock.test.js && node test/status.service.test.js && node test/profile.service.test.js && node test/recovery.service.test.js",
+    "test:existing": "tsc src/codexHooks.ts src/i18n.ts src/prompt.ts src/detect.ts src/claudeHooks.ts src/screen.ts src/bind.ts src/order.ts src/reason.ts src/tabenv.ts src/viewer.ts src/markdown.ts src/ime.ts src/gitDiff.ts src/agents.ts src/group.ts src/project-root.ts src/gitCommit.ts src/diag.ts src/subagents.ts src/nav.ts src/keybind.ts src/sessionLedger.ts src/update.ts src/api.ts src/dock.ts src/status.service.ts src/profile.service.ts src/recovery.service.ts src/meta.ts src/statusLine.ts src/codexMeta.ts --outDir .tmp --module commonjs --target es2019 --skipLibCheck --experimentalDecorators --esModuleInterop && node test/version.test.js && node test/tags.test.js && node test/prompt.test.js && node test/detect.test.js && node test/claudeHooks.test.js && node test/screen.test.js && node test/bind.test.js && node test/order.test.js && node test/reason.test.js && node test/tabenv.test.js && node test/viewer.test.js && node test/markdown.test.js && node test/ime.test.js && node test/gitDiff.test.js && node test/agents.test.js && node test/group.test.js && node test/gitCommit.test.js && node test/diag.test.js && node test/subagents.test.js && node test/nav.test.js && node test/sessionLedger.test.js && node test/update.test.js && node test/api.test.js && node test/dock.test.js && node test/status.service.test.js && node test/profile.service.test.js && node test/recovery.service.test.js && node test/meta.test.js && node test/i18n.test.js && node test/statusLine.test.js && node test/hotkeys.test.js && node test/keybind.test.js && node test/codexMeta.test.js && node test/codexHooks.test.js",
     "test:codex": "node test/regression.cjs && node test/resume.cjs && node test/cursor.cjs && node test/wheel.cjs",
     "typecheck": "tsc --noEmit"
   },

package/updater/agentdeck-update.ps1

@@ -1,17 +1,20 @@
-# AgentDeck 자동 업데이트 — Tabby 가 **꺼진 뒤에** 설치하고 다시 띄운다.
+# AgentDeck 자동 업데이트 — 플러그인 폴더에 새 버전을 깐다.
 #
 #   powershell -NoProfile -ExecutionPolicy Bypass -File agentdeck-update.ps1 `
-#       -Version 1.1.1 -PluginsDir "<APPDATA>\tabby\plugins" -TabbyExe "<...>\Tabby.exe"
+#       -Version 1.1.1 -PluginsDir "<APPDATA>\tabby\plugins" -TabbyExe "<...>\Tabby.exe" -InPlace
 #
-# 왜 밖에서 도나 — 두 가지 때문이다.
-#  1. **돌고 있는 플러그인은 자기를 갈아끼울 수 없다.** Tabby 는 기동할 때 `dist/index.js` 를 한 번
-#     읽어 메모리에 올린다. 그 뒤 디스크를 바꿔도 돌고 있는 코드는 옛것 그대로다.
-#  2. **Windows 는 로드된 파일을 잡고 있다.** Tabby 가 떠 있는 동안 npm 이 그 폴더를 지우려 들면
-#     EPERM/EBUSY 로 반쯤 지운 채 실패할 수 있다 — 플러그인이 깨진 상태로 남는 것이 가장 나쁘다.
+# 모드가 둘이다.
 #
-# 그래서 순서가 이렇다: Tabby 종료를 기다린다 → 설치한다 → 다시 띄운다.
-# 이 스크립트는 **패키지 밖(임시 폴더)에서** 실행돼야 한다. 자기가 사는 폴더를 npm 이
-# 통째로 갈아엎기 때문이다 (`update.service.ts` 가 임시 폴더로 복사해 띄운다).
+#  **-InPlace (지금 쓰는 길)** — Tabby 가 **떠 있는 채로** 깐다. 기다리지도, 다시 띄우지도 않는다.
+#    적용은 플러그인이 창(renderer)만 리로드해서 한다(`src/reload.service.ts`) — 탭과 세션이 산다.
+#    로드된 `.js` 는 Windows 가 잡고 있지 않으므로(require 는 읽고 바로 닫는다) 폴더를 갈아끼워도 된다.
+#    이 모드에서는 부른 쪽이 **종료 코드를 기다린다** — 끝나야 리로드할 수 있기 때문이다.
+#
+#  **기본(옛 길)** — Tabby 종료를 기다린다 → 설치한다 → 다시 띄운다. 옛 버전이 띄운 스크립트나
+#    손으로 돌릴 때를 위해 남겨 둔다.
+#
+# 어느 쪽이든 이 스크립트는 **패키지 밖(임시 폴더)에서** 실행돼야 한다. 자기가 사는 폴더를
+# npm 이 통째로 갈아엎기 때문이다 (`update.service.ts` 가 임시 폴더로 복사해 띄운다).
 param(
     [Parameter(Mandatory = $true)][string]$Version,
     [Parameter(Mandatory = $true)][string]$PluginsDir,
@@ -22,7 +25,12 @@ param(
     [string]$LogFile = '',
     # Tabby 가 꺼지기를 기다리는 최대 시간(초). 넘으면 설치하지 않고 그냥 끝낸다 —
     # 떠 있는 상태로 설치하면 반쯤 지워진 플러그인이 남는다
-    [int]$WaitSeconds = 60
+    [int]$WaitSeconds = 60,
+    # Tabby 를 껐다 켜지 않는다 — 기다리지도 않고 다시 띄우지도 않는다
+    [switch]$InPlace,
+    # npm 에 건넬 대상. 기본은 `tabby-agentdeck@<Version>`(레지스트리)이고,
+    # **회귀는 지금 소스로 만든 tgz 경로를 준다** — 이미 배포된 버전에는 검증할 코드가 없다
+    [string]$Spec = ''
 )
 
 $ErrorActionPreference = 'Stop'
@@ -71,41 +79,49 @@ function Test-TabbyAlive ([int]$mainPid) {
     return $n
 }
 
-Write-Log "대기 대상: $(if ($TabbyPid -gt 0) { "pid=$TabbyPid (+자식)" } else { '이름으로 전부 (옛 방식)' })"
-$waited = 0
-while ($true) {
-    $alive = Test-TabbyAlive $TabbyPid
-    if ($alive -eq 0) { break }
-    if ($waited -ge $WaitSeconds) {
-        Write-Log "FAIL Tabby 가 ${WaitSeconds}초 안에 꺼지지 않았다 (남은 프로세스 ${alive}개) — 설치하지 않는다"
-        exit 2
+if ($InPlace) {
+    Write-Log 'InPlace — Tabby 종료를 기다리지 않는다 (적용은 플러그인이 창 리로드로 한다)'
+} else {
+    Write-Log "대기 대상: $(if ($TabbyPid -gt 0) { "pid=$TabbyPid (+자식)" } else { '이름으로 전부 (옛 방식)' })"
+    $waited = 0
+    while ($true) {
+        $alive = Test-TabbyAlive $TabbyPid
+        if ($alive -eq 0) { break }
+        if ($waited -ge $WaitSeconds) {
+            Write-Log "FAIL Tabby 가 ${WaitSeconds}초 안에 꺼지지 않았다 (남은 프로세스 ${alive}개) — 설치하지 않는다"
+            exit 2
+        }
+        Start-Sleep -Milliseconds 500
+        $waited += 0.5
     }
-    Start-Sleep -Milliseconds 500
-    $waited += 0.5
+    Write-Log "Tabby 종료 확인 (${waited}초 대기)"
+    # 핸들이 완전히 풀릴 여유를 조금 더 준다
+    Start-Sleep -Milliseconds 800
 }
-Write-Log "Tabby 종료 확인 (${waited}초 대기)"
-# 핸들이 완전히 풀릴 여유를 조금 더 준다
-Start-Sleep -Milliseconds 800
 
 # ── 2) 설치 ─────────────────────────────────────────────────────────────────
 # Tabby 의 플러그인 설치와 같은 방식이다 — `plugins/package.json` 에 의존성으로 적히고
 # `plugins/node_modules` 아래로 풀린다. `--prefix` 로 그 폴더를 가리킨다.
+$installed = $false
 $npm = (Get-Command npm.cmd -ErrorAction SilentlyContinue)
 if (-not $npm) { $npm = (Get-Command npm -ErrorAction SilentlyContinue) }
 if (-not $npm) {
     Write-Log 'FAIL npm 을 찾지 못했다 (PATH 에 node/npm 이 없다)'
     # npm 이 없어도 Tabby 는 다시 띄워 준다 — 사람의 창을 빼앗은 채 끝내면 안 된다
-    Write-Log '설치를 건너뛰고 Tabby 를 다시 띄운다'
+    Write-Log '설치를 건너뛴다'
 } else {
     Write-Log "npm=$($npm.Source)"
     # `$args` 는 PowerShell 자동 변수다 — 이름을 겹치면 조용히 이상하게 돈다
-    $npmArgs = @('install', '--prefix', $PluginsDir, '--no-audit', '--no-fund', "$pkg@$Version")
+    $target = if ($Spec) { $Spec } else { "$pkg@$Version" }
+    Write-Log "설치 대상: $target"
+    $npmArgs = @('install', '--prefix', $PluginsDir, '--no-audit', '--no-fund', $target)
     try {
         $out = & $npm.Source @npmArgs 2>&1
         $code = $LASTEXITCODE
         foreach ($line in $out) { Write-Log "npm| $line" }
         if ($code -eq 0) {
             Write-Log "OK 설치 완료 $pkg@$Version"
+            $installed = $true
         } else {
             Write-Log "FAIL npm exit=$code — 옛 버전이 그대로 남아 있을 수 있다"
         }
@@ -115,7 +131,14 @@ if (-not $npm) {
 }
 
 # ── 3) 다시 띄운다 ──────────────────────────────────────────────────────────
-# 설치가 실패했어도 반드시 띄운다. 업데이트를 고르느라 터미널을 잃는 일은 없어야 한다.
+# InPlace 면 애초에 닫지 않았으므로 띄울 것이 없다 — 부른 쪽이 창만 새로 고친다.
+# 옛 길에서는 **설치가 실패했어도 반드시 띄운다**. 업데이트를 고르느라 터미널을 잃는 일은 없어야 한다.
+if ($InPlace) {
+    Write-Log '=== update 끝 (InPlace — 적용은 플러그인이 창 리로드로 한다)'
+    # 부른 쪽이 이 코드를 본다. 다만 최종 판정은 디스크의 버전이다 (`installedVersion`)
+    exit $(if ($installed) { 0 } else { 1 })
+}
+
 try {
     if (Test-Path $TabbyExe) {
         Start-Process -FilePath $TabbyExe