tabby-agentdeck 0.1.0

package/dist/notify.service.d.ts

@@ -0,0 +1,89 @@
+import { AppService, ConfigService } from 'tabby-core';
+import { WorkStatusService } from './status.service';
+/**
+ * 외부 도구 -> 사이드바 상태 채널. **기본은 꺼져 있다** (`notifyChannel`).
+ *
+ * 라벨은 Enter 시점 입력창에서, 상태는 출력 패턴에서 플러그인이 스스로 얻는 것이 기본 경로다
+ * (claimEnterLabel / detect.ts). 설정 파일을 손봐야 도는 훅은 배포판에서 기대할 수 없어서
+ * 라벨 원천에서 내렸다. 이 채널은 외부 도구가 상태를 직접 보고하고 싶을 때만 켠다.
+ *
+ * 왜 파일인가 — 콘솔 제목 방식(`hooks/agentdeck-status.ps1`)은 **훅에서는 통하지 않는다**.
+ * Claude Code 는 훅을 파이프 stdio 로 띄우기 때문에 그 자식 프로세스는 터미널의 콘솔에
+ * 붙어 있지 않고, 제목을 바꿔도 pty 까지 오지 않는다 (2026-08-28 실측: 훅으로
+ * `[AD:waiting] ...` 을 걸어도 사이드바가 그대로였다). 셸 안에서 직접 실행할 때는
+ * 제목 방식이 여전히 유효하므로 그 경로는 남겨 둔다.
+ *
+ * 전달 경로는 두 가닥이다.
+ *
+ * 1. **TCP (기본)** — 이쪽이 `127.0.0.1` 임의 포트로 듣고, 실제 포트를
+ *    `%LOCALAPPDATA%\tabby-agentdeck\port` 에 적어 둔다. 훅은 그 포트로 JSON 한 줄을
+ *    보내고 끊는다. 폴링 지연이 없고 상태 파일도 남지 않는다.
+ * 2. **파일 (폴백)** — TCP 연결이 안 되면(Tabby 미기동, 포트 파일 없음, 방화벽)
+ *    훅이 `...\status\<sessionId>.json` 에 쓰고 이쪽이 400ms 마다 읽는다.
+ *
+ * 두 경로 모두 `apply()` 로 모이고, `applied` 의 ts 대조가 중복 적용을 막으므로
+ * 같은 보고가 양쪽으로 들어와도 결과는 같다.
+ *
+ * 세션 -> 탭 매칭: 어떤 Claude 세션이 **처음** 보고할 때의 활성 탭에 묶는다.
+ * 사용자가 프롬프트를 넣은 탭이 곧 활성 탭이므로 이 규칙이면 탭이 여러 개여도 맞다.
+ * 한 번 묶으면 그 뒤로는 활성 탭이 바뀌어도 같은 탭을 따라간다.
+ */
+export declare class WorkNotifyService {
+    private app;
+    private config;
+    private status;
+    private root;
+    private dir;
+    /** 훅이 접속할 포트를 알려주는 파일 */
+    private portFile;
+    private server;
+    private sessionTab;
+    /** 역방향 — 한 탭을 두 세션이 나눠 쓰지 못하게 막는다 */
+    private tabSession;
+    /** 이미 적용한 (sessionId -> ts) — 같은 파일을 반복 적용하지 않는다 */
+    private applied;
+    private timer;
+    /** 폴링을 시작한 시각 — 이보다 오래된 파일은 지난 실행의 잔재다 */
+    private startedAt;
+    constructor(app: AppService, config: ConfigService, status: WorkStatusService);
+    init(): void;
+    /** 진단용 */
+    get debugDir(): string;
+    /** 진단용 — 듣고 있는 포트 (0 = TCP 채널이 안 떴다) */
+    get debugPort(): number;
+    /**
+     * 훅이 상태를 바로 밀어 넣을 TCP 채널을 연다.
+     *
+     * 기본은 `agentDeck.notifyPort` 고정 포트다 — 번호가 늘 같아야 훅이나 진단 도구가
+     * 바로 붙을 수 있다. Windows 임시 포트 범위(49152~65535) 아래로 잡아 두어야
+     * OS 가 그 번호를 다른 프로세스에 먼저 내주는 일이 없다.
+     *
+     * 그 번호가 이미 물려 있으면(Tabby 두 개, 다른 프로그램) 0 으로 다시 시도한다 —
+     * OS 가 빈 포트를 골라 준다. 어느 쪽이든 실제 번호는 port 파일에 적어 두므로
+     * 훅은 고정/임의를 구분할 필요가 없다. 둘 다 실패해도 파일 폴백이 살아 있다.
+     */
+    private listen;
+    /** TCP 로 들어온 JSON 한 줄 */
+    private accept;
+    private poll;
+    /**
+     * 보고 한 건을 반영한다. `status` / `label` 은 **각각 선택**이고, 빠진 쪽은 지금 값을 유지한다.
+     *
+     * 병합 규칙을 여기(플러그인)에 둔 이유 — 예전에는 훅 스크립트가 status 파일을 읽어
+     * 직전 값과 합친 뒤 다시 쓰는 read-modify-write 를 했다. 그러면 진짜 상태가 파일과
+     * 플러그인 메모리 두 곳에 살고 병합 규칙이 PowerShell 안에 숨는다. 라벨만 바꾸려 해도
+     * 직전 status 를 채워 넣어야 했고(안 채우면 여기서 통째로 버려졌다), 파일이 밀리면
+     * 표시가 어긋났다. 보내는 쪽은 "자기가 아는 것만" 보내고 합치는 건 상태를 실제로
+     * 들고 있는 이쪽이 한다 — 그래야 어느 경로로 들어오든 결과가 같다.
+     */
+    private apply;
+    /**
+     * 세션에 묶인 탭을 찾는다. 처음 보는 세션이면 지금 활성 탭에 묶는다.
+     *
+     * 단 그 탭을 이미 다른 세션이 점유했으면 **묶지 않는다**. 예전엔 이 검사가 없어서
+     * 여러 세션이 한 탭에 겹쳐 붙었고, 서로의 상태를 덮어써 "작업 중인 탭이 완료로,
+     * 끝난 탭이 진행 중으로" 뒤바뀌어 보였다. 못 묶은 세션은 사용자가 그 탭을 활성화하는
+     * 순간(= 다음 보고 때) 제 짝을 찾는다.
+     */
+    private resolveTab;
+}

package/dist/profile.service.d.ts

@@ -0,0 +1,16 @@
+import { AppService, ConfigService } from 'tabby-core';
+export declare const ROOT_PROFILE_ID = "agentdeck:root";
+/**
+ * 새 탭이 항상 작업 루트에서 열리게 한다.
+ *
+ * Tabby 프로필을 하나 만들어 config 에 심고, 사용자가 아직 기본 프로필을
+ * 직접 고른 적이 없으면 이것을 기본으로 지정한다.
+ * 한 번 심은 뒤에는 사용자가 설정에서 바꾼 값을 존중한다 (매 기동 덮어쓰지 않음).
+ */
+export declare class AgentDeckProfileService {
+    private app;
+    private config;
+    constructor(app: AppService, config: ConfigService);
+    init(): void;
+    private ensureProfile;
+}

package/dist/prompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 터미널 화면에 그려진 입력창에서 지금 쓰여 있는 프롬프트를 뽑아낸다.
+ *
+ * 타이핑을 따로 세지 않고 화면을 읽는 이유 — 붙여넣기·↑ 히스토리·자동완성·IME 로 들어온 글자는
+ * 키 이벤트로 안 오거나 원문과 다르다. 화면에 실제로 그려진 것이 곧 보낼 내용이다.
+ *
+ * 입력창 모양은 앱·버전마다 다르다. 옛 Claude Code / Codex 는 테두리 상자였고
+ *   ╭────────────────────╮
+ *   │ > 프롬프트 내용      │
+ *   ╰────────────────────╯
+ * Claude Code 2.1.x 는 상자를 버리고 위아래 가로선 사이에 한 줄만 그린다.
+ *   ────────────────────────
+ *   ❯ 프롬프트 내용
+ *   ────────────────────────
+ *     ? for shortcuts
+ * 머리글자도 ASCII `>` 가 아니라 `❯`(U+276F) 다 — 2026-09-01 화면 캡처로 확인.
+ * `>` 만 찾던 정규식이 이걸 못 잡아 라벨이 한 번도 안 바뀌었다.
+ *
+ * 머리를 못 찾으면 빈 문자열을 준다 — 일반 셸이나 y/n 확인 같은 데서 엉뚱한 라벨이 박히느니
+ * 라벨을 그대로 두는 편이 낫다.
+ *
+ * 화면 버퍼를 직접 받지 않고 줄 배열만 받는 순수 함수로 둔다 (xterm 없이 검증할 수 있게).
+ */
+/** 사이드바에 들어가는 라벨 길이 */
+export declare const MAX_LABEL_LEN = 40;
+export declare function extractPrompt(lines: string[]): string;

package/dist/status.service.d.ts

@@ -0,0 +1,32 @@
+import { Observable } from 'rxjs';
+import { BaseTabComponent } from 'tabby-core';
+import { TabState, WorkStatus } from './api';
+/**
+ * 탭별 작업 상태 보관소.
+ * 상태의 출처는 3가지 — 자동 감지(decorator), OSC 시퀀스(Claude Code 훅), 사이드바에서의 수동 지정.
+ * pinned 가 true 면 자동 감지가 값을 덮어쓰지 않는다.
+ */
+export declare class WorkStatusService {
+    private states;
+    private changed;
+    /** 진단용 카운터 — decorator 가 실제로 붙었는지, 출력이 흘러오는지 확인한다 */
+    debug: {
+        attached: number;
+        outputs: number;
+        oscHits: number;
+        titleHits: number;
+    };
+    get changed$(): Observable<void>;
+    get(tab: BaseTabComponent): TabState;
+    /** 자동 감지용 — pinned 상태는 건드리지 않는다 */
+    setAuto(tab: BaseTabComponent, status: WorkStatus): void;
+    /** 수동/훅 지정 — 이후 자동 감지보다 우선한다 */
+    setManual(tab: BaseTabComponent, status: WorkStatus, label?: string): void;
+    setLabel(tab: BaseTabComponent, label: string): void;
+    /** 수동 고정을 풀고 자동 감지로 되돌린다 */
+    unpin(tab: BaseTabComponent): void;
+    markOutput(tab: BaseTabComponent): void;
+    forget(tab: BaseTabComponent): void;
+    /** 사이드바가 매 틱 호출 — idle 전환만 담당하고 화면 갱신 필요 여부를 돌려준다 */
+    tickIdle(tab: BaseTabComponent, idleAfterMs: number): boolean;
+}

package/hooks/agentdeck-label.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * 작업 라벨만 바꾼다 (상태는 건드리지 않는다).
+ *
+ *   node agentdeck-label.js <sessionId> "회랑 정산 버그 수정"
+ *   AGENTDECK_SESSION=<id> node agentdeck-label.js "빌드 중"
+ *
+ * 에이전트가 단계(분석→구현→빌드→검증)를 넘어갈 때마다 부르는 용도다.
+ * PowerShell 훅(agentdeck-notify.ps1)은 프로세스 기동만 100ms 대라 자주 부르기엔 무겁고,
+ * 그쪽은 status 파일을 읽어 직전 값과 합치는 read-modify-write 를 한다. 여기서는
+ * 아는 것(라벨)만 보내고 병합은 플러그인이 한다 (notify.service.ts apply 주석 참고).
+ *
+ * TCP(127.0.0.1:47500)로 한 줄 밀어넣고, Tabby 가 안 떠 있으면 status 파일로 폴백한다.
+ * 파일도 부분 갱신을 이해하므로 status 를 지어내지 않는다.
+ */
+const net = require('net')
+const fs = require('fs')
+const path = require('path')
+
+const args = process.argv.slice(2)
+const sessionId = args.length > 1 ? args[0] : process.env.AGENTDECK_SESSION
+const label = (args.length > 1 ? args[1] : args[0] || '').trim()
+const port = Number(process.env.AGENTDECK_PORT || 47500)
+
+if (!sessionId || !label) {
+    console.error('usage: agentdeck-label.js <sessionId> "<label>"  (or AGENTDECK_SESSION env)')
+    process.exit(2)
+}
+
+const payload = JSON.stringify({ sessionId, label, ts: Date.now() }) + '\n'
+
+const fallback = () => {
+    const dir = path.join(process.env.LOCALAPPDATA || process.env.HOME, 'tabby-agentdeck', 'status')
+    try {
+        fs.mkdirSync(dir, { recursive: true })
+        // 직전 status 를 읽어 합치지 않는다 — 플러그인이 없는 필드를 지금 값으로 채운다
+        fs.writeFileSync(path.join(dir, sessionId + '.json'), payload.trim(), 'utf8')
+        console.log('label -> file')
+    } catch (e) {
+        console.error('label failed: ' + e.message)
+        process.exit(1)
+    }
+}
+
+const sock = net.connect({ port, host: '127.0.0.1' }, () => {
+    sock.end(payload, () => {
+        console.log('label -> tcp:' + port)
+        process.exit(0)
+    })
+})
+sock.setTimeout(700)
+sock.on('timeout', () => { sock.destroy(); fallback() })
+sock.on('error', () => fallback())

package/hooks/agentdeck-notify.ps1

@@ -0,0 +1,159 @@
+<#
+.SYNOPSIS
+  Claude Code 훅 -> AgentDeck 사이드바 상태/작업이름 통보.
+
+.DESCRIPTION
+  `%LOCALAPPDATA%\tabby-agentdeck\status\<session_id>.json` 에 상태를 쓴다.
+  Tabby 쪽 WorkNotifyService 가 이 폴더를 400ms 마다 읽어 사이드바에 반영한다.
+
+  왜 파일인가 — 콘솔 제목 방식(agentdeck-status.ps1)은 훅에서는 통하지 않는다.
+  Claude Code 가 훅을 파이프 stdio 로 띄우므로 그 프로세스는 터미널 콘솔에 붙어
+  있지 않고, 제목을 바꿔도 pty 까지 전달되지 않는다 (2026-08-28 실측).
+
+  라벨은 stdin 으로 들어온 훅 JSON 의 prompt 를 쓴다. prompt 가 없는 훅
+  (Stop / Notification) 이면 기존 파일의 라벨을 그대로 유지한다.
+
+  stdout 으로 아무것도 내보내지 않는다 — UserPromptSubmit 훅의 stdout 은
+  프롬프트 컨텍스트로 주입되기 때문이다.
+
+.PARAMETER Status
+  running(진행중) / waiting(승인대기) / done(완료) / error(오류) / idle(대기)
+
+.EXAMPLE
+  # settings.json
+  # "UserPromptSubmit": powershell -NoProfile -File agentdeck-notify.ps1 -Status running
+  # "Stop":             powershell -NoProfile -File agentdeck-notify.ps1 -Status done
+#>
+param(
+    [ValidateSet('running', 'waiting', 'done', 'error', 'idle')]
+    [string]$Status,
+
+    # Claude 가 직접 정한 작업 이름. 이게 있으면 무엇보다 우선한다
+    [string]$Label,
+
+    # stdin 훅 JSON 없이 부를 때 대상 세션 (없으면 가장 최근에 갱신된 세션)
+    [string]$SessionId,
+
+    # UserPromptSubmit 훅 전용 — 라벨이 아직 비어 있을 때만 프롬프트로 채운다
+    [switch]$PromptAsLabel,
+
+    [int]$MaxLabel = 40
+)
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+try {
+    # PS 5.1 은 stdin 을 시스템 ANSI(CP949) 로 읽어 UTF-8 JSON 의 한글을 깨뜨린다.
+    # 표준입력 스트림을 UTF-8 로 직접 열어서 읽는다
+    $reader = New-Object System.IO.StreamReader([Console]::OpenStandardInput(), (New-Object System.Text.UTF8Encoding($false)))
+    $raw = $reader.ReadToEnd()
+    $reader.Close()
+    $hook = if ($raw) { $raw | ConvertFrom-Json } else { $null }
+} catch {
+    $hook = $null
+}
+
+$dir = Join-Path $env:LOCALAPPDATA 'tabby-agentdeck\status'
+if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }
+
+# 세션 결정 — 훅 JSON > -SessionId > 가장 최근에 갱신된 파일
+$targetId = ''
+if ($hook -and $hook.session_id) {
+    $targetId = [string]$hook.session_id
+} elseif ($SessionId) {
+    $targetId = $SessionId
+} else {
+    $recent = Get-ChildItem -Path $dir -Filter '*.json' -ErrorAction SilentlyContinue |
+        Sort-Object LastWriteTime -Descending | Select-Object -First 1
+    if ($recent) { $targetId = [System.IO.Path]::GetFileNameWithoutExtension($recent.Name) }
+}
+if (-not $targetId) { $targetId = 'default' }
+# 파일명에 못 쓰는 문자 제거
+$safeId = ($targetId -replace '[^A-Za-z0-9._-]', '_')
+$file = Join-Path $dir "$safeId.json"
+
+# 직전 상태를 읽어 둔다 — 라벨 유지와 승인대기 오탐 방지에 쓴다
+$prevStatus = ''
+$prevLabel = ''
+if (Test-Path $file) {
+    try {
+        $prev = Get-Content -Raw -Encoding UTF8 $file | ConvertFrom-Json
+        $prevStatus = [string]$prev.status
+        $prevLabel = [string]$prev.label
+    } catch { }
+}
+
+# --- 승인대기 오탐 차단 ---
+# Notification 훅은 "도구 승인 요청" 말고 "입력이 없다"는 유휴 알림에도 발화한다.
+# 그래서 Stop(done) 뒤에 유휴 알림이 오면 완료된 탭이 '승인대기' 로 뒤집힌다 (2026-08-28 실측:
+# status 폴더의 두 세션이 작업을 끝냈는데도 waiting 으로 박혀 있었다).
+# 승인 요청이 아닌 알림이면 상태를 건드리지 않는다.
+if ($Status -eq 'waiting') {
+    $msg = if ($hook -and $hook.message) { [string]$hook.message } else { '' }
+    $idleNotice = $msg -match '(?i)waiting for your input|idle'
+    $alreadyFinished = $prevStatus -eq 'done' -or $prevStatus -eq 'idle'
+    if ($idleNotice -or $alreadyFinished) { exit 0 }
+}
+
+# --- 라벨 결정 ---
+# 우선순위: 명시 -Label > 기존 라벨 유지 > (PromptAsLabel 이고 기존 라벨이 없을 때만) 프롬프트
+#
+# 프롬프트를 무조건 라벨로 쓰지 않는 이유: 사용자가 친 문장이 그대로 작업 이름으로 박혀서
+# ("승인대기가 아닌데 왜 승인대기로 나오냐?" 같은 게 라벨이 됐다) 무슨 작업인지 알 수 없게 된다.
+# 작업 이름은 Claude 가 진행도에 맞춰 -Label 로 갱신하는 것이 정상 경로이고,
+# 프롬프트는 그게 아직 한 번도 안 왔을 때의 첫 화면용 폴백일 뿐이다.
+$newLabel = $prevLabel
+if ($Label) {
+    $newLabel = $Label
+} elseif ($PromptAsLabel -and -not $prevLabel -and $hook -and $hook.prompt) {
+    $newLabel = ([string]$hook.prompt -split "`r?`n" | Where-Object { $_.Trim() } | Select-Object -First 1)
+    if ($null -eq $newLabel) { $newLabel = '' }
+}
+$newLabel = ($newLabel -replace '\s+', ' ').Trim()
+if ($newLabel.Length -gt $MaxLabel) { $newLabel = $newLabel.Substring(0, $MaxLabel).TrimEnd() + '...' }
+
+# -Status 없이 -Label 만 주면 상태는 그대로 두고 이름만 바꾼다
+$effectiveStatus = if ($Status) { $Status } elseif ($prevStatus) { $prevStatus } else { 'running' }
+
+$payload = [ordered]@{
+    sessionId = $targetId
+    status    = $effectiveStatus
+    label     = $newLabel
+    ts        = [int64](([datetime]::UtcNow - [datetime]'1970-01-01').TotalMilliseconds)
+}
+
+# BOM 없는 UTF-8 로 원자적 쓰기 — Node 의 JSON.parse 는 BOM 을 못 먹는다
+#
+# TCP 로 밀어 넣더라도 이 파일 쓰기는 건너뛰지 않는다 — 파일이 곧 상태 저장소라서
+# 다음 훅 호출이 여기서 직전 상태/라벨을 읽는다(위 $prevStatus / $prevLabel).
+# 그게 라벨 유지와 '승인대기 오탐 차단' 의 근거다.
+$json = $payload | ConvertTo-Json -Compress
+$tmp = "$file.tmp"
+$enc = New-Object System.Text.UTF8Encoding($false)
+[System.IO.File]::WriteAllText($tmp, $json, $enc)
+[System.IO.File]::Copy($tmp, $file, $true)
+Remove-Item $tmp -Force
+
+# --- TCP 즉시 통보 ---
+# Tabby 의 WorkNotifyService 가 127.0.0.1 임의 포트로 듣고 그 번호를 port 파일에 적어 둔다.
+# 여기로 JSON 한 줄을 보내면 폴링을 기다리지 않고 사이드바가 바로 바뀐다.
+# 실패는 전부 무시한다 — Tabby 가 안 떠 있거나 포트가 바뀐 것뿐이고, 위에 쓴 파일을 폴링이 주워 간다.
+$portFile = Join-Path $env:LOCALAPPDATA 'tabby-agentdeck\port'
+if (Test-Path $portFile) {
+    try {
+        $port = [int]((Get-Content -Raw $portFile).Trim())
+        if ($port -gt 0) {
+            $client = New-Object System.Net.Sockets.TcpClient
+            # 훅은 매 이벤트마다 도는 경로다 — Tabby 가 없을 때 여기서 붙잡히면 안 된다
+            if ($client.ConnectAsync('127.0.0.1', $port).Wait(200)) {
+                $bytes = $enc.GetBytes($json + "`n")
+                $stream = $client.GetStream()
+                $stream.Write($bytes, 0, $bytes.Length)
+                $stream.Flush()
+                $stream.Close()
+            }
+            $client.Close()
+        }
+    } catch { }
+}
+exit 0

package/hooks/agentdeck-status.ps1

@@ -0,0 +1,33 @@
+<#
+.SYNOPSIS
+  Claude Code 훅에서 AgentDeck 사이드바에 작업 상태를 통보한다.
+
+.DESCRIPTION
+  콘솔 제목을 `[AD:<status>] <라벨>` 형태로 바꾸면 AgentDeck 플러그인이 그것을 읽어
+  사이드바 배지/라벨에 반영한다.
+
+  왜 제목인가 — Windows 의 ConPTY 는 자기가 모르는 OSC 이스케이프를 삼켜서
+  커스텀 시퀀스가 터미널까지 오지 못한다(2026-08-28 실측). 반면 콘솔 제목은
+  ConPTY 가 API 로 변환해 전달하므로 확실히 통과한다.
+
+.PARAMETER Status
+  running(진행중) / waiting(승인대기) / done(완료) / error(오류) / idle(대기)
+
+.PARAMETER Label
+  사이드바에 함께 보일 작업 이름.
+
+.EXAMPLE
+  powershell -NoProfile -File agentdeck-status.ps1 -Status running -Label "결제 버그 수정"
+  powershell -NoProfile -File agentdeck-status.ps1 -Status waiting -Label "배포 승인"
+#>
+param(
+    [Parameter(Mandatory = $true)]
+    [ValidateSet('running', 'waiting', 'done', 'error', 'idle')]
+    [string]$Status,
+
+    [string]$Label = ''
+)
+
+$title = if ($Label) { "[AD:$Status] $Label" } else { "[AD:$Status]" }
+$host.UI.RawUI.WindowTitle = $title
+Write-Output $title

package/install.ps1

@@ -0,0 +1,82 @@
+<#
+.SYNOPSIS
+  AgentDeck 플러그인을 Tabby 에 연결하고, 관리자 권한 실행 바로가기를 만든다.
+
+.DESCRIPTION
+  Tabby 는 사용자 플러그인 디렉토리(userData/plugins/node_modules)를 스캔하므로
+  이 스크립트는 그곳에 프로젝트 폴더를 가리키는 junction 을 만든다.
+  소스를 고치고 `npm run build` 만 하면 Tabby 재시작으로 바로 반영된다.
+
+.PARAMETER Shortcut
+  바탕화면에 "Tabby (AgentDeck)" 관리자 권한 바로가기를 만든다.
+  Tabby 를 관리자로 띄우면 그 안에서 열리는 모든 탭이 권한을 물려받으므로
+  탭마다 UAC 창이 뜨는 것을 피할 수 있다.
+
+.EXAMPLE
+  powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1 -Shortcut
+#>
+param(
+    [switch]$Shortcut
+)
+
+$ErrorActionPreference = 'Stop'
+$source = $PSScriptRoot
+$pluginRoot = Join-Path $env:APPDATA 'tabby\plugins\node_modules'
+$link = Join-Path $pluginRoot 'tabby-agentdeck'
+
+# 1) 빌드 산출물 확인
+if (-not (Test-Path (Join-Path $source 'dist\index.js'))) {
+    Write-Warning "dist\index.js 가 없다. 먼저 'npm install' 후 'npm run build' 를 실행할 것."
+}
+
+# 2) 플러그인 디렉토리에 junction 연결
+New-Item -ItemType Directory -Force -Path $pluginRoot | Out-Null
+if (Test-Path $link) {
+    Remove-Item $link -Force -Recurse
+}
+New-Item -ItemType Junction -Path $link -Target $source | Out-Null
+Write-Host "연결됨: $link -> $source"
+
+# 2-1) plugins\package.json 에 file: 의존성으로 등록
+#     Tabby 플러그인 매니저가 다른 플러그인을 설치하면 npm install 이 돌면서
+#     package.json 에 없는 node_modules 항목을 extraneous 로 보고 지운다.
+#     여기 등록해두면 junction 이 정식 의존성이 되어 살아남는다.
+$pkgPath = Join-Path (Split-Path $pluginRoot) 'package.json'
+if (Test-Path $pkgPath) {
+    $pkg = Get-Content $pkgPath -Raw | ConvertFrom-Json
+} else {
+    $pkg = [pscustomobject]@{ dependencies = [pscustomobject]@{} }
+}
+if (-not $pkg.dependencies) {
+    $pkg | Add-Member -NotePropertyName dependencies -NotePropertyValue ([pscustomobject]@{}) -Force
+}
+$spec = 'file:' + ($source -replace '\\', '/')
+$pkg.dependencies | Add-Member -NotePropertyName 'tabby-agentdeck' -NotePropertyValue $spec -Force
+$pkg | ConvertTo-Json -Depth 10 | Out-File $pkgPath -Encoding utf8
+Write-Host "의존성 등록: $pkgPath (tabby-agentdeck = $spec)"
+
+# 3) 관리자 권한 바로가기
+if ($Shortcut) {
+    $exe = Join-Path $env:LOCALAPPDATA 'Programs\Tabby\Tabby.exe'
+    if (-not (Test-Path $exe)) {
+        throw "Tabby.exe 를 찾지 못했다: $exe"
+    }
+
+    $lnkPath = Join-Path ([Environment]::GetFolderPath('Desktop')) 'Tabby (AgentDeck).lnk'
+    $shell = New-Object -ComObject WScript.Shell
+    $lnk = $shell.CreateShortcut($lnkPath)
+    $lnk.TargetPath = $exe
+    $lnk.WorkingDirectory = Split-Path $exe
+    $lnk.Description = 'Tabby + AgentDeck (관리자 권한)'
+    $lnk.Save()
+
+    # 바로가기에 "관리자 권한으로 실행" 플래그를 세운다 (.lnk 바이너리의 21번째 바이트 0x20 비트)
+    $bytes = [System.IO.File]::ReadAllBytes($lnkPath)
+    $bytes[0x15] = $bytes[0x15] -bor 0x20
+    [System.IO.File]::WriteAllBytes($lnkPath, $bytes)
+
+    Write-Host "바로가기 생성: $lnkPath (관리자 권한)"
+}
+
+Write-Host ""
+Write-Host "Tabby 를 재시작하면 적용된다."

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "tabby-agentdeck",
+  "version": "0.1.0",
+  "description": "Run AI coding agents side by side in Tabby - a live deck of agent sessions with status, agent-friendly hotkeys and image paste",
+  "keywords": [
+    "tabby-plugin",
+    "tabby",
+    "ai",
+    "agent",
+    "claude-code",
+    "codex",
+    "terminal"
+  ],
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "scripts": {
+    "build": "webpack --progress --color",
+    "watch": "webpack --progress --color --watch",
+    "test": "tsc src/prompt.ts --outDir .tmp --module commonjs --target es2019 && node test/prompt.test.js"
+  },
+  "files": [
+    "dist",
+    "hooks",
+    "install.ps1"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@angular/common": "^15.2.6",
+    "@angular/core": "^15.2.6",
+    "@angular/forms": "^15.2.6",
+    "@types/node": "^20.19.43",
+    "@types/webpack-env": "^1.18.4",
+    "css-loader": "^6.10.0",
+    "rxjs": "^7.5.7",
+    "sass": "^1.71.1",
+    "sass-loader": "^14.1.1",
+    "style-loader": "^3.3.4",
+    "tabby-core": "^1.0.231-nightly.0",
+    "tabby-local": "^1.0.231-nightly.0",
+    "tabby-settings": "^1.0.231-nightly.0",
+    "tabby-terminal": "^1.0.231-nightly.0",
+    "ts-loader": "^9.5.1",
+    "typescript": "^4.9.5",
+    "webpack": "^5.90.0",
+    "webpack-cli": "^5.1.4"
+  },
+  "author": {
+    "name": "junggon"
+  }
+}