v1.4.0

🚀 CPMM v1.4.0 (Minor)

A Context7-focused release that aligns CPMM with the official Context7 Claude Code flow, removes conflicting repo-local Context7 behavior, and makes setup, verification, and current-doc lookup much clearer for users who opt in.

What Changed

CPMM now follows the official Context7 path:

• CPMM no longer ships a parallel repo-local Context7 docs layer.
• cpmm setup can now offer the full recommended official flow:
  • npm install -g ctx7
  • ctx7 setup --cli --claude
• This gives users both:
  • a shell-visible ctx7 CLI
  • the official Context7 Claude Code integration

Context7 verification is now clearer:

• cpmm doctor now checks Context7 in two parts:
  • ctx7 CLI binary presence
  • official Claude integration artifacts
• It reports:
  • ctx7 binary
  • Context7 skill (find-docs)
  • Context7 rule (context7.md)
• Partial installs now get explicit recovery guidance instead of ambiguous status:
  • re-run cpmm setup
  • or run the official commands directly

Legacy Context7 cleanup improved:

• If CPMM detects the old managed Context7 MCP entry in ~/.claude.json, setup now removes it.
• This prevents old repo-managed Context7 configuration from conflicting with the new official path.

Current-doc behavior is cleaner:

• After official setup, current library docs flow through Context7’s official Claude integration.
• /llms-txt remains available as the explicit raw-doc fallback when you want raw /llms.txt content or URL-based raw-doc lookup.

Documentation and built-in CPMM guidance were updated (EN/KO):

• README.md
• README.ko.md
• docs/USER-MANUAL.md
• docs/USER-MANUAL.ko.md

Claude command / skill guidance was also updated to reflect:

• official Context7 ownership
• the new verification model
• /llms-txt as the explicit fallback path

Why This Matters

Users now get a much cleaner Context7 experience:

• no more mismatch where official setup succeeds but ctx7 is missing from the shell
• no more split mental model between CPMM-managed docs behavior and official Context7 behavior
• cpmm setup, cpmm doctor, shell verification, and Claude-side behavior now point to the same installation model

CPMM keeps its original product boundary intact:

• Context7 remains optional
• CPMM does not make Context7 a default dependency
• users who do not opt into Context7 keep the same default CPMM behavior

Upgrade

npm i -g claude-pro-minmax@latest
cpmm setup
cpmm doctor

Optional Context7 Enablement

npm install -g ctx7
ctx7 setup --cli --claude
cpmm doctor

Recommended Verification

command -v ctx7
ctx7 --version
cpmm doctor

Compatibility Note

Users upgrading from v1.3.1 without Context7 enabled:

• default CPMM behavior remains unchanged

Users enabling Context7 on v1.4.0:

• cpmm setup now installs the ctx7 CLI and then runs the official Claude Code setup
• cpmm doctor now verifies both the CLI and the official integration separately
• current-doc lookup now follows the official Context7 path, with /llms-txt kept as the explicit raw fallback

v1.3.1

🚀 CPMM v1.3.1 (Patch)

A compatibility-focused RTK follow-up release that improves upgrade safety for existing users, restores managed hook state automatically, and tightens RTK guidance without changing CPMM’s opt-in policy.

What Changed

• RTK-enabled users now get safer cpmm setup behavior:

  • if RTK was already enabled before setup, CPMM now restores:
    • RTK hook order
    • RTK hook timeout: 10
  • this happens automatically after cpmm setup rewrites ~/.claude/settings.json

• RTK remains opt-in:

  • CPMM still does not enable the RTK hook by default
  • users who never enabled RTK stay on the same default CPMM behavior

• RTK hook management improved:

  • CPMM now normalizes RTK into the canonical slot:
    • CPMM critical-action safety hook first
    • RTK rewrite hook second
  • duplicate / drifted RTK hook entries are reconciled into one managed entry
  • if the RTK hook artifact is missing, CPMM attempts to restore it through RTK’s supported hook init flow

• cpmm doctor guidance improved:

  • still checks RTK binary presence
  • still checks whether the RTK hook is enabled
  • still verifies hook order
  • now gives clearer recovery guidance when RTK timeout is missing or drifted:
    • re-run cpmm setup

• Documentation updated (EN/KO):

  • clarified that RTK is about Bash command-output filtering
  • clarified that the quota effect is reducing noisy command output before it expands Claude input context
  • updated upgrade / activation guidance in:
    • README.md
    • README.ko.md
    • docs/USER-MANUAL.md
    • docs/USER-MANUAL.ko.md

Why This Matters

• Existing v1.3.0 users who already opted into RTK now get a much safer upgrade path.
• CPMM no longer leaves RTK-enabled users to manually re-fix hook order and timeout after setup rewrites managed settings.
• CPMM keeps its original product boundary intact:
  • RTK is still optional
  • CPMM safety hook still comes first
  • Bash-heavy workflows get a cleaner, more stable integration path

Upgrade

npm i -g claude-pro-minmax@latest
cpmm setup
cpmm doctor

Optional RTK Enablement

rtk init -g --hook-only
cpmm setup
cpmm doctor

Managed Hook Order

{
  "type": "command",
  "command": "~/.claude/scripts/hooks/critical-action-check.sh",
  "timeout": 5
}
{
  "type": "command",
  "command": "~/.claude/hooks/rtk-rewrite.sh",
  "timeout": 10
}

Compatibility Note

• v1.3.0 users without RTK enabled:
  • behavior remains unchanged
• v1.3.0 users with RTK enabled:
  • cpmm setup now restores the managed RTK hook order and timeout automatically

v1.3.0

🚀 CPMM v1.3.0 (Minor)

An RTK-ready release focused on Bash-heavy output reduction, safer hook composition, and clearer setup/doctor guidance without changing CPMM’s default-on behavior.

What Changed

• Optional RTK integration added:

  • cpmm setup now attempts to install rtk when supported
  • RTK remains opt-in — CPMM does not enable the RTK hook by default
  • Supported auto-install path:
    • brew install rtk
    • upstream curl installer fallback

• CLI cpmm doctor expanded for RTK health checks:

  • Detects whether the rtk binary is installed
  • Detects whether the RTK hook is enabled
  • Verifies CPMM’s safety hook runs before the RTK rewrite hook
  • Warns when RTK hook timeout is missing or not set to 10
  • Keeps RTK integration optional:
    • missing RTK binary = advisory
    • missing RTK hook = advisory
    • wrong hook order = fail

• Install / update UX improved:

  • cpmm setup now prints RTK activation guidance after install
  • Update flow detects prior RTK hook usage and reminds users to re-check:
    • hook order
    • timeout
    • cpmm doctor

• Documentation updated (EN/KO):

  • README now surfaces RTK more clearly in the top-level value proposition
  • Added RTK guidance to:
    • README.md
    • README.ko.md
    • docs/USER-MANUAL.md
    • docs/USER-MANUAL.ko.md
    • scripts/hooks/README.md
    • scripts/hooks/README.ko.md
  • Recommended activation flow:
    • rtk init -g --hook-only
    • cpmm doctor

Why This Matters

• CPMM now officially supports RTK as a first-class optional integration for Bash-heavy workflows.
• Users can reduce Bash command noise before it enters Claude context while preserving CPMM’s safety-first hook ordering.
• cpmm doctor now catches the most important RTK integration mistake:
  • RTK rewrite running before CPMM’s critical-action safety check
• The release keeps CPMM’s identity intact:
  • model routing
  • output control
  • local safety rails
  • with RTK as an optional optimization layer

Upgrade

npm i -g claude-pro-minmax@latest
cpmm setup
cpmm doctor

Optional RTK Enablement

rtk init -g --hook-only
cpmm doctor

Recommended Hook Order

{
  "type": "command",
  "command": "~/.claude/scripts/hooks/critical-action-check.sh",
  "timeout": 5
}
{
  "type": "command",
  "command": "~/.claude/hooks/rtk-rewrite.sh",
  "timeout": 10
}

v1.2.1

🚀 CPMM v1.2.1 (Patch)

A documentation clarity + CLI UX polish update focused on reducing installation friction and improving diagnostic output.

What Changed

• CLI cpmm doctor output redesigned:

  • claude separated into Prerequisite category (distinct from Dependencies)
  • Missing prerequisite shows ⚠ warning with native install hint (curl -fsSL https://claude.ai/install.sh | bash)
  • Dependencies section retains existing ✓/✗ icons with [required]/[optional] tags
  • Colorized output (✓ green, ⚠ yellow, ✗ red) for better terminal readability

• README installation section restructured (EN/KO):

  • Perplexity/language settings moved from standalone section into collapsed Advanced (Optional)
  • Clarified Perplexity is not required — /dplan still works via Sequential Thinking + Context7
  • Customization & Update Policy with 2-Layer directory tree now always visible (not collapsed)
  • Added missing plans/ and projects/ to user-owned preserved paths
  • Fixed FAQ reference from outdated "table" to "2-Layer structure"

Why This Matters

• New users no longer see Perplexity setup as a blocker — essential install flow is 3 commands and done
• cpmm doctor clearly distinguishes "you need Claude Code first" from "CPMM can fix this for you"
• 2-Layer structure (Global Baseline vs Project-Specific) is immediately visible, reducing misconfiguration risk

Upgrade

npm i -g claude-pro-minmax@latest
cpmm setup
cpmm doctor

v1.2.0

🚀 CPMM v1.2.0 (Minor)

A simplification + release-hardening update focused on one-command setup and safer npm packaging.

⚠️ Breaking Changes

• cpmm install was removed. Use cpmm setup.
• Legacy setup flags were removed: --check, --fix, --yes, --json.
• Running cpmm with no command now defaults to setup.

What Changed

• CLI architecture simplified:

  • bin/cpmm.js is now a thin entrypoint
  • core logic moved to lib/cli.js
  • removed legacy bin/dependency-policy.js

• Dependency policy simplified and unified:

  • Required: jq, mgrep, tmux
  • Optional: claude (assumed pre-installed)

• cpmm setup flow unified:

  1. installs missing required dependencies
  2. runs install.sh to configure CPMM files (language/Perplexity prompt on fresh interactive installs)

• cpmm doctor is dependency-only and provides clear remediation (Fix: cpmm setup)

• npm publish hardening:

  • bumped package.json version to 1.2.0
  • tightened files allowlist
  • includes required runtime files (bin/, lib/, .claude.json, install.sh)

• Docs sync (EN/KO):

  • README / README.ko aligned with current runtime behavior
  • project tree updated to reflect lib/cli.js
  • Node.js >=18 badge added

Why This Matters

• One clear setup path (cpmm setup) with fewer edge cases
• Smaller, easier-to-maintain CLI surface
• Better npm package safety (reduced local artifact leakage risk)

Upgrade / Migration

npm i -g claude-pro-minmax@latest
cpmm setup
cpmm doctor

Migration mapping:

• cpmm install → cpmm setup
• remove usage of --check, --fix, --yes, --json

v1.1.0

🚀 CPMM v1.1.0 (Minor)

A reliability + usability release focused on dependency checks and installer hardening.

What Changed

• New dependency policy layer (bin/dependency-policy.js)

  • Centralized required/optional rules for all checks and fixes
  • Required: claude, jq
  • Optional: mgrep, tmux

• cpmm setup / cpmm doctor contract cleanup

  • Shared policy-driven checks (no duplicated logic)
  • Consistent output + exit behavior
  • Better remediation guidance for macOS/Linux
  • Supports --check, --fix, --yes, --json

• Installer hardening (install.sh)

  • Blocks unsupported invocations (curl | bash, process substitution)
  • On update, auto-restores missing ~/.claude.json
  • Recreates missing ~/.mcp.json -> ~/.claude.json symlink
  • Improved legacy flow when marker is missing (clearer backup/in-place behavior)

• Docs sync (EN/KO)

  • Canonical install/update flow unified:
    • cpmm install (global)
    • npx claude-pro-minmax@latest install (no global install)
  • Backup semantics (~/.claude.pre-cpmm) and ownership boundary documented

Why This Matters

• Dependency checks are now predictable, scriptable, and easier to auto-fix.
• Update runs can self-heal common MCP config deletion cases.
• Installer behavior is safer in unsupported execution contexts.
• Docs now match actual runtime behavior.

Upgrade

npx claude-pro-minmax@latest install
npx claude-pro-minmax@latest setup --check
npx claude-pro-minmax@latest doctor
# or
npm i -g claude-pro-minmax@latest && cpmm install

v1.0.2

🚀 CPMM v1.0.2 (Patch)

A hardening patch for the Node.js runtime adapter — fixing CWD safety, error visibility, and
unintended side effects.

What Changed

• Node adapter: subshell isolation — all adapter functions now run inside ( cd "$PROJECT_DIR" ... )
  subshells
  • Prevents adapter_clean() from deleting files in the wrong directory
  • Prevents npx eslint ., prettier --write . from targeting wrong CWD
• Node adapter: error visibility — replaced 2>/dev/null with 2>&1 across all commands
  • Claude Code can now see tsc/eslint/test error messages instead of silent swallow
• Node adapter: no unintended installs — all npx calls now use --no-install flag
  • Prevents automatic package downloads in non-interactive environments
• Node adapter: accurate script detection — _has_script() upgraded to jq-based lookup (grep
  fallback)
  • Searches .scripts section only, avoiding false positives from dependencies
• Misc: fixed adapter_clean echo missing .nuxt, .output, .turbo
• Version bump: package.json → 1.0.2

Why This Matters

• Users with CLAUDE_PROJECT_DIR set no longer risk rm -rf hitting the wrong directory.
• Verify results are no longer silently swallowed — Claude can read and act on actual errors.
• No surprise npx package installations during automated verification flows.

Upgrade

npx -y claude-pro-minmax@latest install
# or
npm i -g claude-pro-minmax && cpmm install

v1.0.1

🚀 CPMM v1.0.1 (Patch)

A reliability-focused patch release for installation flow + npm visibility.

What Changed

• Installer fix: graceful skip for Perplexity setup when jq is missing
  • Prevents set -e early exit during install
  • Installation now completes, with a clear warning to configure Perplexity later
• Installer cleanup: removed ineffective .claudeignore copy into ~/.claude
• Docs: added npm badges to both READMEs
  • npm version
  • npm monthly downloads
• Version bump: package.json → 1.0.1

Why This Matters

• Users without jq no longer experience “partial install then fail” behavior.
• Cleaner install behavior with fewer confusing side effects.
• Better package trust/discoverability via npm metadata in README.

Upgrade

npx -y claude-pro-minmax@latest install
# or
npm i -g claude-pro-minmax && cpmm install

v1.0.0

🚀 CPMM v1.0.0 — Initial Public Release

CPMM (Claude Pro MinMax) is a quota-first execution layer for Claude Code.

Built from direct experimentation:

• Same task
• Same prompt
• Same turn count

Observed result: Haiku ~1% quota vs Opus ~18% quota (about 18x spread).
CPMM enforces cheapest-first routing to reduce silent quota drain.

---

Prerequisites

npm install -g @anthropic-ai/claude-code
brew install jq                              # required
brew install tmux                            # optional: required for /watch
npm install -g @mixedbread/mgrep            # optional: output reduction
mgrep install-claude-code

Installation

# Recommended
npx -y claude-pro-minmax@latest install

# Global install
npm install -g claude-pro-minmax
cpmm install

# curl
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/move-hoon/claude-pro-minmax/main/install.sh)"

The installer will:

• Back up existing ~/.claude automatically (~/.claude-backup-{timestamp})
• Prompt for Perplexity API key (optional)
• Prompt for output language (English / Korean / Japanese / Chinese)

Verify installation:

cpmm doctor
# or
npx -y claude-pro-minmax@latest doctor

---

Key Features

🧠 Model Routing Commands

Command	Description
/do	Executes in current session model with atomic rollback on failure
/do-sonnet	Escalate to Sonnet when Haiku is blocked
/do-opus	Escalate to Opus for maximum reasoning
/plan	Sonnet designs architecture, Haiku implements
/plan --no-build	Architecture planning only, no implementation
/dplan	Deep planning with Sequential Thinking + Perplexity + Context7
/review	Read-only review for security, type safety, performance, logic

🛡 Local Safety Hooks (11 hooks)

Hook	Trigger	Purpose
critical-action-check	PreToolUse	Blocks dangerous commands (force push, DROP TABLE, rm -rf)
readonly-check	PreToolUse	Blocks write/edit in read-only mode
retry-check	PreToolUse	Enforces retry cap, recommends escalation
post-edit-format	PostToolUse	Auto-format after edits
pre-compact	PreCompact	Saves session state before compaction
compact-suggest	PostToolUse	Progressive warnings for context growth
tool-failure-log	PostToolUse	Logs failures and recommends escalation
stop-collect-context	PostToolUse	Collects context on tool failure
session-start	SessionStart	Loads env and shows quota guidance
session-cleanup	SessionEnd	Saves summary + scrubs secrets
notification	Notification	Desktop alerts for prompts/idle

📋 Always-Loaded Rules

Rule	Purpose
critical-actions.md	HITL confirmation for dangerous actions
security.md	No hardcoded secrets, parameterized queries, input validation
code-style.md	Style and maintainability guardrails

⚙ Runtime Adapter

• Auto-detects JVM / Node.js / Go / Rust / Python via detect.sh
• Unified verify.sh interface (avoid direct framework-specific test commands)
• Language-specific format/test adapters via scripts/runtime/adapters/*

🤖 Agents

Agent	Model	Role
@planner	Sonnet 4.6	Architecture planning
@dplanner	Sonnet 4.6	Deep planning with MCP tools
@builder	Haiku 4.5	Implementation
@reviewer	Haiku 4.5	Read-only code review

🔌 Bundled MCP Servers

Server	Purpose
Sequential Thinking	Structured reasoning
Context7	Documentation fetching/context
Perplexity	Real-time web research (API key required)

🔧 Utility Commands

Command	Description
/session-save	Save session with secret scrubbing
/session-load	Restore prior session context
/watch	Monitor long-running processes via tmux
/load-context	Load backend/frontend context templates
/compact-phase	Phase-based context pruning
/learn	Persist useful session patterns
/analyze-failures	Analyze recurring tool failures
/llms-txt	Fetch llms.txt docs

🛠 CLI

npx -y claude-pro-minmax@latest install
cpmm doctor

---

Quick Start

npx -y claude-pro-minmax@latest install

Then inside your project:

/model haiku
/do Fix the null check in utils.ts and add a regression test.

---

Links

• 📖 README
• 📘 User Manual
• 📊 Experiment Data