@kaitranntt/ccs 2.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CCS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,287 @@
+# CCS - Claude Code Switch
+
+<div align="center">
+
+![CCS Logo](docs/assets/ccs-logo-medium.png)
+
+**One command, zero downtime, right model for each task**
+
+Switch between Claude Sonnet 4.5 and GLM 4.6 instantly. Stop hitting rate limits. Start optimizing costs.
+
+
+[![License](https://img.shields.io/badge/license-MIT-C15F3C?style=for-the-badge)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)]()
+[![npm](https://img.shields.io/npm/v/@kai/ccs?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@kai/ccs)
+[![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN)
+
+**Languages**: [English](README.md) | [Tiếng Việt](README.vi.md)
+
+</div>
+
+---
+
+## 🚀 Quick Start
+
+### 🔑 Prerequisites
+
+**Before installing CCS, make sure you're logged into Claude CLI with your subscription account:**
+```bash
+claude /login
+```
+
+### Primary Installation Methods
+
+#### Option 1: npm Package (Recommended)
+
+**macOS / Linux / Windows**
+```bash
+npm install -g @kai/ccs
+```
+
+Compatible with npm, yarn, pnpm, and bun package managers.
+
+#### Option 2: Direct Install (Traditional)
+
+**macOS / Linux**
+```bash
+curl -fsSL ccs.kaitran.ca/install | bash
+```
+
+**Windows PowerShell**
+```powershell
+irm ccs.kaitran.ca/install | iex
+```
+
+### Your First Switch
+
+```bash
+# Use Claude subscription (default)
+ccs "Review this architecture design"
+
+# Switch to GLM for cost-optimized tasks
+ccs glm "Create a simple REST API"
+
+# Use GLM for all subsequent commands until switched back
+ccs glm
+ccs "Debug this issue"
+ccs "Write unit tests"
+```
+
+#### Package Manager Options
+
+All major package managers are supported:
+
+```bash
+# npm (default)
+npm install -g @kai/ccs
+
+# yarn
+yarn global add @kai/ccs
+
+# pnpm (70% less disk space)
+pnpm add -g @kai/ccs
+
+# bun (30x faster)
+bun add -g @kai/ccs
+```
+
+### Configuration (Auto-created)
+
+**~/.ccs/config.json**:
+```json
+{
+  "profiles": {
+    "glm": "~/.ccs/glm.settings.json",
+    "default": "~/.claude/settings.json"
+  }
+}
+```
+
+### Custom Claude CLI Path
+
+If Claude CLI is installed in a non-standard location (D drive, custom directory), set `CCS_CLAUDE_PATH`:
+
+```bash
+export CCS_CLAUDE_PATH="/path/to/claude"              # Unix
+$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe"   # Windows
+```
+
+**See [Troubleshooting Guide](./docs/troubleshooting.md#claude-cli-in-non-standard-location) for detailed setup instructions.**
+
+---
+
+## The Daily Developer Pain Point
+
+You have both Claude subscription and GLM Coding Plan. Two scenarios happen every day:
+
+1. **Rate Limits Hit**: Claude stops mid-project → you manually edit `~/.claude/settings.json`
+2. **Cost Waste**: Simple tasks use expensive Claude → GLM would work fine
+
+Manual switching breaks your flow. **CCS fixes it instantly**.
+
+## Why CCS Instead of Manual Switching?
+
+<div align="center">
+
+| Feature | Benefit | Emotional Value |
+|---------|---------|-----------------|
+| **Instant Switching** | One command, no file editing | Confidence, control |
+| **Zero Downtime** | Never interrupt your workflow | Reliability, consistency |
+| **Smart Delegation** | Right model for each task automatically | Simplicity, ease |
+| **Cost Control** | Use expensive models only when needed | Efficiency, savings |
+| **Cross-Platform** | Works on macOS, Linux, Windows | Flexibility, portability |
+| **Reliable** | Pure bash/PowerShell, zero dependencies | Trust, peace of mind |
+
+</div>
+
+**The Solution**:
+```bash
+ccs           # Use Claude subscription (default)
+ccs glm       # Switch to GLM fallback
+# Hit rate limit? Switch instantly:
+ccs glm       # Continue working with GLM
+```
+
+One command. Zero downtime. No file editing. Right model, right task.
+
+---
+
+## 🏗️ Architecture Overview
+
+```mermaid
+graph LR
+    subgraph "User Command"
+        CMD[ccs glm]
+    end
+
+    subgraph "CCS Processing"
+        CONFIG[Read ~/.ccs/config.json]
+        LOOKUP[Lookup profile → settings file]
+        VALIDATE[Validate file exists]
+    end
+
+    subgraph "Claude CLI"
+        EXEC[claude --settings file_path]
+    end
+
+    subgraph "API Response"
+        API[Claude Sub or GLM API]
+    end
+
+    CMD --> CONFIG
+    CONFIG --> LOOKUP
+    LOOKUP --> VALIDATE
+    VALIDATE --> EXEC
+    EXEC --> API
+```
+
+---
+
+## ⚡ Features
+
+### Instant Profile Switching
+- **One Command**: `ccs glm` to switch to GLM, `ccs` to use Claude subscription - no config file editing
+- **Smart Detection**: Automatically uses right model for each task
+- **Persistent**: Switch stays active until changed again
+
+### Zero Workflow Interruption
+- **No Downtime**: Switching happens instantly between commands
+- **Context Preservation**: Your workflow remains uninterrupted
+- **Seamless Integration**: Works exactly like native Claude CLI
+
+### Task Delegation
+
+> **🚧 Work in Progress**: This feature is experimental and not fully tested. Use with caution.
+
+CCS includes intelligent task delegation via the `/ccs` meta-command:
+
+**Install CCS commands:**
+```bash
+ccs --install    # Install /ccs command to Claude CLI
+```
+
+**Use task delegation:**
+```bash
+# After running ccs --install, you can use:
+/ccs glm /plan "add user authentication"
+/ccs glm /code "implement auth endpoints"
+/ccs glm /ask "explain this error"
+```
+
+**Remove when not needed:**
+```bash
+ccs --uninstall  # Remove /ccs command from Claude CLI
+```
+
+**Benefits**:
+- ✅ Save tokens by delegating simple tasks to cheaper models
+- ✅ Use right model for each task automatically
+- ✅ Seamless integration with existing workflows
+- ✅ Clean installation and removal when needed
+
+---
+
+## 💻 Usage Examples
+
+```bash
+ccs              # Use Claude subscription (default)
+ccs glm          # Use GLM fallback
+ccs --version    # Show CCS version and install location
+ccs --install    # Install CCS commands and skills to ~/.claude/
+ccs --uninstall  # Remove CCS commands and skills from ~/.claude/
+```
+
+---
+
+### 🗑️ Uninstall
+
+**macOS / Linux**:
+```bash
+curl -fsSL ccs.kaitran.ca/uninstall | bash
+```
+
+**Windows PowerShell**:
+```powershell
+irm ccs.kaitran.ca/uninstall | iex
+```
+
+---
+
+## 🎯 Philosophy
+
+- **YAGNI**: No features "just in case"
+- **KISS**: Simple bash, no complexity
+- **DRY**: One source of truth (config)
+
+---
+
+## 📖 Documentation
+
+**Complete documentation in [docs/](./docs/)**:
+- [Installation Guide](./docs/installation.md)
+- [Configuration](./docs/configuration.md)
+- [Usage Examples](./docs/usage.md)
+- [Troubleshooting](./docs/troubleshooting.md)
+- [Contributing](./docs/contributing.md)
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](./docs/contributing.md) for details.
+
+---
+
+## 📄 License
+
+CCS is licensed under the [MIT License](LICENSE).
+
+---
+
+<div align="center">
+
+**Made with ❤️ for developers who hit rate limits too often**
+
+[⭐ Star this repo](https://github.com/kaitranntt/ccs) | [🐛 Report issues](https://github.com/kaitranntt/ccs/issues) | [📖 Read docs](./docs/)
+
+</div>

package/README.vi.md

@@ -0,0 +1,257 @@
+# CCS - Claude Code Switch
+
+<div align="center">
+
+![CCS Logo](docs/assets/ccs-logo-medium.png)
+
+**Một lệnh, không downtime, đúng model cho từng tác vụ**
+
+Chuyển đổi giữa Claude Sonnet 4.5 và GLM 4.6 ngay lập tức. Ngừng hitting rate limits. Bắt đầu tối ưu chi phí.
+
+
+[![License](https://img.shields.io/badge/license-MIT-C15F3C?style=for-the-badge)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)]()
+[![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN)
+
+**Ngôn ngữ**: [English](README.md) | [Tiếng Việt](README.vi.md)
+
+</div>
+
+---
+
+## 🚀 Bắt Đầu Nhanh
+
+### 🔑 Điều Kiện Tiên Quyết
+
+**Trước khi cài đặt CCS, hãy đảm bảo bạn đã đăng nhập vào Claude CLI với tài khoản subscription:**
+```bash
+claude /login
+```
+
+### Phương Pháp Cài Đặt Chính
+
+**macOS / Linux**
+```bash
+curl -fsSL ccs.kaitran.ca/install | bash
+```
+
+**Windows PowerShell**
+```powershell
+irm ccs.kaitran.ca/install | iex
+```
+
+### Lần Chuyển Đổi Đầu Tiên
+
+```bash
+# Dùng Claude subscription (mặc định)
+ccs "Review thiết kế kiến trúc này"
+
+# Chuyển sang GLM cho tác vụ tối ưu chi phí
+ccs glm "Tạo REST API đơn giản"
+
+# Dùng GLM cho tất cả lệnh tiếp theo cho đến khi chuyển lại
+ccs glm
+ccs "Debug issue này"
+ccs "Viết unit tests"
+```
+
+### Cấu Hình (Tự Tạo)
+
+**~/.ccs/config.json**:
+```json
+{
+  "profiles": {
+    "glm": "~/.ccs/glm.settings.json",
+    "default": "~/.claude/settings.json"
+  }
+}
+```
+
+### Đường Dẫn Claude CLI Tùy Chỉnh
+
+Nếu Claude CLI được cài đặt ở vị trí không chuẩn (ổ D, thư mục tùy chỉnh), đặt `CCS_CLAUDE_PATH`:
+
+```bash
+export CCS_CLAUDE_PATH="/path/to/claude"              # Unix
+$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe"   # Windows
+```
+
+**Xem [Hướng dẫn Khắc phục Sự cố](./docs/vi/troubleshooting.vi.md#claude-cli-ở-vị-trí-không-chuẩn) để biết chi tiết cài đặt.**
+
+---
+
+## Điểm Đau Hàng Ngày Của Lập Trình Viên
+
+Bạn có cả Claude subscription và GLM Coding Plan. Hai tình huống xảy ra hàng ngày:
+
+1. **Hết Rate Limit**: Claude dừng giữa chừng project → bạn phải tự tay sửa `~/.claude/settings.json`
+2. **Lãng Phí Chi Phí**: Tác vụ đơn giản dùng Claude đắt tiền → GLM cũng làm tốt
+
+Chuyển đổi thủ công làm gián đoạn workflow của bạn. **CCS khắc phục ngay lập tức**.
+
+## Tại Sao CCS Thay Vì Chuyển Đổi Thủ Công?
+
+<div align="center">
+
+| Tính năng | Lợi ích | Giá trị cảm xúc |
+|-----------|---------|-----------------|
+| **Chuyển đổi tức thì** | Một lệnh, không sửa file | Tự tin, kiểm soát |
+| **Không downtime** | Không bao giờ gián đoạn workflow | Đáng tin cậy, nhất quán |
+| **Delegation thông minh** | Đúng model cho từng tác vụ tự động | Đơn giản, dễ dàng |
+| **Kiểm soát chi phí** | Dùng model đắt tiền chỉ khi cần | Hiệu quả, tiết kiệm |
+| **Đa nền tảng** | Hoạt động trên macOS, Linux, Windows | Linh hoạt, di động |
+| **Đáng tin cậy** | Bash/PowerShell thuần, không dependencies | Tin tưởng, an tâm |
+
+</div>
+
+**Giải pháp**:
+```bash
+ccs           # Dùng Claude subscription (mặc định)
+ccs glm       # Chuyển sang GLM fallback
+# Hết rate limit? Chuyển ngay:
+ccs glm       # Tiếp tục làm việc với GLM
+```
+
+Một lệnh. Không downtime. Không phải sửa file. Đúng model, đúng việc.
+
+---
+
+## 🏗️ Tổng Quan Kiến Trúc
+
+```mermaid
+graph LR
+    subgraph "Lệnh Người Dùng"
+        CMD[ccs glm]
+    end
+
+    subgraph "Xử Lý CCS"
+        CONFIG[Đọc ~/.ccs/config.json]
+        LOOKUP[Tìm profile → file settings]
+        VALIDATE[Kiểm tra file tồn tại]
+    end
+
+    subgraph "Claude CLI"
+        EXEC[claude --settings file_path]
+    end
+
+    subgraph "Phản Hồi API"
+        API[Claude hoặc GLM API]
+    end
+
+    CMD --> CONFIG
+    CONFIG --> LOOKUP
+    LOOKUP --> VALIDATE
+    VALIDATE --> EXEC
+    EXEC --> API
+```
+
+---
+
+## ⚡ Tính Năng
+
+### Chuyển Profile Ngay Lập Tức
+- **Một Lệnh**: `ccs glm` để chuyển sang GLM, `ccs` để dùng Claude subscription - không cần sửa file config
+- **Phát Hiện Thông Minh**: Tự động dùng đúng model cho từng tác vụ
+- **Liên Tục**: Chuyển đổi hoạt động cho đến khi thay đổi lại
+
+### Không Gián Đoạn Workflow
+- **Không Downtime**: Chuyển đổi xảy ra ngay lập tức giữa các lệnh
+- **Bảo Toàn Context**: Workflow của bạn không bị gián đoạn
+- **Tích Hợp Liền Mạch**: Hoạt động chính xác như Claude CLI native
+
+### Delegation Tác Vụ
+
+> **🚧 Đang phát triển**: Tính năng này đang trong giai đoạn thử nghiệm và chưa được kiểm tra đầy đủ. Sử dụng với cẩn thận.
+
+CCS bao gồm delegation tác vụ thông minh qua meta-command `/ccs`:
+
+**Cài đặt lệnh CCS:**
+```bash
+ccs --install    # Cài đặt lệnh /ccs vào Claude CLI
+```
+
+**Sử dụng delegation tác vụ:**
+```bash
+# Sau khi chạy ccs --install, bạn có thể dùng:
+/ccs glm /plan "add user authentication"
+/ccs glm /code "implement auth endpoints"
+/ccs glm /ask "explain this error"
+```
+
+**Gỡ bỏ khi không cần:**
+```bash
+ccs --uninstall  # Gỡ bỏ lệnh /ccs khỏi Claude CLI
+```
+
+**Lợi ích**:
+- ✅ Tiết kiệm tokens bằng cách delegation tác vụ đơn giản cho model rẻ hơn
+- ✅ Dùng đúng model cho từng tác vụ tự động
+- ✅ Tích hợp liền mạch với workflows hiện có
+- ✅ Cài đặt và gỡ bỏ sạch sẽ khi cần
+
+---
+
+## 💻 Ví Dụ Sử Dụng
+
+```bash
+ccs              # Dùng Claude subscription (mặc định)
+ccs glm          # Dùng GLM fallback
+ccs --version    # Hiển thị phiên bản CCS và vị trí cài đặt
+ccs --install    # Cài đặt lệnh và kỹ năng CCS vào ~/.claude/
+ccs --uninstall  # Gỡ bỏ lệnh và kỹ năng CCS khỏi ~/.claude/
+```
+
+---
+
+### 🗑️ Gỡ Cài Đặt
+
+**macOS / Linux**:
+```bash
+curl -fsSL ccs.kaitran.ca/uninstall | bash
+```
+
+**Windows PowerShell**:
+```powershell
+irm ccs.kaitran.ca/uninstall | iex
+```
+
+---
+
+## 🎯 Triết Lý
+
+- **YAGNI**: Không có tính năng "phòng hờ"
+- **KISS**: Bash đơn giản, không phức tạp
+- **DRY**: Một nguồn chân lý duy nhất (config)
+
+---
+
+## 📖 Tài Liệu
+
+**Tài liệu đầy đủ trong [docs/](./docs/)**:
+- [Hướng dẫn Cài đặt](./docs/vi/installation.vi.md)
+- [Cấu hình](./docs/vi/configuration.vi.md)
+- [Ví dụ Sử dụng](./docs/vi/usage.vi.md)
+- [Khắc phục Sự cố](./docs/vi/troubleshooting.vi.md) 
+- [Đóng góp](./docs/vi/contributing.vi.md)
+
+---
+
+## 🤝 Đóng Góp
+
+Chúng tôi chào mừng đóng góp! Xem [Hướng dẫn Đóng góp](./docs/contributing.md) để biết chi tiết.
+
+---
+
+## 📄 Giấy Phép
+
+CCS được cấp phép theo [Giấy phép MIT](LICENSE).
+
+---
+
+<div align="center">
+
+**Được tạo với ❤️ cho những lập trình viên hay hết rate limit**
+
+[⭐ Star repo này](https://github.com/kaitranntt/ccs) | [🐛 Báo cáo vấn đề](https://github.com/kaitranntt/ccs/issues) | [📖 Đọc tài liệu](./docs/)
+
+</div>

package/VERSION

@@ -0,0 +1 @@
+2.4.0