cli-jaw 0.1.6 → 0.1.8

package/README.ko.md

@@ -6,7 +6,7 @@
 
 *Claude, Codex, Gemini... 이제 번갈아 쓰지 마세요.*
 
-[![Tests](https://img.shields.io/badge/tests-252%20pass-brightgreen)](#-테스트)
+[![Tests](https://img.shields.io/badge/tests-360%20pass-brightgreen)](#-테스트)
 [![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)
 [![License](https://img.shields.io/badge/license-ISC-yellow)](LICENSE)
@@ -20,6 +20,62 @@
 
 ---
 
+## 🚀 설치 & 실행 (30초)
+
+```bash
+npm install -g cli-jaw
+jaw serve
+```
+
+**끝.** **http://localhost:3457** 열고 바로 채팅하세요. 🦈
+
+> **Node.js ≥ 22** ([다운로드](https://nodejs.org)) + 아래에서 **AI CLI 최소 1개** 인증 필요.
+
+---
+
+## 🔑 AI 엔진 인증
+
+**하나만** 있으면 돼요 — 가진 거 골라서:
+
+```bash
+# ── 무료 ──
+gh auth login                # GitHub Copilot (무료 플랜) — 이후: gh copilot --help
+opencode                     # OpenCode — 첫 실행 시 자동 인증 (무료 모델 있음)
+
+# ── 유료 ──
+claude auth                  # Anthropic Claude
+codex login                  # OpenAI Codex
+gemini                       # Google Gemini — 첫 실행 시 인증
+```
+
+준비 상태 확인: `jaw doctor`
+
+<details>
+<summary>📋 <code>jaw doctor</code> 출력 예시</summary>
+
+```
+🦈 CLI-JAW Doctor — 12 checks
+
+ ✅ Node.js        v22.15.0
+ ✅ npm             v10.9.4
+ ✅ Claude CLI      installed
+ ✅ Codex CLI       installed
+ ⚠️ Gemini CLI      not found (optional)
+ ✅ OpenCode CLI    installed
+ ✅ Copilot CLI     installed
+ ✅ Database        jaw.db OK
+ ✅ Skills          17 active, 90 reference
+ ✅ MCP             3 servers configured
+ ✅ Memory          MEMORY.md exists
+ ✅ Server          port 3457 available
+```
+
+</details>
+
+> 💡 **5개 다 깔 필요 없어요.** 하나만 있으면 됩니다. 어떤 엔진이 설치돼 있는지 자동 감지하고, 없으면 다음 엔진으로 자연스럽게 넘어갑니다.
+
+---
+
 ## CLI-JAW란 무엇인가요?
 
 CLI-JAW는 내 컴퓨터에 상주하며 이미 익숙한 인터페이스인 **웹, 터미널, 텔레그램**에서 작동하는 **개인용 AI 비서**입니다. 궁금한 것을 묻고, 작업을 위임하고, 워크플로우를 자동화하세요.
@@ -28,7 +84,7 @@ CLI-JAW는 내 컴퓨터에 상주하며 이미 익숙한 인터페이스인 **
 > 💬 *"이 모듈 리팩토링하고 테스트도 짜줘"* → 서브에이전트가 알아서, 커피 한 잔 하고 오면 돼요  
 > 💬 *"저 PDF 다운받아서 핵심만 노션에 정리해"* → 브라우저 + 노션 스킬 조합으로 뚝딱
 
-단일 모델만을 사용하는 기존 비서들과 달리, CLI-JAW는 5개의 AI 엔진(Claude, Codex, Gemini, OpenCode, Copilot)을 공식 CLI를 통해 오케스트레이션하여 모든 제공업체의 장점을 통합된 경험으로 제공합니다. 하나의 엔진 사용량이 초과되면 자동으로 다음 엔진으로 전환됩니다. 107개의 내장 스킬이 브라우저 자동화부터 문서 생성까지 모든 것을 처리합니다.
+단일 모델만을 사용하는 기존 비서들과 달리, CLI-JAW는 5개의 AI 엔진(Claude, Codex, Gemini, OpenCode, Copilot)을 공식 CLI를 통해 오케스트레이션하여 모든 제공업체의 장점을 통합된 경험으로 제공합니다. 하나의 엔진 사용량이 초과되면 자동으로 다음 엔진으로 전환됩니다. 105개의 내장 스킬이 브라우저 자동화부터 문서 생성까지 모든 것을 처리합니다.
 
 |                                         | 왜 CLI-JAW인가요?                                                                                     |
 | --------------------------------------- | ----------------------------------------------------------------------------------------------------- |
@@ -36,7 +92,7 @@ CLI-JAW는 내 컴퓨터에 상주하며 이미 익숙한 인터페이스인 **
 | 🤖 **검증된 에이전트 도구**              | 실전에서 검증된 5개의 코딩 에이전트(Claude, Codex, Gemini, OpenCode, Copilot)를 한 곳에서 사용하세요. |
 | ⚡ **멀티 에이전트 자동 전환(Fallback)** | 엔진 하나가 멈춰도 걱정 없습니다. 다음 엔진이 즉시 이어받아 중단 없는 작업이 가능합니다.              |
 | 🎭 **오케스트레이션 기반 성능 극대화**   | 복잡한 작업은 전문화된 서브 에이전트에게 분산시켜 처리량을 극대화합니다.                              |
-| 📦 **107개의 내장 스킬**                 | 브라우저 자동화, 문서 생성, 텔레그램 연동, 영구 메모리 등 설치 즉시 사용 가능한 기능들을 제공합니다.  |
+| 📦 **105개의 내장 스킬**                 | 브라우저 자동화, 문서 생성, 텔레그램 연동, 영구 메모리 등 설치 즉시 사용 가능한 기능들을 제공합니다.  |
 | 🖥️ **크로스 플랫폼**                     | macOS, Linux, Windows (WSL) — 브라우저 실행, CLI 감지, 설치 모두 네이티브 지원.               |
 
 ![CLI-JAW 터미널](docs/screenshots/terminal-cli.png)
@@ -63,7 +119,7 @@ graph LR
 - 🤖 **5개의 AI 엔진, 1명의 비서** — Claude · Codex · Gemini · OpenCode · Copilot. `/cli` 명령어로 전환하세요.
 - ⚡ **자동 전환(Fallback)** — 엔진 하나가 다운되면 다음 엔진이 매끄럽게 이어받습니다.
 - 🎭 **멀티 에이전트 오케스트레이션** — 복잡한 작업은 전문화된 서브 에이전트들에게 자동으로 분산됩니다.
-- 📦 **107개의 스킬** — 브라우저 제어, 파일 편집, 이미지 생성, 웹 검색 외 [다양한 기능](#-스킬-시스템).
+- 📦 **105개의 스킬** — 브라우저 제어, 파일 편집, 이미지 생성, 웹 검색 외 [다양한 기능](#-스킬-시스템).
 - 🧠 **영구 메모리** — 세션을 넘나들며 과거의 대화와 사용자 선호도를 기억합니다.
 - 📱 **텔레그램 봇** — 휴대폰으로 비서와 채팅하고, 음성/사진/파일을 전송하세요.
 - 🌐 **브라우저 자동화** — 비서가 알아서 웹을 탐색하고, 클릭하고, 타이핑하고, 스크린샷을 찍을 수 있습니다.
@@ -73,79 +129,20 @@ graph LR
 
 ---
 
-## 빠른 시작
-
-### 사전 요구사항
-
-| 필수 항목           | 용도                                   |
-| ------------------- | -------------------------------------- |
-| **Node.js ≥ 22**    | 런타임. [다운로드](https://nodejs.org) |
-| **AI CLI 최소 1개** | 비서를 움직이는 두뇌                   |
-
-> 🆓 **무료 옵션:** [Copilot CLI](https://docs.github.com/en/copilot)는 GitHub 무료 플랜에서도, [OpenCode](https://opencode.ai)는 무료 모델이 있어요 — 카드 등록 없이 바로 시작 가능.
-
-### 설치
-
-```bash
-# 1. 전역 설치
-npm install -g cli-jaw
-
-# 2. 초기 설정 (설정 파일 생성, 스킬 설치)
-jaw init
-
-# 3. 상태 확인 — 뭐가 준비됐는지 점검
-jaw doctor
-```
-
-<details>
-<summary>📋 <code>jaw doctor</code> 출력 예시</summary>
-
-```
-🦈 CLI-JAW Doctor — 12 checks
-
- ✅ Node.js        v22.15.0
- ✅ npm             v10.9.4
- ✅ Claude CLI      installed
- ✅ Codex CLI       installed
- ⚠️ Gemini CLI      not found (optional)
- ✅ OpenCode CLI    installed
- ✅ Copilot CLI     installed
- ✅ Database        jaw.db OK
- ✅ Skills          17 active, 90 reference
- ✅ MCP             3 servers configured
- ✅ Memory          MEMORY.md exists
- ✅ Server          port 3457 available
-```
-
-</details>
-
-### AI 엔진 인증
-
-```bash
-# 가진 것만 골라서 — 하나면 충분해요
-claude auth          # Anthropic  (유료)
-codex login          # OpenAI     (유료)
-gemini               # Google     (첫 실행 시 자동 인증)
-# OpenCode            # 첫 실행 시 자동 인증
-# Copilot             # GitHub 로그인 사용 (무료 플랜 가능)
-```
-
-### 실행
+### 기타 실행 방법
 
 ```bash
-jaw serve        # Web UI → http://localhost:3457
-jaw launchd      # 부팅 시 자동 실행 (macOS)
-# — 또는 —
 jaw chat         # 터미널 TUI (브라우저 필요 없음)
+jaw launchd      # 부팅 시 자동 실행 (macOS)
 ```
 
-> 💡 **5개 다 깔 필요 없어요.** 하나만 있으면 됩니다. 어떤 엔진이 설치돼 있는지 자동 감지하고, 없으면 다음 엔진으로 자연스럽게 넘어갑니다.
+> ⚠️ **설치 시 참고:** `npm install -g cli-jaw`는 postinstall 스크립트를 실행하여 스킬 디렉토리, 커스텀 인스트럭션, MCP 설정을 구성합니다. 기존 설정은 덮어쓰지 않고 병합됩니다.
 
 ---
 
 ## 📦 스킬 시스템
 
-**107개 스킬** 내장 — 브라우저, GitHub, 노션, 텔레그램, 메모리, PDF, 이미지 생성 등 [다양하게](#).
+**105개 스킬** 내장 — 브라우저, GitHub, 노션, 텔레그램, 메모리, PDF, 이미지 생성 등 [다양하게](#).
 
 <details>
 <summary>전체 스킬 목록 보기</summary>
@@ -153,7 +150,7 @@ jaw chat         # 터미널 TUI (브라우저 필요 없음)
 | 티어               | 수량  | 작동 방식                                        |
 | ------------------ | :---: | ------------------------------------------------ |
 | **Active 스킬**    |  17   | 매번 AI한테 자동으로 주입돼요. 항상 켜져 있어요. |
-| **Reference 스킬** |  88+  | 관련 작업을 시키면 그때 AI가 읽어서 써요.        |
+| **Reference 스킬** |  89   | 관련 작업을 시키면 그때 AI가 읽어서 써요.        |
 
 #### Active 스킬 (항상 켜짐)
 
@@ -173,7 +170,7 @@ jaw chat         # 터미널 TUI (브라우저 필요 없음)
 
 #### Reference 스킬 (필요할 때만)
 
-88개+ 스킬이 더 있어요 — spotify, 날씨, 딥리서치, TTS, 비디오 다운로드, Apple 미리알림, 1Password, Terraform, PostgreSQL, Jupyter 등.
+89개 스킬이 더 있어요 — spotify, 날씨, 딥리서치, TTS, 비디오 다운로드, Apple 미리알림, 1Password, Terraform, PostgreSQL, Jupyter 등.
 
 ```bash
 jaw skill install <name>    # reference → active로 영구 활성화
@@ -358,7 +355,7 @@ src/
 ## 🧪 테스트
 
 <details>
-<summary>252 pass · 1 skipped · 외부 의존성 0</summary>
+<summary>360 pass · 1 skipped · 외부 의존성 0</summary>
 
 ```bash
 npm test
@@ -401,7 +398,7 @@ npm test
 2. `npm run build && npm test`로 빌드 & 테스트가 통과하는지 확인
 3. PR을 보내주세요 — 빠르게 리뷰할게요
 
-> 📋 버그를 찾았거나 아이디어가 있으신가요? [이슈 열기](https://github.com/bitkyc08-arch/cli-jaw/issues)
+> 📋 버그를 찾았거나 아이디어가 있으신가요? [이슈 열기](https://github.com/lidge-jun/cli-jaw/issues)
 
 ---
 

package/README.md

@@ -6,7 +6,7 @@
 
 *One assistant. Five brains. Always on.*
 
-[![Tests](https://img.shields.io/badge/tests-306%20pass-brightgreen)](#-tests)
+[![Tests](https://img.shields.io/badge/tests-360%20pass-brightgreen)](#-tests)
 [![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)
 [![License](https://img.shields.io/badge/license-ISC-yellow)](LICENSE)
@@ -20,7 +20,62 @@
 
 ---
 
-> ⚠️ **Installation Notice:** `npm install -g cli-jaw` runs a postinstall script that may modify your globally installed CLI skill directories (`~/.agents/skills/`, `~/.claude/skills/`), custom instructions (`~/AGENTS.md` → `~/CLAUDE.md` symlink), and MCP config (`~/.cli-jaw/mcp.json` → syncs to Claude/Codex/Gemini/OpenCode/Copilot). Existing configs are preserved and merged, not overwritten.
+## 🚀 Install & Run (30 seconds)
+
+```bash
+npm install -g cli-jaw
+jaw serve
+```
+
+**That's it.** Open **http://localhost:3457** and start chatting. 🦈
+
+> Requires **Node.js ≥ 22** ([download](https://nodejs.org)) and **at least 1 AI CLI** authenticated below.
+
+---
+
+## 🔑 Authenticate Your AI Engines
+
+You only need **one** — pick whichever you have:
+
+```bash
+# ── Free options ──
+gh auth login                # GitHub Copilot (free tier) — then run: gh copilot --help
+opencode                     # OpenCode — auto-auth on first run (free models available)
+
+# ── Paid options ──
+claude auth                  # Anthropic Claude
+codex login                  # OpenAI Codex
+gemini                       # Google Gemini — first run triggers auth
+```
+
+Check what's ready: `jaw doctor`
+
+<details>
+<summary>📋 Example <code>jaw doctor</code> output</summary>
+
+```
+🦈 CLI-JAW Doctor — 12 checks
+
+ ✅ Node.js        v22.15.0
+ ✅ npm             v10.9.4
+ ✅ Claude CLI      installed
+ ✅ Codex CLI       installed
+ ⚠️ Gemini CLI      not found (optional)
+ ✅ OpenCode CLI    installed
+ ✅ Copilot CLI     installed
+ ✅ Database        jaw.db OK
+ ✅ Skills          17 active, 90 reference
+ ✅ MCP             3 servers configured
+ ✅ Memory          MEMORY.md exists
+ ✅ Server          port 3457 available
+```
+
+</details>
+
+> 💡 **You don't need all 5.** Even one CLI is enough. Your assistant auto-detects which engines are available and falls back gracefully.
+
+---
+
 
 ## What is CLI-JAW?
 
@@ -30,15 +85,15 @@ CLI-JAW is a **personal AI assistant** that lives on your machine and works from
 > 💬 *"Refactor this module and write tests"* → sub-agents handle it while you grab coffee  
 > 💬 *"Download that PDF and put the key points in Notion"* → browser + Notion skill, done
 
-Unlike single-model assistants, CLI-JAW orchestrates **5 AI engines** (Claude, Codex, Gemini, OpenCode, Copilot) through their official CLIs — giving you the best of every provider in one unified experience. If one engine is busy, it automatically falls back to the next. 122 built-in skills handle everything from browser automation to document generation.
+Unlike single-model assistants, CLI-JAW orchestrates **5 AI engines** (Claude, Codex, Gemini, OpenCode, Copilot) through their official CLIs — giving you the best of every provider in one unified experience. If one engine is busy, it automatically falls back to the next. 105 built-in skills handle everything from browser automation to document generation.
 
-|                                | Why CLI-JAW?                                                                             |
-| ------------------------------ | ---------------------------------------------------------------------------------------- |
-| 🛡️ **TOS-Safe**                 | Uses official CLIs only — no API key scraping, no reverse engineering, no ban risk.      |
-| 🤖 **Verified Agent Tools**     | 5 battle-tested coding agents (Claude, Codex, Gemini, OpenCode, Copilot) under one roof. |
-| ⚡ **Multi-Agent Fallback**     | One engine down? The next picks up automatically. Zero downtime.                         |
-| 🎭 **Orchestrated Performance** | Complex tasks split across specialized sub-agents for maximum throughput.                |
-| 📦 **122 Built-in Skills**      | Browser automation, document generation, Telegram, memory — ready out of the box.        |
+|                                | Why CLI-JAW?                                                                                |
+| ------------------------------ | ------------------------------------------------------------------------------------------- |
+| 🛡️ **TOS-Safe**                 | Uses official CLIs only — no API key scraping, no reverse engineering, no ban risk.         |
+| 🤖 **Verified Agent Tools**     | 5 battle-tested coding agents (Claude, Codex, Gemini, OpenCode, Copilot) under one roof.    |
+| ⚡ **Multi-Agent Fallback**     | One engine down? The next picks up automatically. Zero downtime.                            |
+| 🎭 **Orchestrated Performance** | Complex tasks split across specialized sub-agents for maximum throughput.                   |
+| 📦 **105 Built-in Skills**      | Browser automation, document generation, Telegram, memory — ready out of the box.           |
 | 🖥️ **Cross-Platform**           | macOS, Linux, Windows (WSL) — browser launch, CLI detection, and install all work natively. |
 
 ![CLI-JAW Terminal](docs/screenshots/terminal-cli.png)
@@ -65,7 +120,7 @@ graph LR
 - 🤖 **5 AI engines, 1 assistant** — Claude · Codex · Gemini · OpenCode · Copilot. Switch with `/cli`.
 - ⚡ **Auto fallback** — If one engine is down, the next picks up seamlessly.
 - 🎭 **Multi-agent orchestration** — Complex tasks get split across specialized sub-agents automatically.
-- 📦 **122 skills** — Browser control, file editing, image generation, web search, and [much more](#-skill-system).
+- 📦 **105 skills** — Browser control, file editing, image generation, web search, and [much more](#-skill-system).
 - 🧠 **Persistent memory** — Your assistant remembers past conversations and preferences across sessions.
 - 📱 **Telegram bot** — Chat with your assistant from your phone, send voice/photos/files.
 - 🌐 **Browser automation** — Your assistant can navigate the web, click, type, and screenshot.
@@ -73,81 +128,12 @@ graph LR
 - 🔍 **Web search** — Real-time information via MCP tools.
 - ⏰ **Heartbeat jobs** — Schedule recurring tasks that run automatically.
 
----
-
-## Quick Start
-
-### Prerequisites
-
-| Requirement           | Why                                     |
-| --------------------- | --------------------------------------- |
-| **Node.js ≥ 22**      | Runtime. [Download](https://nodejs.org) |
-| **At least 1 AI CLI** | The engine that powers your assistant   |
-
-> 🆓 **Free options:** [Copilot CLI](https://docs.github.com/en/copilot) (GitHub free tier) and [OpenCode](https://opencode.ai) have free models — no credit card needed.
-
-### Install
-
-```bash
-# 1. Install globally
-npm install -g cli-jaw
-
-# 2. Run setup wizard (creates config, installs skills)
-jaw init
-
-# 3. Health check — see what's ready
-jaw doctor
-```
-
-<details>
-<summary>📋 Example <code>jaw doctor</code> output</summary>
-
-```
-🦈 CLI-JAW Doctor — 12 checks
-
- ✅ Node.js        v22.15.0
- ✅ npm             v10.9.4
- ✅ Claude CLI      installed
- ✅ Codex CLI       installed
- ⚠️ Gemini CLI      not found (optional)
- ✅ OpenCode CLI    installed
- ✅ Copilot CLI     installed
- ✅ Database        jaw.db OK
- ✅ Skills          17 active, 90 reference
- ✅ MCP             3 servers configured
- ✅ Memory          MEMORY.md exists
- ✅ Server          port 3457 available
-```
-
-</details>
-
-### Authenticate your AI engines
-
-```bash
-# Pick whichever you have — even 1 is enough
-claude auth          # Anthropic  (paid)
-codex login          # OpenAI     (paid)
-gemini               # Google     (first run triggers auth)
-# OpenCode            # auto-auth on first run
-# Copilot             # uses GitHub login (free tier available)
-```
-
-### Launch
-
-```bash
-jaw serve        # Web UI → http://localhost:3457
-jaw launchd      # Auto-start on boot (macOS)
-# — or —
-jaw chat         # Terminal TUI (no browser needed)
-```
-
-> 💡 **You don't need all 5.** Even one CLI is enough to start. Your assistant auto-detects which engines are available and falls back gracefully.
 
 ---
 
 ## 📦 Skill System
 
-**122 skills** out of the box — browser, github, notion, telegram, memory, pdf, image generation, and [much more](#).
+**105 skills** out of the box — browser, github, notion, telegram, memory, pdf, image generation, and [much more](#).
 
 <details>
 <summary>View all skills</summary>
@@ -155,7 +141,7 @@ jaw chat         # Terminal TUI (no browser needed)
 | Tier                 | Count | How it works                                              |
 | -------------------- | :---: | --------------------------------------------------------- |
 | **Active Skills**    |  17   | Auto-injected into every AI prompt. Always available.     |
-| **Reference Skills** | 105   | AI reads them on-demand when you ask for a relevant task. |
+| **Reference Skills** |  89   | AI reads them on-demand when you ask for a relevant task. |
 
 #### Active Skills (always on)
 
@@ -175,7 +161,7 @@ jaw chat         # Terminal TUI (no browser needed)
 
 #### Reference Skills (on-demand)
 
-88+ more skills ready to use — spotify, weather, deep-research, tts, video-downloader, apple-reminders, 1password, terraform, postgres, jupyter-notebook, sentry, whatsapp, and more.
+84 more skills ready to use — spotify, weather, deep-research, tts, video-downloader, apple-reminders, 1password, terraform, postgres, jupyter-notebook, sentry, whatsapp, and more.
 
 ```bash
 jaw skill install <name>    # Activate a reference skill permanently
@@ -317,13 +303,13 @@ jaw --home ~/my-project launchd --port 3458    # project → port 3458
 
 Each instance is fully independent — different working directory, different memory, different MCP config. Perfect for separating work/personal contexts or per-project AI setups.
 
-| Flag / Env             | What it does                                |
-| ---------------------- | ------------------------------------------- |
-| `--home <path>`        | Use a custom home directory for this run    |
-| `--home=<path>`        | Same, with `=` syntax                       |
-| `CLI_JAW_HOME=<path>`  | Set via environment variable                |
-| `jaw clone <target>`   | Clone current instance to a new directory   |
-| `--port <port>`        | Custom port for `serve` / `launchd`         |
+| Flag / Env            | What it does                              |
+| --------------------- | ----------------------------------------- |
+| `--home <path>`       | Use a custom home directory for this run  |
+| `--home=<path>`       | Same, with `=` syntax                     |
+| `CLI_JAW_HOME=<path>` | Set via environment variable              |
+| `jaw clone <target>`  | Clone current instance to a new directory |
+| `--port <port>`       | Custom port for `serve` / `launchd`       |
 
 ---
 
@@ -391,7 +377,7 @@ src/
 ## 🧪 Tests
 
 <details>
-<summary>306 pass · 1 skipped · zero external dependencies</summary>
+<summary>360 pass · 1 skipped · zero external dependencies</summary>
 
 ```bash
 npm test
@@ -429,6 +415,51 @@ All tests run via `tsx --test` (native Node.js test runner + TypeScript).
 
 </details>
 
+<details>
+<summary>🔄 Fresh start — clean reinstall for legacy / cli-claw users</summary>
+
+If you previously used **cli-claw** or an older version of cli-jaw and want a completely clean slate:
+
+```bash
+# ── 1. Uninstall ──
+npm uninstall -g cli-jaw
+
+# Verify removal
+which jaw && echo "⚠️  jaw still found" || echo "✅ jaw removed"
+
+# ── 2. Back up & remove data ──
+# Back up current data (just in case)
+[ -d ~/.cli-jaw ] && mv ~/.cli-jaw ~/.cli-jaw.bak.$(date +%s)
+
+# Remove work instances
+[ -d ~/.jaw-work ] && rm -rf ~/.jaw-work
+
+# ── 3. Remove launchd daemons (macOS) ──
+launchctl list | grep com.cli-jaw | awk '{print $3}' | \
+  xargs -I{} launchctl bootout gui/$(id -u) system/{}  2>/dev/null
+rm -f ~/Library/LaunchAgents/com.cli-jaw.*
+
+# ── 4. Remove legacy artifacts ──
+rm -f ~/AGENTS.md ~/CLAUDE.md          # postinstall symlinks
+rm -rf ~/.agents ~/.agent              # skill symlink dirs
+rm -rf ~/.cli-claw                     # old cli-claw data
+rm -f ~/.copilot/mcp-config.json       # MCP config synced by jaw
+
+# ── 5. Verify clean state ──
+echo "=== Clean State Check ==="
+which jaw; which cli-jaw               # should be "not found"
+ls ~/.cli-jaw ~/.cli-claw 2>&1         # should be "No such file"
+
+# ── 6. Reinstall ──
+npm install -g cli-jaw
+jaw init
+jaw doctor
+```
+
+> 💡 Your backup is at `~/.cli-jaw.bak.<timestamp>` — copy back `settings.json` or `jaw.db` if you want to restore previous config or conversation history.
+
+</details>
+
 ---
 
 ## 🤝 Contributing
@@ -439,7 +470,7 @@ Contributions are welcome! Here's how to get started:
 2. Run `npm run build && npm test` to make sure everything works
 3. Submit a PR — we'll review it promptly
 
-> 📋 Found a bug or have a feature idea? [Open an issue](https://github.com/bitkyc08-arch/cli-jaw/issues)
+> 📋 Found a bug or have a feature idea? [Open an issue](https://github.com/lidge-jun/cli-jaw/issues)
 
 ---