claude-pro-minmax 1.1.0 → 1.2.0
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 +71 -57
- package/README.md +71 -57
- package/bin/cpmm.js +2 -697
- package/install.sh +2 -2
- package/lib/cli.js +244 -0
- package/package.json +12 -12
- package/.claude/sessions/2025-01-27-auth-jwt-refresh.md +0 -32
- package/.claude/sessions/README.ko.md +0 -195
- package/.claude/sessions/README.md +0 -195
- package/.claude/skills/learned/README.ko.md +0 -64
- package/.claude/skills/learned/README.md +0 -64
- package/bin/dependency-policy.js +0 -189
package/README.ko.md
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
<!-- Badges -->
|
|
4
4
|
[](https://www.npmjs.com/package/claude-pro-minmax)
|
|
5
5
|
[](https://www.npmjs.com/package/claude-pro-minmax)
|
|
6
|
+
[](https://nodejs.org/)
|
|
6
7
|
|
|
7
8
|
|
|
8
9
|
|
|
@@ -27,86 +28,93 @@ CPMM은 모델 라우팅, 출력 제어, 로컬 안전장치로 리셋 전까지
|
|
|
27
28
|
|
|
28
29
|
## 🛠 설치 (Installation)
|
|
29
30
|
|
|
30
|
-
### 1.
|
|
31
|
+
### 1. 설치 (권장)
|
|
31
32
|
```bash
|
|
32
|
-
npm install -g claude-pro-minmax
|
|
33
|
-
cpmm
|
|
33
|
+
npm install -g claude-pro-minmax@latest
|
|
34
|
+
cpmm setup
|
|
35
|
+
cpmm doctor
|
|
34
36
|
```
|
|
35
37
|
|
|
36
|
-
|
|
38
|
+
### 2. 업데이트
|
|
37
39
|
```bash
|
|
38
|
-
|
|
40
|
+
npm install -g claude-pro-minmax@latest
|
|
41
|
+
cpmm setup
|
|
39
42
|
```
|
|
40
43
|
|
|
41
|
-
###
|
|
44
|
+
### 3. 트러블슈팅 (빠른 복구)
|
|
42
45
|
```bash
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
+
# 누락된 의존성 재설치
|
|
47
|
+
cpmm setup
|
|
48
|
+
|
|
49
|
+
# 상태 확인만
|
|
50
|
+
cpmm doctor
|
|
46
51
|
```
|
|
47
52
|
|
|
48
|
-
|
|
49
|
-
- `
|
|
53
|
+
의존성 정책:
|
|
54
|
+
- `required`: `jq`, `mgrep`, `tmux`
|
|
55
|
+
- `optional` (확인만): `claude` (사전 설치 가정)
|
|
56
|
+
- 자동 설치 지원: `npm` (mgrep), `brew` (macOS), Linux 패키지 매니저 `apt-get`, `dnf`, `pacman`, `apk`
|
|
57
|
+
- macOS에서 Homebrew가 없으면 설치 명령을 안내합니다
|
|
58
|
+
|
|
59
|
+
### 4. Perplexity/언어 설정 (선택)
|
|
60
|
+
- 최초 인터랙티브 설치 시 `cpmm setup`이 출력 언어와 Perplexity API 키를 묻습니다.
|
|
61
|
+
- 영어(기본): 파일이 필요 없습니다. `~/.claude/rules/language.md`가 있으면 삭제하세요.
|
|
62
|
+
- 비영어: `~/.claude/rules/language.md`를 만들어 원하는 언어를 지정하세요.
|
|
63
|
+
- Perplexity를 수동으로 설정하려면 `~/.claude.json`의 `mcpServers`에 아래를 추가하세요:
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
"perplexity": {
|
|
67
|
+
"command": "npx",
|
|
68
|
+
"args": ["-y", "@perplexity-ai/mcp-server"],
|
|
69
|
+
"env": {
|
|
70
|
+
"PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
50
74
|
|
|
51
|
-
###
|
|
75
|
+
### 5. 고급 (선택)
|
|
76
|
+
<details>
|
|
77
|
+
<summary>수동 의존성 설치와 소스 설치 보기</summary>
|
|
78
|
+
|
|
79
|
+
수동 의존성 설치:
|
|
52
80
|
```bash
|
|
53
|
-
#
|
|
54
|
-
npm install -g @anthropic-ai/claude-code
|
|
81
|
+
# jq
|
|
55
82
|
brew install jq # macOS
|
|
56
|
-
sudo apt-get install jq
|
|
83
|
+
sudo apt-get install -y jq # Ubuntu/Debian
|
|
84
|
+
sudo dnf install -y jq # Fedora/RHEL
|
|
85
|
+
sudo pacman -S --noconfirm jq # Arch
|
|
86
|
+
sudo apk add jq # Alpine
|
|
57
87
|
|
|
58
|
-
#
|
|
88
|
+
# mgrep
|
|
59
89
|
npm install -g @mixedbread/mgrep
|
|
60
90
|
mgrep install-claude-code
|
|
91
|
+
|
|
92
|
+
# tmux
|
|
61
93
|
brew install tmux # macOS
|
|
62
|
-
sudo apt-get install tmux
|
|
94
|
+
sudo apt-get install -y tmux # Ubuntu/Debian
|
|
95
|
+
sudo dnf install -y tmux # Fedora/RHEL
|
|
96
|
+
sudo pacman -S --noconfirm tmux # Arch
|
|
97
|
+
sudo apk add tmux # Alpine
|
|
63
98
|
```
|
|
64
99
|
|
|
65
|
-
|
|
100
|
+
소스에서 수동 설치:
|
|
66
101
|
```bash
|
|
67
102
|
git clone https://github.com/move-hoon/claude-pro-minmax.git
|
|
68
103
|
cd claude-pro-minmax
|
|
69
|
-
node bin/cpmm.js
|
|
104
|
+
node bin/cpmm.js setup
|
|
70
105
|
# 고급/디버그 경로 (동일한 내부 설치기):
|
|
71
106
|
# bash install.sh
|
|
72
107
|
```
|
|
73
108
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
```json
|
|
84
|
-
"perplexity": {
|
|
85
|
-
"command": "npx",
|
|
86
|
-
"args": ["-y", "@perplexity-ai/mcp-server"],
|
|
87
|
-
"env": {
|
|
88
|
-
"PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
> **함께 포함된 MCP 서버 (기본 활성화):**
|
|
94
|
-
> - **Sequential Thinking**: 복잡한 로직 처리를 위한 강력한 추론 도구
|
|
95
|
-
> - **Context7**: 고급 문서 조회 및 컨텍스트 관리 도구
|
|
96
|
-
|
|
97
|
-
> **Note:** 최초 `cpmm install`(또는 `npx claude-pro-minmax@latest install`) 시 기존 `~/.claude`를 `~/.claude.pre-cpmm`으로 백업합니다. 이후 `cpmm install` 재실행은 CPMM 관리 파일만 업데이트하며, 사용자 설정(`language.md`, `settings.local.json`, `skills/learned/`, `plans/` 등)은 보존됩니다. (`cpmm install`은 내부적으로 `install.sh`를 호출합니다.)
|
|
98
|
-
|
|
99
|
-
### 6. 프로젝트 초기화
|
|
100
|
-
> **Tip:** `claude` 실행 전, 이 저장소의 `project-templates/`를 참고해 프로젝트를 초기화하세요. (설치기는 `project-templates`를 `~/.claude`로 복사하지 않습니다.)
|
|
101
|
-
|
|
102
|
-
### 7. 설치 확인
|
|
103
|
-
```bash
|
|
104
|
-
cpmm setup --check
|
|
105
|
-
cpmm doctor
|
|
106
|
-
# 또는 (전역 설치 없이 1회 실행)
|
|
107
|
-
npx claude-pro-minmax@latest setup --check
|
|
108
|
-
npx claude-pro-minmax@latest doctor
|
|
109
|
-
```
|
|
109
|
+
설치 동작:
|
|
110
|
+
- `cpmm setup`은 누락된 의존성을 설치한 뒤, CPMM 설정(설정 파일 복사, 언어 선택, Perplexity 설정)까지 진행합니다.
|
|
111
|
+
- `cpmm doctor`는 수정 없이 의존성 상태만 확인합니다.
|
|
112
|
+
- 재실행 시 CPMM 관리 파일만 갱신하고, `language.md`, `settings.local.json`, `skills/learned/`, `sessions/` 등 사용자 파일은 보존합니다.
|
|
113
|
+
|
|
114
|
+
프로젝트 초기화 팁:
|
|
115
|
+
- `claude` 실행 전에 `project-templates/`를 참고해 프로젝트를 초기화하세요. (설치기는 `project-templates`를 `~/.claude`로 복사하지 않습니다.)
|
|
116
|
+
|
|
117
|
+
</details>
|
|
110
118
|
|
|
111
119
|
---
|
|
112
120
|
|
|
@@ -250,10 +258,16 @@ claude-pro-minmax
|
|
|
250
258
|
├── .claude.json # 글로벌 MCP 설정 (User Scope)
|
|
251
259
|
├── .claudeignore # Claude 컨텍스트 제외 규칙
|
|
252
260
|
├── .gitignore # Git ignore 규칙
|
|
253
|
-
├──
|
|
261
|
+
├── CONTRIBUTING.md # 기여 가이드
|
|
262
|
+
├── install.sh # 핵심 설치 스크립트 (`cpmm setup`이 내부 호출)
|
|
254
263
|
├── LICENSE # MIT 라이선스
|
|
255
264
|
├── README.md # 영문 문서
|
|
256
265
|
├── README.ko.md # 국문 문서
|
|
266
|
+
├── package.json # npm 패키지 매니페스트
|
|
267
|
+
├── bin/ # CPMM CLI 엔트리포인트
|
|
268
|
+
│ ├── cpmm.js # `cpmm` 실행 진입점
|
|
269
|
+
├── lib/ # CPMM CLI 코어 구현
|
|
270
|
+
│ └── cli.js # setup/doctor 명령 로직
|
|
257
271
|
├── .claude/
|
|
258
272
|
│ ├── CLAUDE.md # 핵심 지침 (모든 세션에 로드됨)
|
|
259
273
|
│ ├── settings.json # 프로젝트 설정 (권한, 훅, 환경변수)
|
|
@@ -399,7 +413,7 @@ A: 네, 하지만 이러한 최적화가 필요하지 않을 수 있습니다. M
|
|
|
399
413
|
<details>
|
|
400
414
|
<summary><strong>Q: 기존 Claude Code 설정과 충돌하나요?</strong></summary>
|
|
401
415
|
|
|
402
|
-
A: 최초 `cpmm
|
|
416
|
+
A: 최초 `cpmm setup` 시 기존 `~/.claude`를 `~/.claude.pre-cpmm`으로 백업합니다. 재실행 시 CPMM 관리 파일만 갱신하고, 언어 설정·로컬 설정·학습된 패턴·세션 기록은 보존됩니다.
|
|
403
417
|
</details>
|
|
404
418
|
|
|
405
419
|
<details>
|
package/README.md
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
<!-- Badges -->
|
|
4
4
|
[](https://www.npmjs.com/package/claude-pro-minmax)
|
|
5
5
|
[](https://www.npmjs.com/package/claude-pro-minmax)
|
|
6
|
+
[](https://nodejs.org/)
|
|
6
7
|
|
|
7
8
|
|
|
8
9
|
|
|
@@ -27,86 +28,93 @@ CPMM helps Pro users complete more verified tasks before reset through model rou
|
|
|
27
28
|
|
|
28
29
|
## 🛠 Installation
|
|
29
30
|
|
|
30
|
-
### 1.
|
|
31
|
+
### 1. Install (Recommended)
|
|
31
32
|
```bash
|
|
32
|
-
npm install -g claude-pro-minmax
|
|
33
|
-
cpmm
|
|
33
|
+
npm install -g claude-pro-minmax@latest
|
|
34
|
+
cpmm setup
|
|
35
|
+
cpmm doctor
|
|
34
36
|
```
|
|
35
37
|
|
|
36
|
-
|
|
38
|
+
### 2. Update
|
|
37
39
|
```bash
|
|
38
|
-
|
|
40
|
+
npm install -g claude-pro-minmax@latest
|
|
41
|
+
cpmm setup
|
|
39
42
|
```
|
|
40
43
|
|
|
41
|
-
###
|
|
44
|
+
### 3. Troubleshooting (Quick)
|
|
42
45
|
```bash
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
+
# re-run setup to install any missing deps
|
|
47
|
+
cpmm setup
|
|
48
|
+
|
|
49
|
+
# check status only
|
|
50
|
+
cpmm doctor
|
|
46
51
|
```
|
|
47
52
|
|
|
48
|
-
|
|
49
|
-
- `
|
|
53
|
+
Dependency policy:
|
|
54
|
+
- `required`: `jq`, `mgrep`, `tmux`
|
|
55
|
+
- `optional` (check only): `claude` (assumed pre-installed)
|
|
56
|
+
- auto-install supports `npm` (mgrep), `brew` (macOS), and Linux package managers `apt-get`, `dnf`, `pacman`, `apk`
|
|
57
|
+
- on macOS without Homebrew, setup prints the Homebrew install command
|
|
58
|
+
|
|
59
|
+
### 4. Perplexity and Language (Optional)
|
|
60
|
+
- On fresh interactive installs, `cpmm setup` asks for output language and Perplexity API key.
|
|
61
|
+
- English (default): no file needed; remove `~/.claude/rules/language.md` if it exists.
|
|
62
|
+
- Non-English: create `~/.claude/rules/language.md` with your preferred language.
|
|
63
|
+
- To configure Perplexity manually, add this under `mcpServers` in `~/.claude.json`:
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
"perplexity": {
|
|
67
|
+
"command": "npx",
|
|
68
|
+
"args": ["-y", "@perplexity-ai/mcp-server"],
|
|
69
|
+
"env": {
|
|
70
|
+
"PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
50
74
|
|
|
51
|
-
###
|
|
75
|
+
### 5. Advanced (Optional)
|
|
76
|
+
<details>
|
|
77
|
+
<summary>Show manual dependency setup and source install</summary>
|
|
78
|
+
|
|
79
|
+
Manual dependency setup:
|
|
52
80
|
```bash
|
|
53
|
-
#
|
|
54
|
-
npm install -g @anthropic-ai/claude-code
|
|
81
|
+
# jq
|
|
55
82
|
brew install jq # macOS
|
|
56
|
-
sudo apt-get install jq
|
|
83
|
+
sudo apt-get install -y jq # Ubuntu/Debian
|
|
84
|
+
sudo dnf install -y jq # Fedora/RHEL
|
|
85
|
+
sudo pacman -S --noconfirm jq # Arch
|
|
86
|
+
sudo apk add jq # Alpine
|
|
57
87
|
|
|
58
|
-
#
|
|
88
|
+
# mgrep
|
|
59
89
|
npm install -g @mixedbread/mgrep
|
|
60
90
|
mgrep install-claude-code
|
|
91
|
+
|
|
92
|
+
# tmux
|
|
61
93
|
brew install tmux # macOS
|
|
62
|
-
sudo apt-get install tmux
|
|
94
|
+
sudo apt-get install -y tmux # Ubuntu/Debian
|
|
95
|
+
sudo dnf install -y tmux # Fedora/RHEL
|
|
96
|
+
sudo pacman -S --noconfirm tmux # Arch
|
|
97
|
+
sudo apk add tmux # Alpine
|
|
63
98
|
```
|
|
64
99
|
|
|
65
|
-
|
|
100
|
+
Manual install from source:
|
|
66
101
|
```bash
|
|
67
102
|
git clone https://github.com/move-hoon/claude-pro-minmax.git
|
|
68
103
|
cd claude-pro-minmax
|
|
69
|
-
node bin/cpmm.js
|
|
104
|
+
node bin/cpmm.js setup
|
|
70
105
|
# advanced/debug path (same underlying installer):
|
|
71
106
|
# bash install.sh
|
|
72
107
|
```
|
|
73
108
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
```json
|
|
84
|
-
"perplexity": {
|
|
85
|
-
"command": "npx",
|
|
86
|
-
"args": ["-y", "@perplexity-ai/mcp-server"],
|
|
87
|
-
"env": {
|
|
88
|
-
"PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
> **Other included MCP servers (Enabled by default):**
|
|
94
|
-
> - **Sequential Thinking**: Powerful reasoning tool for complex logic.
|
|
95
|
-
> - **Context7**: Advanced documentation fetching and context management.
|
|
96
|
-
|
|
97
|
-
> **Note:** On first `cpmm install` (or `npx claude-pro-minmax@latest install`), CPMM backs up your existing `~/.claude` to `~/.claude.pre-cpmm`. Re-running install via `cpmm install` updates CPMM-managed files in-place while preserving your settings (`language.md`, `settings.local.json`, `skills/learned/`, `plans/`, etc.). (`cpmm install` invokes `install.sh` internally.)
|
|
98
|
-
|
|
99
|
-
### 6. Project Initialization
|
|
100
|
-
> **Tip:** Before running `claude`, initialize your project by referencing templates in this repository's `project-templates/` directory. (The installer does not copy `project-templates` into `~/.claude`.)
|
|
101
|
-
|
|
102
|
-
### 7. Verify Installation
|
|
103
|
-
```bash
|
|
104
|
-
cpmm setup --check
|
|
105
|
-
cpmm doctor
|
|
106
|
-
# or (no global install)
|
|
107
|
-
npx claude-pro-minmax@latest setup --check
|
|
108
|
-
npx claude-pro-minmax@latest doctor
|
|
109
|
-
```
|
|
109
|
+
Install behavior:
|
|
110
|
+
- `cpmm setup` installs missing dependencies, then configures CPMM (copies config files, language selection, Perplexity setup).
|
|
111
|
+
- `cpmm doctor` checks dependency status without modifying anything.
|
|
112
|
+
- Re-running `cpmm setup` updates CPMM-managed files in place and preserves user-owned files like `language.md`, `settings.local.json`, `skills/learned/`, and `sessions/`.
|
|
113
|
+
|
|
114
|
+
Project initialization tip:
|
|
115
|
+
- Before running `claude`, initialize your project with templates in `project-templates/` (not copied into `~/.claude`).
|
|
116
|
+
|
|
117
|
+
</details>
|
|
110
118
|
|
|
111
119
|
---
|
|
112
120
|
|
|
@@ -250,10 +258,16 @@ claude-pro-minmax
|
|
|
250
258
|
├── .claude.json # Global MCP Settings (User Scope)
|
|
251
259
|
├── .claudeignore # Files excluded from Claude's context
|
|
252
260
|
├── .gitignore # Git ignore rules
|
|
253
|
-
├──
|
|
261
|
+
├── CONTRIBUTING.md # Contribution guide
|
|
262
|
+
├── install.sh # Core installer (invoked by `cpmm setup`)
|
|
254
263
|
├── LICENSE # MIT License
|
|
255
264
|
├── README.md # English Documentation
|
|
256
265
|
├── README.ko.md # Korean Documentation
|
|
266
|
+
├── package.json # npm package manifest
|
|
267
|
+
├── bin/ # CPMM CLI entrypoints
|
|
268
|
+
│ ├── cpmm.js # `cpmm` executable entry
|
|
269
|
+
├── lib/ # CPMM CLI core implementation
|
|
270
|
+
│ └── cli.js # setup/doctor command logic
|
|
257
271
|
├── .claude/
|
|
258
272
|
│ ├── CLAUDE.md # Core Instructions (Loaded in all sessions)
|
|
259
273
|
│ ├── settings.json # Project Settings (Permissions, hooks, env vars)
|
|
@@ -399,7 +413,7 @@ This configuration is specifically designed for the Pro Plan's 5-hour rolling re
|
|
|
399
413
|
<details>
|
|
400
414
|
<summary><strong>Q: Does it conflict with existing Claude Code settings?</strong></summary>
|
|
401
415
|
|
|
402
|
-
A: On first `cpmm
|
|
416
|
+
A: On first `cpmm setup`, CPMM backs up your existing `~/.claude` to `~/.claude.pre-cpmm`. Re-running `cpmm setup` updates CPMM-managed files in place — your language settings, local config, learned patterns, and session history are preserved.
|
|
403
417
|
</details>
|
|
404
418
|
|
|
405
419
|
<details>
|