cli-jaw 2.1.3 → 2.1.6-preview.20260621123500

package/README.ja.md

@@ -90,7 +90,7 @@ docker compose up -d       # → http://localhost:3457
 
 ## CLI-JAW とは
 
-CLI-JAW は、すでに使っている AI コーディング CLI — Antigravity、AI-E、Claude、Claude E、Codex、Codex App、Cursor、Gemini、Grok、OpenCode、Copilot — を**ひとつのアシスタント、ひとつのメモリ、ひとつのダッシュボード**に統合するオープンソースプラットフォームです。
+CLI-JAW は、すでに使っている AI コーディング CLI — Pi、Antigravity、AI-E、Claude、Claude E、Codex、Codex App、Cursor、Gemini、Grok、Kiro、OpenCode、Copilot — を**ひとつのアシスタント、ひとつのメモリ、ひとつのダッシュボード**に統合するオープンソースプラットフォームです。
 
 メイン CLI（Boss）が他の CLI を「Employee（従業員）」として呼び出します。アプリを切り替える必要はなく、ひとつの場所から指示できます。
 
@@ -247,6 +247,7 @@ Employee は「Frontend は CSS、Backend は API」用。サブエージェン
 
 | CLI | デフォルトモデル | 認証 | コスト |
 |---|---|---|---|
+| **Pi** | `grok-composer-2.5-fast` | Settings profile API key、local proxy、または `PI_CODING_AGENT_BIN` | isolated `PI_CODING_AGENT_DIR` で local/API endpoint を接続する first-class `pi --mode rpc` runtime |
 | **Claude** | `claude-opus-4-8` | `claude auth login` | Claude Pro サブスクリプション以上 |
 | **Claude E** | `claude-opus-4-8` | underlying `claude auth login` | Claude Pro サブスクリプション以上。6月のサブスク付与枠では推奨 runtime |
 | **AI-E** | provider-selected | 選択 provider の認証 | マルチ provider runtime wrapper |
@@ -261,7 +262,7 @@ Employee は「Frontend は CSS、Backend は API」用。サブエージェン
 
 GPT 5.5 と Claude Opus 4.8 は Pro 以上のサブスクリプションで利用できます。6月からサブスクに含まれる Claude 利用枠を使う場合は、`claude-e` runtime を選択してください。
 
-クォータ/ステータスパネルは registry と同じ runtime キーセットを維持します。Wrapper runtime（`ai-e`, `claude-e`, `codex-app`）は underlying provider に委譲し、AGY/Cursor/Grok/OpenCode のように CLI が quota window を公開しない場合は auth/status-only として表示します。
+クォータ/ステータスパネルは registry と同じ runtime キーセットを維持します。Wrapper runtime（`ai-e`, `claude-e`, `codex-app`）は underlying provider に委譲し、Pi/AGY/Cursor/Grok/OpenCode のように CLI が quota window を公開しない場合は auth/status-only として表示します。
 
 **フォールバックチェーン**：あるエンジンがレートリミットされると、次のエンジンが自動で引き継ぎます。`/fallback [cli1 cli2...]` で設定。
 
@@ -339,7 +340,7 @@ jaw skill list              # 利用可能なスキルを表示
 | **Chrome DevTools Protocol** | ナビゲーション、クリック、入力、スクリーンショット、JS 実行、スクロール、キー入力 — Chrome のリモートコントロール |
 | **Vision-click** | 画面をスクリーンショット → AI がターゲット座標を抽出 → クリック。`jaw browser vision-click "Login button"` |
 | **Computer Use** | Codex Computer Use によるデスクトップアプリ自動化。Safari で localhost にアクセスすれば Codex アプリのように動作 |
-| **Web-AI ベンダー** | `jaw browser web-ai --vendor chatgpt\|gemini\|grok` — セッションライフサイクル、診断、ソース監査サポート |
+| **Web-AI ベンダー** | `jaw browser web-ai --vendor chatgpt\|gemini\|grok` — セッションライフサイクル、診断、ソース監査、ChatGPT code-mode zip 回収サポート |
 | **Diagram スキル** | SVG ダイアグラムとインタラクティブなビジュアライゼーションを生成し、チャット内にインラインレンダリング |
 
 Computer Use で Finder、Safari、システム設定、Xcode など、あらゆる macOS アプリを自然言語で操作できます。
@@ -462,7 +463,7 @@ npm run gate:all       # リリース/ドキュメント整合性ゲート
 
 | | CLI-JAW 2.0 | Hermes Agent | Claude Code |
 |---|---|---|---|
-| **モデルアクセス** | Antigravity、AI-E、Claude、Claude E、Codex、Codex App、Cursor、Gemini、Grok、OpenCode、Copilot — ベンダー/ネイティブ認証経由 | API キー（OpenRouter 200+、Nous Portal） | Anthropic のみ |
+| **モデルアクセス** | Pi、Antigravity、AI-E、Claude、Claude E、Codex、Codex App、Cursor、Gemini、Grok、Kiro、OpenCode、Copilot — ベンダー/ネイティブ認証経由 | API キー（OpenRouter 200+、Nous Portal） | Anthropic のみ |
 | **コストモデル** | 契約済みの月額サブスクリプション | トークン単位の API 課金 | Anthropic サブスクリプション |
 | **メイン UI** | マネージャーダッシュボード + Web アプリ + Mac アプリ + ターミナル UI | ターミナルのみ | CLI + IDE プラグイン |
 | **ダッシュボード** | マルチインスタンスマネージャー、カンバン、ノートワークスペース | なし | なし |

package/README.ko.md

@@ -2,12 +2,12 @@
 
 # CLI-JAW
 
-### 나만의 AI 에이전트. 2줄이면 설치 끝. 11개 AI 런타임을 하나의 대시보드에서.
+### 나만의 AI 에이전트. 2줄이면 설치 끝. 13개 AI 런타임 표면을 하나의 대시보드에서.
 
 [![npm](https://img.shields.io/npm/v/cli-jaw)](https://npmjs.com/package/cli-jaw)
-[![Version](https://img.shields.io/badge/v2.0.0-GA-brightgreen)](https://github.com/lidge-jun/cli-jaw/releases)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://typescriptlang.org)
-[![Node](https://img.shields.io/badge/node-%3E%3D22-blue)](https://nodejs.org)
+[![Version](https://img.shields.io/badge/v2.1.3-GA-brightgreen)](https://github.com/lidge-jun/cli-jaw/releases)
+[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue)](https://typescriptlang.org)
+[![Node](https://img.shields.io/badge/node-%3E%3D22.4-blue)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
 [![Docker](https://img.shields.io/badge/Docker-supported-2496ED?logo=docker&logoColor=white)](#-docker)
 
@@ -31,12 +31,12 @@ Windows 사용자는 아래 WSL 설치 경로를 사용하세요. 네이티브 P
 </details>
 
 ```bash
-# macOS / Linux / WSL, Node.js 22+가 이미 설치된 경우
+# macOS / Linux / WSL, Node.js 22.4+가 이미 설치된 경우
 npm install -g cli-jaw
 jaw dashboard
 ```
 
-끝입니다. **http://localhost:3457** 을 열면 나만의 AI 에이전트가 준비됩니다. [Node.js 22+](https://nodejs.org) 필요.
+끝입니다. 매니저 대시보드는 **http://localhost:24576** 에서 열립니다. 개별 에이전트 Web UI는 `jaw serve` 실행 시 **http://localhost:3457** 에서 동작합니다. [Node.js 22.4+](https://nodejs.org) 필요.
 
 > **처음이세요?** 기본 npm 설치는 CLI-JAW 초기화와 네이티브 Claude 설정을 시도합니다. 다른 AI CLI는 선택 사항입니다. macOS/Linux에서 npm 설치 중 모두 설치하려면 `CLI_JAW_INSTALL_CLI_TOOLS=1 npm install -g cli-jaw`를 사용하세요. Windows에서는 아래 WSL 설치 경로를 사용하세요.
 
@@ -77,6 +77,47 @@ wsl.exe -d Ubuntu -- bash -lc "jaw dashboard"
 
 </details>
 
+<details>
+<summary><b>Fresh-machine evidence</b> — maintainer release check</summary>
+
+설치 스크립트나 릴리스 설치 경로를 바꾸기 전에는 깨끗한 VM에서 이 절차를 실행하세요. collector는 환경 스냅샷, installer 로그, 실제 실행된 collector/installer/verifier 스크립트와 SHA-256 해시, verifier 로그, 새 shell PATH probe를 `~/cli-jaw-fresh-install-evidence-*`에 저장합니다.
+
+```bash
+# macOS Terminal
+COLLECTOR=/tmp/cli-jaw-collect-fresh-install-evidence.sh
+curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/collect-fresh-install-evidence.sh -o "$COLLECTOR"
+bash "$COLLECTOR" --target macos
+
+# Ubuntu inside WSL
+COLLECTOR=/tmp/cli-jaw-collect-fresh-install-evidence.sh
+curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/collect-fresh-install-evidence.sh -o "$COLLECTOR"
+bash "$COLLECTOR" --target wsl
+```
+
+Windows PowerShell에서는 지원되는 WSL 경로로 실행하세요:
+
+```powershell
+wsl.exe -d Ubuntu -- bash -lc 'COLLECTOR=/tmp/cli-jaw-collect-fresh-install-evidence.sh; curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/collect-fresh-install-evidence.sh -o "$COLLECTOR"; bash "$COLLECTOR" --target wsl'
+```
+
+각 evidence 디렉터리를 릴리스 증거로 쓰기 전에 audit하세요:
+
+```bash
+EVIDENCE_DIR="$(ls -dt ~/cli-jaw-fresh-install-evidence-* | head -1)"
+AUDITOR="$(npm root -g)/cli-jaw/scripts/audit-fresh-install-evidence.mjs"
+node "$AUDITOR" "$EVIDENCE_DIR" --target macos
+node "$AUDITOR" "$EVIDENCE_DIR" --target wsl
+```
+
+릴리스 전 matrix gate에는 macOS와 WSL evidence를 모두 넘깁니다:
+
+```bash
+GATE="$(npm root -g)/cli-jaw/scripts/verify-release-evidence.mjs"
+node "$GATE" --macos /path/to/macos-evidence --wsl /path/to/wsl-evidence
+```
+
+</details>
+
 <details>
 <summary><b>Docker</b></summary>
 
@@ -90,7 +131,7 @@ docker compose up -d       # → http://localhost:3457
 
 ## CLI-JAW가 뭔가요?
 
-CLI-JAW는 여러분이 이미 사용하는 AI 코딩 CLI — Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Gemini, Grok, OpenCode, Copilot — 를 **하나의 비서, 하나의 메모리, 하나의 대시보드**로 통합하는 오픈소스 플랫폼입니다.
+CLI-JAW는 여러분이 이미 사용하는 AI 코딩 CLI — Pi, Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Gemini, Grok, Kiro, OpenCode, Copilot — 를 **하나의 비서, 하나의 메모리, 하나의 대시보드**로 통합하는 오픈소스 플랫폼입니다.
 
 메인 CLI(Boss)가 다른 CLI를 "직원"으로 부릅니다. 앱을 왔다 갔다 할 필요 없이 한 곳에서 지시하면 됩니다.
 
@@ -104,6 +145,30 @@ CLI-JAW는 여러분이 이미 사용하는 AI 코딩 CLI — Antigravity, AI-E,
 
 </div>
 
+### 데스크톱 앱
+
+브라우저 탭보다 네이티브 창이 편하다면 **Electron 데스크톱 셸**을 사용할 수 있습니다. 데스크톱 앱은 manager dashboard를 부팅하고 내부 `jaw dashboard serve` 프로세스를 감독합니다. 패키징된 빌드는 Node.js sidecar 서버를 포함하므로, 전역 터미널 설치보다 앱에 번들된 `jaw` shim을 먼저 사용할 수 있습니다.
+
+최종 사용자는 **GitHub Releases**에서 데스크톱 아티팩트를 받으면 됩니다:
+
+- **macOS**: DMG를 다운로드하고 CLI-JAW를 Applications에 드래그한 뒤 실행합니다. 현재 빌드는 unsigned / un-notarized 상태라 첫 실행 시 Finder에서 우클릭 → **Open**이 필요할 수 있습니다.
+- **Windows**: NSIS installer를 다운로드합니다. 같은 sidecar 서버가 포함되어 있고, 패키징된 `jaw` shim을 PATH에 추가합니다.
+- **Linux**: AppImage를 다운로드하고 실행 권한을 준 뒤 실행합니다.
+
+첫 실행 후 **Install CLI command** 프롬프트를 승인하면 번들 sidecar 기반 터미널 `jaw` 명령이 생성됩니다. 건너뛰었다면 나중에 tray menu의 **Install CLI to Terminal** 항목을 사용하세요. 이 경로는 패키징된 앱과 터미널 shim에 전역 npm 설치를 요구하지 않습니다.
+
+개발자 빌드:
+
+```bash
+# 저장소 루트에서 1회
+npm install && npm --prefix electron install
+
+npm run electron:dev          # hot reload 개발
+npm run electron:dist:mac     # bundled sidecar 포함 macOS arm64 .dmg + .zip 빌드
+```
+
+패키징 산출물은 `electron/dist/`에 생성됩니다. GitHub Actions desktop release workflow는 release publish 또는 manual dispatch에서 macOS arm64 DMG/ZIP, Windows x64 NSIS/ZIP, Linux AppImage 아티팩트를 빌드합니다. `better-sqlite3` 같은 네이티브 모듈은 manager/sidecar 서버 안에 머물고 Electron main process는 직접 import하지 않습니다.
+
 ---
 
 ## 인증
@@ -114,6 +179,7 @@ CLI-JAW는 여러분이 이미 사용하는 AI 코딩 CLI — Antigravity, AI-E,
 # 무료 (신용카드 불필요)
 copilot login        # GitHub Copilot (무료 티어 있음)
 opencode             # OpenCode — 무료 모델 사용 가능
+kiro                 # AWS Kiro (AWS 계정 무료 티어)
 
 # 유료 (이미 결제 중인 월 구독)
 claude auth login    # Anthropic Claude Pro 이상
@@ -139,7 +205,7 @@ grok login --oauth   # xAI Grok / Grok Heavy
  ✅ OpenCode CLI    installed
  ✅ Copilot CLI     installed
  ✅ Database        jaw.db OK
- ✅ Skills          32 active, 194 reference
+ ✅ Skills          29 active, 238 reference
  ✅ MCP (플러그인)   3 servers configured
  ✅ Memory          structured/ exists
  ✅ Server          port 3457 available
@@ -151,7 +217,8 @@ grok login --oauth   # xAI Grok / Grok Heavy
 
 ## 대시보드
 
-대시보드는 `http://localhost:3457`에서 동작하는 로컬 웹앱 형태의 제어판입니다.
+대시보드는 `jaw dashboard`가 `http://localhost:24576`에서 띄우는 로컬 제어판입니다. 개별 에이전트 Web UI는 `jaw serve`가 `http://localhost:3457` 및 인접 managed port에서 제공합니다.
+Web/TUI 실시간 업데이트는 SSE-first `GET /api/events` 채널을 사용하며, WebSocket은 SSE가 한 번도 열리지 않는 오래된 서버용 fallback입니다.
 
 ### 인스턴스 매니저
 
@@ -223,6 +290,8 @@ Boss (Claude) 판단 중...
 ```bash
 # 내부적으로는 이 명령어 하나:
 jaw dispatch --agent "Frontend" --task "dashboard.tsx의 CSS 그리드 레이아웃 수정"
+jaw dispatch --agent "Backend" --task "읽기 전용 검증 실행" --watch
+jaw worker status Backend
 ```
 
 직원은 설정에 등록된 다른 AI CLI입니다. 각각 자체 세션, 자체 모델, 자체 컨텍스트를 가집니다. Boss가 결과를 검토한 뒤 최종 보고합니다.
@@ -247,21 +316,23 @@ jaw dispatch --agent "Frontend" --task "dashboard.tsx의 CSS 그리드 레이아
 
 | CLI | 기본 모델 | 인증 | 비용 |
 |---|---|---|---|
+| **Pi** | `grok-composer-2.5-fast` | Settings profile API key, local proxy, 또는 `PI_CODING_AGENT_BIN` | 격리된 `PI_CODING_AGENT_DIR`로 로컬/API 엔드포인트를 연결하는 first-class `pi --mode rpc` 런타임 |
 | **Claude** | `claude-opus-4-8` | `claude auth login` | Claude Pro 구독 이상 |
 | **Claude E** | `claude-opus-4-8` | underlying `claude auth login` | Claude Pro 구독 이상; 6월 구독 포함 사용량 권장 런타임 |
 | **AI-E** | provider-selected | 선택 provider 인증 | 다중 provider runtime wrapper |
 | **Antigravity** | AGY-selected | `agy` 실행 시 확인 | `--conversation` resume을 쓰는 실험적 AGY print-mode runtime; 모델 변경은 native AGY UI 표면 |
 | **Codex** | `gpt-5.5` | `codex login` | ChatGPT Pro 구독 이상 |
 | **Codex App** | `gpt-5.5` | `codex login` | ChatGPT Pro 구독 이상 |
-| **Cursor** | `composer-2.5-fast` | `cursor-agent login` 또는 `CURSOR_API_KEY` | Cursor 구독; 쿼터는 인증/상태 전용 |
-| **Gemini** | `gemini-3.1-pro-preview` | `gemini` | Gemini Advanced 구독 |
+| **Cursor** | `composer-2.5` | `cursor-agent login` 또는 `CURSOR_API_KEY` | Cursor 구독; 쿼터는 인증/상태 전용 |
+| **Gemini** | `gemini-3-flash-preview` | `gemini` | Gemini Advanced 구독 |
 | **Grok** | `grok-build` | `grok login --oauth` | Grok 구독; 쿼터는 인증/상태 전용 |
-| **OpenCode** | `minimax-m2.7` | `opencode` | 무료 모델 사용 가능 |
-| **Copilot** | `gpt-5-mini` | `copilot login` | 무료 티어 사용 가능 |
+| **Kiro** | registry-selected | `kiro` | AWS Kiro 무료 티어 |
+| **OpenCode** | `opencode-go/kimi-k2.6` | `opencode` | 무료 모델 사용 가능 |
+| **Copilot** | `claude-sonnet-4.6` | `copilot login` | 무료 티어 사용 가능 |
 
 GPT 5.5와 Claude Opus 4.8은 Pro 구독 이상부터 허용됩니다. 6월부터 구독제에 포함된 Claude 사용량을 쓰려면 `claude-e` 런타임을 선택하세요.
 
-쿼터/상태 패널은 registry와 같은 runtime 키셋을 유지합니다. Wrapper runtime(`ai-e`, `claude-e`, `codex-app`)은 underlying provider로 위임하고, AGY/Cursor/Grok/OpenCode처럼 CLI가 quota window를 노출하지 않는 경우 auth/status-only로 표시합니다.
+쿼터/상태 패널은 registry와 같은 runtime 키셋을 유지합니다. Wrapper runtime(`ai-e`, `claude-e`, `codex-app`)은 underlying provider로 위임하고, Pi/AGY/Cursor/Grok/OpenCode처럼 CLI가 quota window를 노출하지 않는 경우 auth/status-only로 표시합니다.
 
 **Fallback 체인**: 한 엔진이 레이트 리밋되면 다음이 이어받습니다. `/fallback [cli1 cli2...]`로 설정.
 
@@ -288,7 +359,7 @@ P (Plan) → A (Audit) → B (Build) → C (Check) → D (Done) → IDLE
 | **C — Check** | 타입 체크 (`tsc --noEmit`), 문서 업데이트, 일관성 검사 |
 | **D — Done** | 모든 변경 사항 요약. IDLE로 복귀 |
 
-상태는 데이터베이스에 저장되므로 재시작해도 이어서 작업할 수 있습니다. 워커는 파일을 수정할 수 없습니다 — 검증만 합니다. `jaw orchestrate`, `/orchestrate`, `/pabcd`로 시작합니다.
+상태는 데이터베이스에 저장되므로 재시작해도 이어서 작업할 수 있습니다. 워커는 파일을 수정할 수 없습니다 — 검증만 합니다. `jaw orchestrate`, `/orchestrate`, `/pabcd`로 시작하고, 진행 중인 worklog는 `/continue`로 명시적으로 재개합니다. Workflow helper slash command는 `/plan`, `/interview`, `/deliberate`, `/planaudit`, `/goal`로 제공됩니다. `/goal run ...`은 bounded automation preview이며, durable goal은 `update`/`done`/`cancel`/`pause`/`resume` 상태를 보존합니다.
 
 ---
 
@@ -312,7 +383,7 @@ jaw memory search "API 인증은 어떻게 설정했지?"
 
 ## 스킬
 
-230개 이상의 스킬이 개발 워크플로, 오피스 문서, 자동화, 미디어를 커버합니다.
+200개 이상의 참조 스킬과 활성 런타임 스킬이 개발 워크플로, 오피스 문서, 자동화, 미디어를 커버합니다.
 
 | 분류 | 스킬 | 할 수 있는 것 |
 |---|---|---|
@@ -339,7 +410,7 @@ jaw skill list              # 사용 가능한 스킬 목록
 | **Chrome DevTools Protocol** | 탐색, 클릭, 입력, 스크린샷, JS 실행, 스크롤, 키 입력 — Chrome 원격 제어 |
 | **Vision-click** | 화면 캡처 → AI가 대상 좌표 추출 → 클릭. `jaw browser vision-click "로그인 버튼"` |
 | **Computer Use** | Codex Computer Use를 통한 데스크톱 앱 자동화. Safari로 localhost에 접속하면 Codex 앱처럼 동작 |
-| **Web-AI 벤더** | `jaw browser web-ai --vendor chatgpt\|gemini\|grok` — 세션 생명주기, 진단, 소스 감사 지원 |
+| **Web-AI 벤더** | `jaw browser web-ai --vendor chatgpt\|gemini\|grok` — 세션 생명주기, 진단, 소스 감사, ChatGPT code-mode zip 회수 지원 |
 | **Diagram 스킬** | SVG 다이어그램과 인터랙티브 시각화 생성, 채팅 안에서 인라인 렌더링 |
 
 Computer Use로 Finder, Safari, 시스템 설정, Xcode 등 모든 macOS 앱을 자연어로 제어할 수 있습니다.
@@ -381,7 +452,7 @@ Web(마이크 버튼), Telegram(음성 메시지), Discord에서 음성 입력
 
 ```bash
 jaw mcp install @anthropic/context7
-# → Claude, Codex, Gemini, OpenCode, Copilot, Antigravity 설정 파일에 동시에 동기화
+# → Claude, Codex, Gemini, Kiro, OpenCode, Copilot, Antigravity 설정 파일에 동시에 동기화
 ```
 
 여러 JSON 파일을 따로 편집할 필요 없습니다. 한 번 설치하면 MCP 지원 엔진 전체에 반영됩니다. Grok CLI는 표준 런타임이지만, Grok 쪽에 호환 MCP 설정이 확인될 때까지 MCP 동기화 대상으로 표기하지 않습니다. Antigravity MCP 동기화는 `agy` runtime registry entry와 별개의 config target입니다.
@@ -399,16 +470,25 @@ jaw mcp sync       # 수동 편집 후 다시 동기화
 jaw dashboard                     # 매니저 대시보드 실행
 jaw serve                         # 서버 시작 (http://localhost:3457)
 jaw chat                          # 터미널 채팅 UI
-jaw doctor                        # 12가지 진단
+jaw chat search "query"           # 채팅 히스토리 검색
+jaw doctor                        # 설치/런타임 진단
 
 # 인스턴스
 jaw clone ~/project               # 인스턴스 복제
 jaw --home ~/project serve --port 3458  # 두 번째 인스턴스 실행
 jaw service install               # 부팅 시 자동 시작
+jaw project set ~/repo            # review/orchestration용 projectDirs 설정
+jaw lock                          # stop-all 흐름에서 현재 인스턴스 보호
 
 # AI & 오케스트레이션
+jaw employee list                         # 설정된 직원 + static 직원 목록
 jaw dispatch --agent "Backend" --task "..."  # 직원 디스패치
+jaw dispatch --agent "Backend" --task "..." --watch  # 안전 progress 스트리밍
+jaw worker status Backend            # 현재/이전 직원 progress 확인
 jaw orchestrate                   # PABCD 워크플로 시작/제어
+jaw goal status                   # 영구 goal lifecycle
+jaw task list                     # 에이전트 네이티브 task checklist
+# 채팅 안에서는: /continue         # worklog/PABCD 명시 재개
 
 # 스킬 & MCP
 jaw skill install <name>          # 스킬 활성화
@@ -425,6 +505,14 @@ jaw browser start                 # Chrome 자동화 시작
 jaw browser fetch "https://example.com" --json --trace  # URL 적응형 읽기
 jaw browser snapshot              # 페이지 상태 캡처
 jaw browser vision-click "로그인"  # AI 기반 클릭
+jaw browser web-ai status         # ChatGPT/Gemini/Grok web-AI 세션 도구
+jaw browser web-ai code --vendor chatgpt --model thinking --effort heavy --prompt "MVP 만들기" --output-zip ./result.zip
+
+# 대시보드 커넥터
+jaw dashboard memory search "query"  # read-only cross-instance memory search
+jaw dashboard chat search "query"    # cross-instance chat search
+jaw connector board add --title "문서 수정"
+jaw reminders add "내일 확인"
 
 # 유지보수
 jaw reset                         # 전체 초기화
@@ -449,9 +537,11 @@ jaw --home ~/my-project serve --port 3458
 
 ```bash
 npm run build          # tsc → dist/
+npm run build:frontend # vite → public/dist/
 npm run dev            # tsx server.ts (핫 리로드)
 npm test               # Node.js 네이티브 테스트 러너
-npm run gate:all       # 릴리스/문서 정합성 게이트
+npm run gate:all       # named release/docs parity gates
+bash structure/check-doc-drift.sh
 ```
 
 아키텍처 상세: [ARCHITECTURE.md](docs/ARCHITECTURE.md) · 테스트 커버리지: [TESTS.md](TESTS.md) · 내부 구조 문서: [structure/](structure/)
@@ -460,9 +550,9 @@ npm run gate:all       # 릴리스/문서 정합성 게이트
 
 ## 비교
 
-| | CLI-JAW 2.0 | Hermes Agent | Claude Code |
+| | CLI-JAW 2.x | Hermes Agent | Claude Code |
 |---|---|---|---|
-| **모델 접근** | Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Gemini, Grok, OpenCode, Copilot — 벤더/네이티브 인증으로 연결 | API 키 (OpenRouter 200+, Nous Portal) | Anthropic 전용 |
+| **모델 접근** | Pi, Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Gemini, Grok, Kiro, OpenCode, Copilot — 벤더/네이티브 인증으로 연결 | API 키 (OpenRouter 200+, Nous Portal) | Anthropic 전용 |
 | **비용 모델** | 이미 결제 중인 월 구독 그대로 | 토큰당 API 과금 | Anthropic 구독 |
 | **메인 UI** | 매니저 대시보드 + 웹앱 + Mac앱 + 터미널 UI | 터미널 전용 | CLI + IDE 플러그인 |
 | **대시보드** | 멀티 인스턴스 매니저, 칸반, 노트 워크스페이스 | 없음 | 없음 |
@@ -471,7 +561,7 @@ npm run gate:all       # 릴리스/문서 정합성 게이트
 | **멀티 에이전트** | 직원 시스템 (다른 CLI 디스패치) + PABCD | 서브에이전트 스폰 | Task 도구 |
 | **브라우저 자동화** | Chrome DevTools + vision-click + Computer Use | 제한적 | MCP 경유 |
 | **실행 환경** | 로컬 + Docker | 로컬/Docker/SSH/Daytona/Modal | 로컬 |
-| **스킬** | 230+ 번들 | 자가 생성 + agentskills.io | 유저 설정 |
+| **스킬** | 200+ 참조 스킬 + 활성 런타임 스킬 | 자가 생성 + agentskills.io | 유저 설정 |
 | **다국어** | 영어, 한국어, 중국어, 일본어 | 영어 | 영어 |
 
 ---
@@ -481,12 +571,13 @@ npm run gate:all       # 릴리스/문서 정합성 게이트
 | 문제 | 해결 방법 |
 |---|---|
 | `cli-jaw: command not found` | `npm install -g cli-jaw` 재실행. macOS/Linux/WSL에서는 `~/.local/bin` 또는 `npm prefix -g` + `/bin`이 `$PATH`에 있는지 확인. Windows PowerShell에서는 `wsl.exe -d Ubuntu -- bash -lc "jaw dashboard"`처럼 WSL login shell로 실행 |
-| `Error: node version` | Node.js 22+로 업그레이드: `nvm install 22` |
+| `Error: node version` | Node.js 22.4+로 업그레이드: `nvm install 22` |
 | `NODE_MODULE_VERSION` mismatch | `npm run ensure:native` (네이티브 모듈 자동 재빌드) |
 | `EADDRINUSE: port 3457` | 다른 인스턴스 실행 중. `--port 3458` 사용 또는 기존 프로세스 종료 |
 | Telegram / Discord 인증 실패 | `jaw doctor` 실행 후 `jaw serve` 재시작 |
 | 브라우저 명령 실패 | Chrome/Chromium 설치 후 `jaw browser start` 먼저 실행 |
-| 직원 디스패치가 멈춤 | 직원 CLI가 인증됐는지 확인 (`jaw doctor`) |
+| 직원 디스패치가 멈춤 | `jaw employee list`를 실행하고, 직원 CLI가 인증됐는지 확인한 뒤(`jaw doctor`) `jaw dispatch --watch`로 다시 시도 |
+| 직원 디스패치가 non-JSON 또는 HTML을 반환 | 서버가 오래됐거나 route가 누락됐을 수 있습니다. `npm run build`를 실행하거나 manager/dashboard 프로세스를 재시작 |
 | Computer Use 안됨 | macOS 전용. Codex CLI 필요. 시스템 설정에서 자동화 권한 확인 |
 
 ---
@@ -494,8 +585,9 @@ npm run gate:all       # 릴리스/문서 정합성 게이트
 ## 기여하기
 
 1. `master`에서 Fork하고 브랜치를 만듭니다
-2. `npm run build && npm test`
-3. PR을 제출합니다
+2. `npm run build && npm run build:frontend && npm test`
+3. release-sensitive 변경은 `npm run gate:all`과 touched surface focused check도 실행합니다
+4. PR을 제출합니다
 
 버그 리포트, 기능 아이디어: [Issue 열기](https://github.com/lidge-jun/cli-jaw/issues)
 

package/README.md

@@ -2,12 +2,12 @@
 
 # CLI-JAW
 
-### Your personal AI agent. 2 lines to install. 12 AI runtime surfaces in one dashboard.
+### Your personal AI agent. 2 lines to install. 13 AI runtime surfaces in one dashboard.
 
 [![npm](https://img.shields.io/npm/v/cli-jaw)](https://npmjs.com/package/cli-jaw)
-[![Version](https://img.shields.io/badge/v2.0.16-GA-brightgreen)](https://github.com/lidge-jun/cli-jaw/releases)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://typescriptlang.org)
-[![Node](https://img.shields.io/badge/node-%3E%3D22-blue)](https://nodejs.org)
+[![Version](https://img.shields.io/badge/v2.1.3-GA-brightgreen)](https://github.com/lidge-jun/cli-jaw/releases)
+[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue)](https://typescriptlang.org)
+[![Node](https://img.shields.io/badge/node-%3E%3D22.4-blue)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
 [![Docker](https://img.shields.io/badge/Docker-supported-2496ED?logo=docker&logoColor=white)](#-docker)
 
@@ -36,7 +36,7 @@ npm install -g cli-jaw
 jaw dashboard
 ```
 
-That's it. Open **http://localhost:3457** and you have a personal AI agent. Requires [Node.js 22+](https://nodejs.org).
+That's it. Open **http://localhost:24576** for the manager dashboard. Per-instance agent Web UIs still run from **http://localhost:3457** when you start `jaw serve`. Requires [Node.js 22.4+](https://nodejs.org).
 
 > **First time?** The default npm install initializes CLI-JAW and attempts native Claude setup. Other AI CLIs are optional; install them all during npm setup with `CLI_JAW_INSTALL_CLI_TOOLS=1 npm install -g cli-jaw` on macOS/Linux. On Windows, use the WSL install path below.
 
@@ -161,7 +161,7 @@ docker compose up -d       # → http://localhost:3457
 
 ## What is CLI-JAW?
 
-CLI-JAW is an open-source platform that unifies the AI coding CLIs you already use — Claude, Claude E, AI-E, Antigravity, Codex, Codex App, Cursor, Gemini, Grok, Kiro, OpenCode, and Copilot — into **one assistant with one memory and one dashboard**.
+CLI-JAW is an open-source platform that unifies the AI coding CLIs you already use — Pi, Claude, Claude E, AI-E, Antigravity, Codex, Codex App, Cursor, Gemini, Grok, Kiro, OpenCode, and Copilot — into **one assistant with one memory and one dashboard**.
 
 Your main CLI (the “Boss”) calls the others as “employees.” You stop copy-pasting between apps and start giving orders from a single place.
 
@@ -211,7 +211,7 @@ Check everything at once: `jaw doctor`
  ✅ OpenCode CLI    installed
  ✅ Copilot CLI     installed
  ✅ Database        jaw.db OK
- ✅ Skills          32 active, 194 reference
+ ✅ Skills          29 active, 238 reference
  ✅ MCP (plugins)   3 servers configured
  ✅ Memory          structured/ exists
  ✅ Server          port 3457 available
@@ -223,12 +223,21 @@ Check everything at once: `jaw doctor`
 
 ## The Dashboard
 
-The dashboard is your command center. It's a local web app at `http://localhost:3457`.
+The dashboard is your command center. `jaw dashboard` starts the manager at `http://localhost:24576`; individual agent Web UIs are served by `jaw serve` from `http://localhost:3457` and nearby managed ports.
+Live Web/TUI updates use the SSE-first `GET /api/events` channel, with legacy WebSocket fallback only for older servers where SSE never opens.
 
 ### Instance Manager
 
 See every running AI instance — start, stop, restart with one click. Preview live Web UIs directly in the dashboard.
 
+Manager preview embeds the selected instance's regular Web UI. On long-running
+homes with large chat databases, a fresh Chrome tab can briefly allocate more
+memory while the preview loads its recent message window, renders markdown and
+structured cards, and lets Chrome's garbage collector settle. If memory drops
+back after a few minutes, treat it as a cold-load peak rather than a manager
+server leak; the `jaw dashboard` manager process should stay much smaller than
+the embedded browser renderer and the individual `jaw serve` worker processes.
+
 <div align="center">
 
 ![Dashboard Navigator](docs/screenshots/dashboard-navigator.png)
@@ -277,17 +286,27 @@ Monitor each AI engine's health and usage at a glance.
 
 ### Desktop App
 
-Prefer a native window to a browser tab? CLI-JAW ships an **Electron desktop shell** — a thin native wrapper that boots the manager dashboard and supervises the underlying `jaw dashboard serve` process for you. Nothing to keep open in a terminal, no tab to lose.
+Prefer a native window to a browser tab? CLI-JAW ships an **Electron desktop shell** that boots the manager dashboard and supervises the underlying `jaw dashboard serve` process for you. Packaged desktop builds include a Node.js sidecar server, so the app can prefer its bundled `jaw` shim before falling back to a global terminal install.
+
+For end users, download the desktop artifact from **GitHub Releases**:
+
+- **macOS**: download the DMG, drag CLI-JAW into Applications, then launch it. Current builds are unsigned / un-notarized, so first launch may require right-click → **Open** in Finder.
+- **Windows**: download the NSIS installer. It includes the same sidecar server and adds the packaged `jaw` shim to PATH.
+- **Linux**: download the AppImage, make it executable, and run it.
+
+After first launch, accept the **Install CLI command** prompt to create the terminal `jaw` command from the bundled sidecar. If you skip the prompt, use the tray menu item **Install CLI to Terminal** later. This path does not require a global npm install for the packaged app or terminal shim.
+
+Developer build:
 
 ```bash
 # one-time, from the repo root
 npm install && npm --prefix electron install
 
 npm run electron:dev          # develop with hot reload
-npm run electron:dist:mac     # build a universal .dmg + .zip  (also :win / :linux)
+npm run electron:dist:mac     # build macOS arm64 .dmg + .zip with bundled sidecar
 ```
 
-The packaged app lands in `electron/dist/` (`cli-jaw.app`, `cli-jaw-<version>-universal.dmg`). Native modules (`better-sqlite3`, `playwright-core`, `sharp`, `canvas`) live only in the manager server — the Electron main process never loads them. Builds are currently **unsigned / un-notarized**, so on first launch macOS Gatekeeper needs a right-click → **Open**.
+The packaged app lands in `electron/dist/`. The GitHub Actions desktop release workflow builds macOS arm64 DMG/ZIP, Windows x64 NSIS/ZIP, and Linux AppImage artifacts on release publish or manual dispatch. Native modules such as `better-sqlite3` stay in the manager/sidecar server — the Electron main process never imports them.
 
 ---
 
@@ -310,10 +329,11 @@ Boss (Claude) thinks...
 # Under the hood, it's one command:
 jaw dispatch --agent "Frontend" --task "Fix the CSS grid layout in dashboard.tsx"
 jaw dispatch --agent "Backend" --task "Run read-only verification" --watch
+jaw dispatch --virtual "security" --task "Review this branch for auth and secret leaks" --watch
 jaw worker status Backend
 ```
 
-Employees are other AI CLIs configured in your settings. Each has its own session, its own model, its own context. The Boss reviews their output before presenting it to you.
+Employees are other AI CLIs configured in your settings. Each has its own session, its own model, its own context. For one-off specialist checks, the Boss can also dispatch an ephemeral virtual employee with `--virtual`; it uses the same dispatch machinery but is not saved to the employee database. The Boss reviews their output before presenting it to you.
 
 ### Employees vs. Sub-agents
 
@@ -335,6 +355,7 @@ No per-token API billing. Route through subscriptions you already pay for.
 
 | CLI | Default Model | Auth | Cost |
 |---|---|---|---|
+| **Pi** | `grok-composer-2.5-fast` | Settings profile API key, local proxy, or `PI_CODING_AGENT_BIN` | First-class `pi --mode rpc` runtime for local/API endpoints through an isolated `PI_CODING_AGENT_DIR` |
 | **Claude** | `claude-opus-4-8` | `claude auth login` | Claude Pro subscription or higher |
 | **Claude E** | `claude-opus-4-8` | underlying `claude auth login` | Claude Pro subscription or higher; preferred for June subscription allowance |
 | **AI-E** | provider-selected | selected provider auth | Multi-provider runtime wrapper |
@@ -349,7 +370,7 @@ No per-token API billing. Route through subscriptions you already pay for.
 
 GPT 5.5 and Claude Opus 4.8 are enabled from Pro-tier subscriptions and higher. Starting in June, select `claude-e` when you want CLI-JAW to use the Claude allowance bundled with the subscription plan.
 
-The quota/status panel keeps the same runtime keyset as the registry. Wrapper runtimes (`ai-e`, `claude-e`, `codex-app`) delegate to their underlying provider, while AGY/Cursor/Grok/OpenCode are shown as auth/status-only when their CLIs do not expose quota windows.
+The quota/status panel keeps the same runtime keyset as the registry. Wrapper runtimes (`ai-e`, `claude-e`, `codex-app`) delegate to their underlying provider, while Pi/AGY/Cursor/Grok/OpenCode are shown as auth/status-only when their CLIs do not expose quota windows.
 
 **Fallback chain**: if one engine is rate-limited, the next picks up. Configure with `/fallback [cli1 cli2...]`.
 
@@ -400,7 +421,7 @@ jaw memory search "how did we set up the API auth?"
 
 ## Skills
 
-230+ skills covering dev workflows, office documents, automation, and media.
+200+ reference skills plus active runtime skills cover dev workflows, office documents, automation, and media.
 
 | Category | Skills | What they cover |
 |---|---|---|
@@ -427,7 +448,7 @@ jaw skill list              # see what's available
 | **Chrome DevTools Protocol** | Navigate, click, type, screenshot, evaluate JS, scroll, press keys — remote control for Chrome |
 | **Vision-click** | Screenshot the screen → AI extracts target coordinates → clicks. `jaw browser vision-click "Login button"` |
 | **Computer Use** | Desktop app automation via Codex Computer Use. Use Safari for localhost and it feels like the Codex app |
-| **Web-AI vendors** | `jaw browser web-ai --vendor chatgpt\|gemini\|grok` with session lifecycle, diagnostics, and source-audit/answer-artifact support where implemented |
+| **Web-AI vendors** | `jaw browser web-ai --vendor chatgpt\|gemini\|grok` with session lifecycle, diagnostics, source-audit/answer-artifact support, and ChatGPT code-mode zip recovery |
 | **Diagram Skill** | Generate SVG diagrams and interactive visualizations, rendered inline in chat |
 
 Computer Use lets you control any macOS app — Finder, Safari, System Settings, Xcode — through natural language. Point it at your localhost dev server in Safari and you get a full visual testing loop.
@@ -487,18 +508,25 @@ jaw mcp sync       # re-sync after manual edits
 jaw dashboard                     # launch manager dashboard
 jaw serve                         # start server (http://localhost:3457)
 jaw chat                          # terminal chat UI
-jaw doctor                        # 12-point diagnostics
+jaw chat search "query"           # search chat history
+jaw doctor                        # installation and runtime diagnostics
 
 # Instances
 jaw clone ~/project               # clone instance to new directory
 jaw --home ~/project serve --port 3458  # run second instance
 jaw service install               # auto-start on boot
+jaw project set ~/repo            # set projectDirs for review/orchestration
+jaw lock                          # protect this instance from stop-all flows
 
 # AI & Orchestration
+jaw employee list                         # list configured + static employees
 jaw dispatch --agent "Backend" --task "..."  # dispatch employee
 jaw dispatch --agent "Backend" --task "..." --watch  # dispatch and stream safe progress
+jaw dispatch --virtual "testing" --task "..." --watch  # one-off virtual employee
 jaw worker status Backend            # inspect current/previous employee progress
 jaw orchestrate                   # enter/control PABCD workflow
+jaw goal status                   # persistent goal lifecycle
+jaw task list                     # agent-native task checklist
 # in chat: /continue               # explicit worklog/PABCD resume
 
 # Skills & MCP
@@ -516,6 +544,14 @@ jaw browser start                 # launch Chrome automation
 jaw browser fetch "https://example.com" --json --trace  # adaptive URL reader
 jaw browser snapshot              # capture page state
 jaw browser vision-click "Login"  # AI-powered click
+jaw browser web-ai status         # ChatGPT/Gemini/Grok web-AI session tooling
+jaw browser web-ai code --vendor chatgpt --model thinking --effort heavy --prompt "Build an MVP" --output-zip ./result.zip
+
+# Dashboard connectors
+jaw dashboard memory search "query"  # read-only cross-instance memory search
+jaw dashboard chat search "query"    # cross-instance chat search
+jaw connector board add --title "Fix docs"
+jaw reminders add "Follow up tomorrow"
 
 # Maintenance
 jaw reset                         # full reset
@@ -540,9 +576,11 @@ Each instance is fully independent — different working directory, different me
 
 ```bash
 npm run build          # tsc → dist/
+npm run build:frontend # vite → public/dist/
 npm run dev            # tsx server.ts (hot-reload)
 npm test               # native Node.js test runner
 npm run gate:all       # named release/docs parity gates
+bash structure/check-doc-drift.sh
 ```
 
 Architecture details: [ARCHITECTURE.md](docs/ARCHITECTURE.md) · Internal structure docs: [structure/](structure/)
@@ -551,18 +589,18 @@ Architecture details: [ARCHITECTURE.md](docs/ARCHITECTURE.md) · Internal struct
 
 ## How It Compares
 
-| | CLI-JAW 2.0 | Hermes Agent | Claude Code |
+| | CLI-JAW 2.x | Hermes Agent | Claude Code |
 |---|---|---|---|
-| **Model access** | Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Gemini, Grok, Kiro, OpenCode, and Copilot through vendor/native auth where supported | API keys (OpenRouter 200+, Nous Portal) | Anthropic only |
+| **Model access** | Pi, Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Gemini, Grok, Kiro, OpenCode, and Copilot through vendor/native auth where supported | API keys (OpenRouter 200+, Nous Portal) | Anthropic only |
 | **Cost model** | Monthly subscriptions you already pay for | Per-token API billing | Anthropic subscription |
-| **Primary UI** | Manager dashboard + Web app + Mac app + terminal UI | Terminal only | CLI + IDE plugins |
+| **Primary UI** | Manager dashboard + Web app + Electron desktop + terminal UI | Terminal only | CLI + IDE plugins |
 | **Dashboard** | Multi-instance manager, Kanban, Notes workspace | None | None |
 | **Messaging** | Telegram (voice) + Discord | Telegram/Discord/Slack/WhatsApp/Signal | None |
 | **Memory** | 3-layer (History/Flush/Soul) + full-text search | Self-improving loop + Honcho | File-based auto-memory |
 | **Multi-agent** | Employee system (dispatch other CLIs) + PABCD | Subagent spawn | Task tool |
 | **Browser automation** | Chrome DevTools + vision-click + Computer Use | Limited | Via MCP |
 | **Execution** | Local + Docker | Local/Docker/SSH/Daytona/Modal | Local |
-| **Skills** | 230+ bundled | Self-creating + agentskills.io | User-configured |
+| **Skills** | 200+ reference skills + active runtime skills | Self-creating + agentskills.io | User-configured |
 | **Languages** | English, Korean, Chinese, Japanese | English | English |
 
 ---
@@ -572,12 +610,15 @@ Architecture details: [ARCHITECTURE.md](docs/ARCHITECTURE.md) · Internal struct
 | Problem | Solution |
 |---|---|
 | `cli-jaw: command not found` | `npm install -g cli-jaw` again. macOS/Linux/WSL: check `~/.local/bin` or `npm prefix -g` + `/bin` is in `$PATH`. From Windows PowerShell, invoke WSL through a login shell: `wsl.exe -d Ubuntu -- bash -lc "jaw dashboard"`. |
-| `Error: node version` | Upgrade to Node.js 22+: `nvm install 22` |
+| `cli-jaw: permission denied` | The global shim can see CLI-JAW, but its `dist/bin/cli-jaw.js` target is not executable. Re-run `npm install -g cli-jaw` or, in a checkout, run `npm run build && npm run check:cli-bin-links`. |
+| Fresh install verifier fails | `scripts/verify-fresh-install.sh` checks both public aliases: `jaw` and `cli-jaw`. Fix the reported PATH or executable-bit issue, then rerun `bash "$(npm root -g)/cli-jaw/scripts/verify-fresh-install.sh"`. |
+| `Error: node version` | Upgrade to Node.js 22.4+: `nvm install 22` |
 | `NODE_MODULE_VERSION` mismatch | `npm run ensure:native` (auto-rebuilds native modules) |
 | `EADDRINUSE: port 3457` | Another instance running. Use `--port 3458` or stop it first |
 | Telegram / Discord auth fails | Run `jaw doctor`, check tokens, restart `jaw serve` |
 | Browser commands fail | Install Chrome/Chromium. Run `jaw browser start` first |
-| Employee dispatch hangs | Ensure the employee CLI is authenticated (`jaw doctor`) |
+| Employee dispatch hangs | Run `jaw employee list`, ensure the employee CLI is authenticated (`jaw doctor`), then retry with `jaw dispatch --watch` |
+| Employee dispatch returns non-JSON or HTML | The server may be stale or missing the route. Run `npm run build` or restart the manager/dashboard process. |
 | Computer Use not working | macOS only. Codex CLI required. Check Automation permission in System Settings |
 
 ---
@@ -585,8 +626,9 @@ Architecture details: [ARCHITECTURE.md](docs/ARCHITECTURE.md) · Internal struct
 ## Contributing
 
 1. Fork and branch from `master`
-2. `npm run build && npm test`
-3. Submit a PR
+2. `npm run build && npm run build:frontend && npm test`
+3. For release-sensitive changes, also run `npm run gate:all` and any focused checks for the touched surface.
+4. Submit a PR
 
 Bug reports and feature ideas: [Open an issue](https://github.com/lidge-jun/cli-jaw/issues)