cli-jaw 0.1.7 → 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,7 +85,7 @@ 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?                                                                                |
 | ------------------------------ | ------------------------------------------------------------------------------------------- |
@@ -38,7 +93,7 @@ Unlike single-model assistants, CLI-JAW orchestrates **5 AI engines** (Claude, C
 | 🤖 **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.           |
+| 📦 **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
@@ -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
@@ -484,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)
 
 ---
 

package/README.zh-CN.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,9 +20,63 @@
 
 ---
 
-## CLI-JAW 是什么？
+## 🚀 安装与启动（30 秒）
+
+```bash
+npm install -g cli-jaw
+jaw serve
+```
+
+**搞定。** 打开 **http://localhost:3457** 直接开聊。🦈
+
+> 需要 **Node.js ≥ 22**（[下载](https://nodejs.org)）+ 下方**至少 1 个 AI CLI** 完成认证。
+
+---
+
+## 🔑 认证 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 个。** 有一个就能跑。助手会自动检测可用引擎，缺了就无缝切换到下一个。
+
+---
 
-> ⚠️ **安装须知：** `npm install -g cli-jaw` 运行 postinstall 脚本，可能会修改全局 CLI 技能目录（`~/.agents/skills/`、`~/.claude/skills/`）、自定义指令（`~/AGENTS.md` → `~/CLAUDE.md` 符号链接）以及 MCP 配置（`~/.cli-jaw/mcp.json` → 同步至 Claude/Codex/Gemini/OpenCode/Copilot）。现有配置不会被覆盖，而是合并处理。
+## CLI-JAW 是什么？
 
 CLI-JAW 是驻留在您本地机器上的**专属 AI 助手**，并在您熟悉的界面中运行 — **网页、终端和 Telegram**。您可以向它提出任何问题、委派任务或是自动化您的工作流。
 
@@ -30,7 +84,7 @@ CLI-JAW 是驻留在您本地机器上的**专属 AI 助手**，并在您熟悉
 > 💬 *"重构这个模块，顺便写好测试"* → 子 Agent 搞定，你喝杯咖啡回来就行  
 > 💬 *"把那个 PDF 下载下来，关键信息放到 Notion 里"* → 浏览器 + Notion 技能组合，搞定
 
-与单一模型的助手不同，CLI-JAW 通过官方 CLI 命令行工具对 **5 大 AI 引擎**（Claude、Codex、Gemini、OpenCode、Copilot）进行编排 — 为您提供各大供应商最优势的能力及统一的体验。当一个引擎处于繁忙状态时，它会自动无缝切换至下一个。107 个内置技能可处理从浏览器自动化到文档生成的所有事务。
+与单一模型的助手不同，CLI-JAW 通过官方 CLI 命令行工具对 **5 大 AI 引擎**（Claude、Codex、Gemini、OpenCode、Copilot）进行编排 — 为您提供各大供应商最优势的能力及统一的体验。当一个引擎处于繁忙状态时，它会自动无缝切换至下一个。105 个内置技能可处理从浏览器自动化到文档生成的所有事务。
 
 |                                 | 为什么选择 CLI-JAW？                                                       |
 | ------------------------------- | -------------------------------------------------------------------------- |
@@ -38,7 +92,7 @@ CLI-JAW 是驻留在您本地机器上的**专属 AI 助手**，并在您熟悉
 | 🤖 **经过验证的智能体工具**      | 5 大实战级编码智能体（Claude、Codex、Gemini、OpenCode、Copilot）集于一身。 |
 | ⚡ **多模型自动回退 (Fallback)** | 单一引擎发生故障？下一个立即接管。确保零停机。                             |
 | 🎭 **基于编排的性能优化**        | 复杂的任务会被拆分给专业的子智能体，以实现效率最大化。                     |
-| 📦 **107 个内置技能**            | 浏览器自动化、文档生成、Telegram 通知、持久化记忆 — 开箱即用。             |
+| 📦 **105 个内置技能**            | 浏览器自动化、文档生成、Telegram 通知、持久化记忆 — 开箱即用。             |
 | 🖥️ **跨平台支持**               | macOS、Linux、Windows (WSL) — 浏览器启动、CLI 检测、安装均原生支持。        |
 
 ![CLI-JAW 终端](docs/screenshots/terminal-cli.png)
@@ -65,7 +119,7 @@ graph LR
 - 🤖 **5 大 AI 引擎，1 个专属助手** — Claude · Codex · Gemini · OpenCode · Copilot。使用 `/cli` 命令一键切换。
 - ⚡ **自动回退 (Fallback)** — 即使一个引擎出现故障，下一个也会无缝接管。
 - 🎭 **多智能体编排** — 复杂任务会自动拆分给专业的子智能体并行处理。
-- 📦 **107 个技能** — 浏览器控制、文件编辑、图片生成、网页搜索以及[更多功能](#-技能系统)。
+- 📦 **105 个技能** — 浏览器控制、文件编辑、图片生成、网页搜索以及[更多功能](#-技能系统)。
 - 🧠 **持久化记忆** — 跨越不同会话，记住您过往的对话和偏好设定。
 - 📱 **Telegram 机器人** — 通过手机即可与您的助手聊天、发送语音/图片/文件。
 - 🌐 **浏览器自动化** — 您的助手能够自动导航网页、点击、打字并进行截图。
@@ -75,79 +129,20 @@ graph LR
 
 ---
 
-## 快速开始
-
-### 前置要求
-
-| 必备条件             | 说明                                   |
-| -------------------- | -------------------------------------- |
-| **Node.js ≥ 22**     | 运行时环境。[下载](https://nodejs.org) |
-| **至少 1 个 AI CLI** | 驱动助手的 AI 引擎                     |
-
-> 🆓 **免费方案：** [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、Notion、Telegram、记忆、PDF、图片生成等[应有尽有](#)。
+**105 个技能**开箱即用 — 浏览器、GitHub、Notion、Telegram、记忆、PDF、图片生成等[应有尽有](#)。
 
 <details>
 <summary>查看全部技能</summary>
@@ -155,7 +150,7 @@ jaw chat         # 终端 TUI（无需浏览器）
 | 层级         | 数量  | 工作方式                           |
 | ------------ | :---: | ---------------------------------- |
 | **活跃技能** |  17   | 每次对话自动加载，随时可用。       |
-| **参考技能** |  88+  | 用到的时候 AI 自己去读，按需调用。 |
+| **参考技能** |  89   | 用到的时候 AI 自己去读，按需调用。 |
 
 #### 活跃技能（常驻）
 
@@ -175,7 +170,7 @@ jaw chat         # 终端 TUI（无需浏览器）
 
 #### 参考技能（按需调用）
 
-88 个技能随时待命 — Spotify、天气、深度研究、TTS、视频下载、Apple 提醒事项、1Password、Terraform、PostgreSQL、Jupyter 等。
+84 个技能随时待命 — Spotify、天气、深度研究、TTS、视频下载、Apple 提醒事项、1Password、Terraform、PostgreSQL、Jupyter 等。
 
 ```bash
 jaw skill install <name>    # 参考 → 活跃，永久激活
@@ -360,7 +355,7 @@ src/
 ## 🧪 测试
 
 <details>
-<summary>252 pass · 1 skipped · 零外部依赖</summary>
+<summary>360 pass · 1 skipped · 零外部依赖</summary>
 
 ```bash
 npm test
@@ -403,7 +398,7 @@ npm test
 2. `npm run build && npm test` 确认一切正常
 3. 提交 PR — 我们会尽快 review
 
-> 📋 发现 Bug 或者有好点子？[提个 Issue](https://github.com/bitkyc08-arch/cli-jaw/issues)
+> 📋 发现 Bug 或者有好点子？[提个 Issue](https://github.com/lidge-jun/cli-jaw/issues)
 
 ---