cli-jaw 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +67 -63
- package/README.md +68 -64
- package/README.zh-CN.md +67 -63
- package/dist/bin/cli-jaw.js +9 -5
- package/dist/bin/cli-jaw.js.map +1 -1
- package/dist/bin/commands/launchd.js +146 -0
- package/dist/bin/commands/launchd.js.map +1 -0
- package/dist/server.js +11 -0
- package/dist/server.js.map +1 -1
- package/package.json +2 -2
- package/public/dist/bundle.js +140 -0
- package/public/dist/bundle.js.map +7 -0
package/README.ko.md
CHANGED
|
@@ -30,13 +30,13 @@ CLI-JAW는 내 컴퓨터에 상주하며 이미 익숙한 인터페이스인 **
|
|
|
30
30
|
|
|
31
31
|
단일 모델만을 사용하는 기존 비서들과 달리, CLI-JAW는 5개의 AI 엔진(Claude, Codex, Gemini, OpenCode, Copilot)을 공식 CLI를 통해 오케스트레이션하여 모든 제공업체의 장점을 통합된 경험으로 제공합니다. 하나의 엔진 사용량이 초과되면 자동으로 다음 엔진으로 전환됩니다. 107개의 내장 스킬이 브라우저 자동화부터 문서 생성까지 모든 것을 처리합니다.
|
|
32
32
|
|
|
33
|
-
|
|
|
34
|
-
|
|
35
|
-
| 🛡️ **안전한 서비스 약관 준수**
|
|
36
|
-
| 🤖 **검증된 에이전트 도구**
|
|
37
|
-
| ⚡ **멀티 에이전트 자동 전환(Fallback)** | 엔진 하나가 멈춰도 걱정 없습니다. 다음 엔진이 즉시 이어받아 중단 없는 작업이 가능합니다.
|
|
38
|
-
| 🎭 **오케스트레이션 기반 성능 극대화**
|
|
39
|
-
| 📦 **107개의 내장 스킬**
|
|
33
|
+
| | 왜 CLI-JAW인가요? |
|
|
34
|
+
| --------------------------------------- | ----------------------------------------------------------------------------------------------------- |
|
|
35
|
+
| 🛡️ **안전한 서비스 약관 준수** | 공식 CLI만 사용합니다 — API 키 스크래핑이나 리버스 엔지니어링이 없으므로 계정 정지 위험이 없습니다. |
|
|
36
|
+
| 🤖 **검증된 에이전트 도구** | 실전에서 검증된 5개의 코딩 에이전트(Claude, Codex, Gemini, OpenCode, Copilot)를 한 곳에서 사용하세요. |
|
|
37
|
+
| ⚡ **멀티 에이전트 자동 전환(Fallback)** | 엔진 하나가 멈춰도 걱정 없습니다. 다음 엔진이 즉시 이어받아 중단 없는 작업이 가능합니다. |
|
|
38
|
+
| 🎭 **오케스트레이션 기반 성능 극대화** | 복잡한 작업은 전문화된 서브 에이전트에게 분산시켜 처리량을 극대화합니다. |
|
|
39
|
+
| 📦 **107개의 내장 스킬** | 브라우저 자동화, 문서 생성, 텔레그램 연동, 영구 메모리 등 설치 즉시 사용 가능한 기능들을 제공합니다. |
|
|
40
40
|
|
|
41
41
|
|
|
42
42
|
|
|
@@ -76,10 +76,10 @@ graph LR
|
|
|
76
76
|
|
|
77
77
|
### 사전 요구사항
|
|
78
78
|
|
|
79
|
-
| 필수 항목
|
|
80
|
-
|
|
81
|
-
| **Node.js ≥ 22**
|
|
82
|
-
| **AI CLI 최소 1개** | 비서를 움직이는 두뇌
|
|
79
|
+
| 필수 항목 | 용도 |
|
|
80
|
+
| ------------------- | -------------------------------------- |
|
|
81
|
+
| **Node.js ≥ 22** | 런타임. [다운로드](https://nodejs.org) |
|
|
82
|
+
| **AI CLI 최소 1개** | 비서를 움직이는 두뇌 |
|
|
83
83
|
|
|
84
84
|
> 🆓 **무료 옵션:** [Copilot CLI](https://docs.github.com/en/copilot)는 GitHub 무료 플랜에서도, [OpenCode](https://opencode.ai)는 무료 모델이 있어요 — 카드 등록 없이 바로 시작 가능.
|
|
85
85
|
|
|
@@ -90,14 +90,14 @@ graph LR
|
|
|
90
90
|
npm install -g cli-jaw
|
|
91
91
|
|
|
92
92
|
# 2. 초기 설정 (설정 파일 생성, 스킬 설치)
|
|
93
|
-
|
|
93
|
+
jaw init
|
|
94
94
|
|
|
95
95
|
# 3. 상태 확인 — 뭐가 준비됐는지 점검
|
|
96
|
-
|
|
96
|
+
jaw doctor
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
<details>
|
|
100
|
-
<summary>📋 <code>
|
|
100
|
+
<summary>📋 <code>jaw doctor</code> 출력 예시</summary>
|
|
101
101
|
|
|
102
102
|
```
|
|
103
103
|
🦈 CLI-JAW Doctor — 12 checks
|
|
@@ -132,9 +132,10 @@ gemini # Google (첫 실행 시 자동 인증)
|
|
|
132
132
|
### 실행
|
|
133
133
|
|
|
134
134
|
```bash
|
|
135
|
-
|
|
135
|
+
jaw serve # Web UI → http://localhost:3457
|
|
136
|
+
jaw launchd # 부팅 시 자동 실행 (macOS)
|
|
136
137
|
# — 또는 —
|
|
137
|
-
|
|
138
|
+
jaw chat # 터미널 TUI (브라우저 필요 없음)
|
|
138
139
|
```
|
|
139
140
|
|
|
140
141
|
> 💡 **5개 다 깔 필요 없어요.** 하나만 있으면 됩니다. 어떤 엔진이 설치돼 있는지 자동 감지하고, 없으면 다음 엔진으로 자연스럽게 넘어갑니다.
|
|
@@ -148,33 +149,33 @@ cli-jaw chat # 터미널 TUI (브라우저 필요 없음)
|
|
|
148
149
|
<details>
|
|
149
150
|
<summary>전체 스킬 목록 보기</summary>
|
|
150
151
|
|
|
151
|
-
| 티어
|
|
152
|
-
|
|
153
|
-
| **Active 스킬**
|
|
154
|
-
| **Reference 스킬** |
|
|
152
|
+
| 티어 | 수량 | 작동 방식 |
|
|
153
|
+
| ------------------ | :---: | ------------------------------------------------ |
|
|
154
|
+
| **Active 스킬** | 17 | 매번 AI한테 자동으로 주입돼요. 항상 켜져 있어요. |
|
|
155
|
+
| **Reference 스킬** | 88+ | 관련 작업을 시키면 그때 AI가 읽어서 써요. |
|
|
155
156
|
|
|
156
157
|
#### Active 스킬 (항상 켜짐)
|
|
157
158
|
|
|
158
|
-
| 스킬
|
|
159
|
-
|
|
160
|
-
| `browser`
|
|
161
|
-
| `github`
|
|
162
|
-
| `notion`
|
|
163
|
-
| `memory`
|
|
164
|
-
| `telegram-send`
|
|
165
|
-
| `vision-click`
|
|
166
|
-
| `imagegen`
|
|
167
|
-
| `pdf` / `docx` / `xlsx`
|
|
168
|
-
| `screen-capture`
|
|
169
|
-
| `openai-docs`
|
|
170
|
-
| `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | 서브에이전트용 개발 가이드
|
|
159
|
+
| 스킬 | 기능 |
|
|
160
|
+
| ------------------------------------------------------------------- | -------------------------------------------------- |
|
|
161
|
+
| `browser` | Chrome 자동화 — 스냅샷, 클릭, 네비게이트, 스크린샷 |
|
|
162
|
+
| `github` | 이슈, PR, CI, 코드 리뷰 (`gh` CLI 사용) |
|
|
163
|
+
| `notion` | Notion 페이지 및 데이터베이스 관리 |
|
|
164
|
+
| `memory` | 세션 간 영속 장기 메모리 |
|
|
165
|
+
| `telegram-send` | Telegram으로 사진, 문서, 음성 메시지 전송 |
|
|
166
|
+
| `vision-click` | 스크린샷 → AI가 좌표 찾기 → 클릭 (원커맨드) |
|
|
167
|
+
| `imagegen` | OpenAI Image API로 이미지 생성/편집 |
|
|
168
|
+
| `pdf` / `docx` / `xlsx` | 오피스 문서 읽기, 생성, 편집 |
|
|
169
|
+
| `screen-capture` | macOS 스크린샷 및 카메라 캡처 |
|
|
170
|
+
| `openai-docs` | 최신 OpenAI API 문서 |
|
|
171
|
+
| `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | 서브에이전트용 개발 가이드 |
|
|
171
172
|
|
|
172
173
|
#### Reference 스킬 (필요할 때만)
|
|
173
174
|
|
|
174
175
|
88개+ 스킬이 더 있어요 — spotify, 날씨, 딥리서치, TTS, 비디오 다운로드, Apple 미리알림, 1Password, Terraform, PostgreSQL, Jupyter 등.
|
|
175
176
|
|
|
176
177
|
```bash
|
|
177
|
-
|
|
178
|
+
jaw skill install <name> # reference → active로 영구 활성화
|
|
178
179
|
```
|
|
179
180
|
|
|
180
181
|
</details>
|
|
@@ -193,7 +194,7 @@ cli-jaw skill install <name> # reference → active로 영구 활성화
|
|
|
193
194
|
<summary>📋 텔레그램 설정 (3단계)</summary>
|
|
194
195
|
|
|
195
196
|
1. **봇 만들기** — [@BotFather](https://t.me/BotFather)에게 `/newbot` → 토큰 복사
|
|
196
|
-
2. **설정** — `
|
|
197
|
+
2. **설정** — `jaw init --telegram-token 토큰` 실행하거나 Web UI 설정에서 입력
|
|
197
198
|
3. **채팅 시작** — 봇에게 아무 메시지나 보내세요. 첫 메시지에서 채팅 ID가 자동 저장됩니다.
|
|
198
199
|
|
|
199
200
|
</details>
|
|
@@ -254,7 +255,7 @@ graph TD
|
|
|
254
255
|
## 🔌 MCP — 단일 설정, 5개의 AI 엔진
|
|
255
256
|
|
|
256
257
|
```bash
|
|
257
|
-
|
|
258
|
+
jaw mcp install @anthropic/context7 # 한 번만 설치
|
|
258
259
|
# → Claude, Codex, Gemini, OpenCode, Copilot 전부 자동 동기화
|
|
259
260
|
```
|
|
260
261
|
|
|
@@ -276,15 +277,18 @@ graph LR
|
|
|
276
277
|
## ⌨️ CLI 명령어
|
|
277
278
|
|
|
278
279
|
```bash
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
280
|
+
jaw serve # 서버 시작
|
|
281
|
+
jaw launchd # 부팅 시 자동 실행 (macOS)
|
|
282
|
+
jaw launchd status # 데몬 상태 확인
|
|
283
|
+
jaw launchd unset # 자동 실행 해제
|
|
284
|
+
jaw chat # 터미널 TUI
|
|
285
|
+
jaw doctor # 진단 (12개 체크)
|
|
286
|
+
jaw skill install <name> # 스킬 설치
|
|
287
|
+
jaw mcp install <package> # MCP 설치 → 5개 CLI 전부 동기화
|
|
288
|
+
jaw memory search <query> # 메모리 검색
|
|
289
|
+
jaw browser start # Chrome 시작 (CDP)
|
|
290
|
+
jaw browser vision-click "로그인" # AI가 알아서 클릭
|
|
291
|
+
jaw reset # 전체 초기화
|
|
288
292
|
```
|
|
289
293
|
|
|
290
294
|
---
|
|
@@ -296,13 +300,13 @@ cli-jaw reset # 전체 초기화
|
|
|
296
300
|
<details>
|
|
297
301
|
<summary>전체 프리셋 보기</summary>
|
|
298
302
|
|
|
299
|
-
| CLI
|
|
300
|
-
|
|
301
|
-
| **Claude**
|
|
302
|
-
| **Codex**
|
|
303
|
-
| **Gemini**
|
|
303
|
+
| CLI | 기본값 | 주요 모델 |
|
|
304
|
+
| ------------ | -------------------------- | ---------------------------------------------- |
|
|
305
|
+
| **Claude** | `claude-sonnet-4-6` | opus-4-6, haiku-4-5, 확장 사고 변형 |
|
|
306
|
+
| **Codex** | `gpt-5.3-codex` | spark, 5.2, 5.1-max, 5.1-mini |
|
|
307
|
+
| **Gemini** | `gemini-2.5-pro` | 3.0-pro-preview, 3-flash-preview, 2.5-flash |
|
|
304
308
|
| **OpenCode** | `claude-opus-4-6-thinking` | 🆓 big-pickle, GLM-5, MiniMax, Kimi, GPT-5-Nano |
|
|
305
|
-
| **Copilot**
|
|
309
|
+
| **Copilot** | `gpt-4.1` 🆓 | 🆓 gpt-5-mini, claude-sonnet-4.6, opus-4.6 |
|
|
306
310
|
|
|
307
311
|
</details>
|
|
308
312
|
|
|
@@ -367,24 +371,24 @@ npm test
|
|
|
367
371
|
|
|
368
372
|
## 📖 문서
|
|
369
373
|
|
|
370
|
-
| 문서
|
|
371
|
-
|
|
374
|
+
| 문서 | 내용 |
|
|
375
|
+
| --------------------------------------- | --------------------------------------------------- |
|
|
372
376
|
| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | 시스템 설계, 모듈 그래프, REST API (40+ 엔드포인트) |
|
|
373
|
-
| [TESTS.md](TESTS.md)
|
|
377
|
+
| [TESTS.md](TESTS.md) | 테스트 커버리지, 테스트 계획 |
|
|
374
378
|
|
|
375
379
|
---
|
|
376
380
|
|
|
377
381
|
## 🔧 문제 해결
|
|
378
382
|
|
|
379
|
-
| 증상
|
|
380
|
-
|
|
381
|
-
| `command not found: cli-jaw` | npm 전역 bin이 PATH에 없음
|
|
382
|
-
| `doctor`에서 CLI 누락 표시
|
|
383
|
-
| 포트 3457 사용 중
|
|
384
|
-
| 텔레그램 봇 무반응
|
|
385
|
-
| `npm install -g` 권한 오류
|
|
386
|
-
| 빌드 실패 (`tsc` 에러)
|
|
387
|
-
| 메모리가 세션 간 유지 안 됨
|
|
383
|
+
| 증상 | 원인 | 해결 방법 |
|
|
384
|
+
| ---------------------------- | ---------------------------------- | --------------------------------------------------------------------------- |
|
|
385
|
+
| `command not found: cli-jaw` | npm 전역 bin이 PATH에 없음 | `npm config get prefix` 확인 후 `bin/`을 PATH에 추가 |
|
|
386
|
+
| `doctor`에서 CLI 누락 표시 | 해당 CLI 미설치 | `npm i -g @anthropic-ai/claude-code` 등 설치 |
|
|
387
|
+
| 포트 3457 사용 중 | 다른 프로세스가 점유 | `PORT=4000 jaw serve` 또는 기존 프로세스 종료 |
|
|
388
|
+
| 텔레그램 봇 무반응 | 토큰 미설정 또는 Chat ID 누락 | `jaw init --telegram-token ...` 재실행 |
|
|
389
|
+
| `npm install -g` 권한 오류 | 글로벌 디렉토리 권한 문제 | `sudo npm i -g cli-jaw` 또는 [nvm](https://github.com/nvm-sh/nvm) 사용 권장 |
|
|
390
|
+
| 빌드 실패 (`tsc` 에러) | Node 22 미만 버전 | `node -v` 확인 → 22 이상으로 업그레이드 |
|
|
391
|
+
| 메모리가 세션 간 유지 안 됨 | `~/.cli-jaw/memory/` 디렉토리 없음 | `jaw init` 재실행하면 자동 생성 |
|
|
388
392
|
|
|
389
393
|
---
|
|
390
394
|
|
package/README.md
CHANGED
|
@@ -30,13 +30,13 @@ CLI-JAW is a **personal AI assistant** that lives on your machine and works from
|
|
|
30
30
|
|
|
31
31
|
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. 107 built-in skills handle everything from browser automation to document generation.
|
|
32
32
|
|
|
33
|
-
|
|
|
34
|
-
|
|
35
|
-
| 🛡️ **TOS-Safe**
|
|
36
|
-
| 🤖 **Verified Agent Tools**
|
|
37
|
-
| ⚡ **Multi-Agent Fallback**
|
|
38
|
-
| 🎭 **Orchestrated Performance** | Complex tasks split across specialized sub-agents for maximum throughput.
|
|
39
|
-
| 📦 **107 Built-in Skills**
|
|
33
|
+
| | Why CLI-JAW? |
|
|
34
|
+
| ------------------------------ | ---------------------------------------------------------------------------------------- |
|
|
35
|
+
| 🛡️ **TOS-Safe** | Uses official CLIs only — no API key scraping, no reverse engineering, no ban risk. |
|
|
36
|
+
| 🤖 **Verified Agent Tools** | 5 battle-tested coding agents (Claude, Codex, Gemini, OpenCode, Copilot) under one roof. |
|
|
37
|
+
| ⚡ **Multi-Agent Fallback** | One engine down? The next picks up automatically. Zero downtime. |
|
|
38
|
+
| 🎭 **Orchestrated Performance** | Complex tasks split across specialized sub-agents for maximum throughput. |
|
|
39
|
+
| 📦 **107 Built-in Skills** | Browser automation, document generation, Telegram, memory — ready out of the box. |
|
|
40
40
|
|
|
41
41
|
|
|
42
42
|
|
|
@@ -76,10 +76,10 @@ graph LR
|
|
|
76
76
|
|
|
77
77
|
### Prerequisites
|
|
78
78
|
|
|
79
|
-
| Requirement
|
|
80
|
-
|
|
81
|
-
| **Node.js ≥ 22**
|
|
82
|
-
| **At least 1 AI CLI** | The engine that powers your assistant
|
|
79
|
+
| Requirement | Why |
|
|
80
|
+
| --------------------- | --------------------------------------- |
|
|
81
|
+
| **Node.js ≥ 22** | Runtime. [Download](https://nodejs.org) |
|
|
82
|
+
| **At least 1 AI CLI** | The engine that powers your assistant |
|
|
83
83
|
|
|
84
84
|
> 🆓 **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.
|
|
85
85
|
|
|
@@ -90,14 +90,14 @@ graph LR
|
|
|
90
90
|
npm install -g cli-jaw
|
|
91
91
|
|
|
92
92
|
# 2. Run setup wizard (creates config, installs skills)
|
|
93
|
-
|
|
93
|
+
jaw init
|
|
94
94
|
|
|
95
95
|
# 3. Health check — see what's ready
|
|
96
|
-
|
|
96
|
+
jaw doctor
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
<details>
|
|
100
|
-
<summary>📋 Example <code>
|
|
100
|
+
<summary>📋 Example <code>jaw doctor</code> output</summary>
|
|
101
101
|
|
|
102
102
|
```
|
|
103
103
|
🦈 CLI-JAW Doctor — 12 checks
|
|
@@ -132,9 +132,10 @@ gemini # Google (first run triggers auth)
|
|
|
132
132
|
### Launch
|
|
133
133
|
|
|
134
134
|
```bash
|
|
135
|
-
|
|
135
|
+
jaw serve # Web UI → http://localhost:3457
|
|
136
|
+
jaw launchd # Auto-start on boot (macOS)
|
|
136
137
|
# — or —
|
|
137
|
-
|
|
138
|
+
jaw chat # Terminal TUI (no browser needed)
|
|
138
139
|
```
|
|
139
140
|
|
|
140
141
|
> 💡 **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.
|
|
@@ -148,33 +149,33 @@ cli-jaw chat # Terminal TUI (no browser needed)
|
|
|
148
149
|
<details>
|
|
149
150
|
<summary>View all skills</summary>
|
|
150
151
|
|
|
151
|
-
| Tier
|
|
152
|
-
|
|
153
|
-
| **Active Skills**
|
|
154
|
-
| **Reference Skills** |
|
|
152
|
+
| Tier | Count | How it works |
|
|
153
|
+
| -------------------- | :---: | --------------------------------------------------------- |
|
|
154
|
+
| **Active Skills** | 17 | Auto-injected into every AI prompt. Always available. |
|
|
155
|
+
| **Reference Skills** | 90 | AI reads them on-demand when you ask for a relevant task. |
|
|
155
156
|
|
|
156
157
|
#### Active Skills (always on)
|
|
157
158
|
|
|
158
|
-
| Skill
|
|
159
|
-
|
|
160
|
-
| `browser`
|
|
161
|
-
| `github`
|
|
162
|
-
| `notion`
|
|
163
|
-
| `memory`
|
|
164
|
-
| `telegram-send`
|
|
165
|
-
| `vision-click`
|
|
166
|
-
| `imagegen`
|
|
167
|
-
| `pdf` / `docx` / `xlsx`
|
|
168
|
-
| `screen-capture`
|
|
169
|
-
| `openai-docs`
|
|
170
|
-
| `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | Development guidelines for sub-agents
|
|
159
|
+
| Skill | What it does |
|
|
160
|
+
| ------------------------------------------------------------------- | --------------------------------------------------------- |
|
|
161
|
+
| `browser` | Chrome automation — snapshot, click, navigate, screenshot |
|
|
162
|
+
| `github` | Issues, PRs, CI, code review via `gh` CLI |
|
|
163
|
+
| `notion` | Create/manage Notion pages and databases |
|
|
164
|
+
| `memory` | Persistent long-term memory across sessions |
|
|
165
|
+
| `telegram-send` | Send photos, documents, voice messages to Telegram |
|
|
166
|
+
| `vision-click` | Screenshot → AI finds coordinates → clicks (one command) |
|
|
167
|
+
| `imagegen` | Generate/edit images via OpenAI Image API |
|
|
168
|
+
| `pdf` / `docx` / `xlsx` | Read, create, edit office documents |
|
|
169
|
+
| `screen-capture` | macOS screenshot and camera capture |
|
|
170
|
+
| `openai-docs` | Up-to-date OpenAI API documentation |
|
|
171
|
+
| `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | Development guidelines for sub-agents |
|
|
171
172
|
|
|
172
173
|
#### Reference Skills (on-demand)
|
|
173
174
|
|
|
174
175
|
88+ more skills ready to use — spotify, weather, deep-research, tts, video-downloader, apple-reminders, 1password, terraform, postgres, jupyter-notebook, sentry, and more.
|
|
175
176
|
|
|
176
177
|
```bash
|
|
177
|
-
|
|
178
|
+
jaw skill install <name> # Activate a reference skill permanently
|
|
178
179
|
```
|
|
179
180
|
|
|
180
181
|
</details>
|
|
@@ -193,7 +194,7 @@ Your assistant isn't tied to your desk. Chat from anywhere via Telegram:
|
|
|
193
194
|
<summary>📋 Telegram setup (3 steps)</summary>
|
|
194
195
|
|
|
195
196
|
1. **Create a bot** — Message [@BotFather](https://t.me/BotFather) → `/newbot` → copy the token
|
|
196
|
-
2. **Configure** — Run `
|
|
197
|
+
2. **Configure** — Run `jaw init --telegram-token YOUR_TOKEN` or edit settings in the Web UI
|
|
197
198
|
3. **Start chatting** — Send any message to your bot. Your chat ID is auto-saved on first message.
|
|
198
199
|
|
|
199
200
|
</details>
|
|
@@ -254,7 +255,7 @@ Your assistant **decides by itself** whether a task needs orchestration or a dir
|
|
|
254
255
|
## 🔌 MCP — One Config, Five AI Engines
|
|
255
256
|
|
|
256
257
|
```bash
|
|
257
|
-
|
|
258
|
+
jaw mcp install @anthropic/context7 # Install once
|
|
258
259
|
# → Automatically syncs to Claude, Codex, Gemini, OpenCode, Copilot
|
|
259
260
|
```
|
|
260
261
|
|
|
@@ -276,15 +277,18 @@ No more editing 5 different config files. Install once → all AI engines get it
|
|
|
276
277
|
## ⌨️ CLI Commands
|
|
277
278
|
|
|
278
279
|
```bash
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
280
|
+
jaw serve # Start server
|
|
281
|
+
jaw chat # Terminal TUI
|
|
282
|
+
jaw doctor # Diagnostics (12 checks)
|
|
283
|
+
jaw skill install <name> # Install a skill
|
|
284
|
+
jaw mcp install <package> # Install MCP → syncs to all 5 CLIs
|
|
285
|
+
jaw memory search <query> # Search memory
|
|
286
|
+
jaw browser start # Launch Chrome (CDP)
|
|
287
|
+
jaw browser vision-click "Login" # AI-powered click
|
|
288
|
+
jaw launchd # Auto-start on boot (macOS)
|
|
289
|
+
jaw launchd status # Check daemon status
|
|
290
|
+
jaw launchd unset # Remove auto-start
|
|
291
|
+
jaw reset # Full reset
|
|
288
292
|
```
|
|
289
293
|
|
|
290
294
|
---
|
|
@@ -296,13 +300,13 @@ Each CLI comes with preconfigured presets, but you can type **any model ID** dir
|
|
|
296
300
|
<details>
|
|
297
301
|
<summary>View all presets</summary>
|
|
298
302
|
|
|
299
|
-
| CLI
|
|
300
|
-
|
|
301
|
-
| **Claude**
|
|
302
|
-
| **Codex**
|
|
303
|
-
| **Gemini**
|
|
304
|
-
| **OpenCode** | `claude-opus-4-6-thinking` | 🆓 big-pickle, GLM-5, MiniMax, Kimi, GPT-5-Nano
|
|
305
|
-
| **Copilot**
|
|
303
|
+
| CLI | Default | Notable Models |
|
|
304
|
+
| ------------ | -------------------------- | ----------------------------------------------- |
|
|
305
|
+
| **Claude** | `claude-sonnet-4-6` | opus-4-6, haiku-4-5, extended thinking variants |
|
|
306
|
+
| **Codex** | `gpt-5.3-codex` | spark, 5.2, 5.1-max, 5.1-mini |
|
|
307
|
+
| **Gemini** | `gemini-2.5-pro` | 3.0-pro-preview, 3-flash-preview, 2.5-flash |
|
|
308
|
+
| **OpenCode** | `claude-opus-4-6-thinking` | 🆓 big-pickle, GLM-5, MiniMax, Kimi, GPT-5-Nano |
|
|
309
|
+
| **Copilot** | `gpt-4.1` 🆓 | 🆓 gpt-5-mini, claude-sonnet-4.6, opus-4.6 |
|
|
306
310
|
|
|
307
311
|
</details>
|
|
308
312
|
|
|
@@ -367,10 +371,10 @@ All tests run via `tsx --test` (native Node.js test runner + TypeScript).
|
|
|
367
371
|
|
|
368
372
|
## 📖 Documentation
|
|
369
373
|
|
|
370
|
-
| Document
|
|
371
|
-
|
|
374
|
+
| Document | What's inside |
|
|
375
|
+
| --------------------------------------- | ----------------------------------------------------- |
|
|
372
376
|
| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | System design, module graph, REST API (40+ endpoints) |
|
|
373
|
-
| [TESTS.md](TESTS.md)
|
|
377
|
+
| [TESTS.md](TESTS.md) | Test coverage and test plan |
|
|
374
378
|
|
|
375
379
|
---
|
|
376
380
|
|
|
@@ -379,15 +383,15 @@ All tests run via `tsx --test` (native Node.js test runner + TypeScript).
|
|
|
379
383
|
<details>
|
|
380
384
|
<summary>Common issues</summary>
|
|
381
385
|
|
|
382
|
-
| Problem
|
|
383
|
-
|
|
384
|
-
| `cli-jaw: command not found` | Run `npm install -g cli-jaw` again. Check `npm bin -g` is in your `$PATH`.
|
|
385
|
-
| `Error: node version`
|
|
386
|
-
| Agent timeout / no response
|
|
387
|
-
| `EADDRINUSE: port 3457`
|
|
388
|
-
| Telegram bot not responding
|
|
389
|
-
| Skills not loading
|
|
390
|
-
| Browser commands fail
|
|
386
|
+
| Problem | Solution |
|
|
387
|
+
| ---------------------------- | ------------------------------------------------------------------------------------------- |
|
|
388
|
+
| `cli-jaw: command not found` | Run `npm install -g cli-jaw` again. Check `npm bin -g` is in your `$PATH`. |
|
|
389
|
+
| `Error: node version` | Upgrade to Node.js ≥ 22: `nvm install 22` or download from [nodejs.org](https://nodejs.org) |
|
|
390
|
+
| Agent timeout / no response | Run `jaw doctor` to check CLI auth. Re-authenticate with `claude auth` / `codex login`. |
|
|
391
|
+
| `EADDRINUSE: port 3457` | Another instance is running. Stop it or use `jaw serve --port 3458`. |
|
|
392
|
+
| Telegram bot not responding | Check token with `jaw doctor`. Ensure `jaw serve` is running. |
|
|
393
|
+
| Skills not loading | Run `jaw skill reset` then `jaw mcp sync`. |
|
|
394
|
+
| Browser commands fail | Install Chrome/Chromium. Run `jaw browser start` first. |
|
|
391
395
|
|
|
392
396
|
</details>
|
|
393
397
|
|