@daylenjeez/ccm-switch 1.2.0

package/README.md

@@ -0,0 +1,195 @@
+<div align="center">
+
+# ccm
+
+**Claude Code Model Switcher**
+
+Switch Claude Code custom model configurations from the terminal in seconds.
+
+[![npm version](https://img.shields.io/npm/v/@daylenjeez/ccm-switch.svg?style=flat-square)](https://www.npmjs.com/package/@daylenjeez/ccm-switch)
+[![license](https://img.shields.io/npm/l/@daylenjeez/ccm-switch.svg?style=flat-square)](https://github.com/daylenjeez/ccm-switch/blob/main/LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://nodejs.org)
+
+[中文文档](./README.zh-CN.md) | English
+
+[Install](#-install) · [Quick Start](#-quick-start) · [Commands](#-commands) · [How It Works](#%EF%B8%8F-how-it-works)
+
+</div>
+
+---
+
+## ✨ Highlights
+
+- 🔌 **cc-switch Integration** — Reads [cc-switch](https://github.com/farion1231/cc-switch) database directly, zero migration
+- 🧙 **Interactive Wizard** — `ccm add` guides you step by step, type `<` to go back
+- ⚡ **One-command Switch** — `ccm use OpenRouter` or `ccm ls` with arrow keys
+- 🛡️ **Safe Switching** — Preserves `language`, `permissions` and other personal settings
+- 🚀 **Zero Config** — Just `ccm init` and follow the prompts, no docs needed
+- 🌍 **i18n** — English / 中文 (`ccm locale set en/zh`)
+
+## 📦 Install
+
+```bash
+npm install -g @daylenjeez/ccm-switch
+```
+
+Or build from source:
+
+```bash
+git clone git@github.com:daylenjeez/ccm-switch.git
+cd ccm && npm install && npm run build && npm link
+```
+
+## 🚀 Quick Start
+
+```bash
+ccm init   # Auto-detects cc-switch or initializes standalone mode
+ccm add    # Interactive wizard to add a provider
+```
+
+> **Without ccm**: Manually edit `~/.claude/settings.json`, copy-paste API keys, restart, hope the JSON isn't broken.
+> **With ccm**: `ccm use OpenRouter` — done.
+
+## 🔌 cc-switch Integration
+
+Already using [cc-switch](https://github.com/farion1231/cc-switch)? ccm reads its SQLite database directly:
+
+```bash
+$ ccm init
+cc-switch detected. Import configurations from it? (Y/n)
+✓ Initialized in cc-switch mode
+✓ Imported 4 configurations
+Active: OpenRouter
+```
+
+All configs sync both ways — add in ccm, see it in cc-switch UI, and vice versa.
+
+## ➕ Adding Configurations
+
+### Interactive wizard (recommended)
+
+```bash
+$ ccm add
+Provider name (e.g. OpenRouter): OpenRouter
+
+Choose how to add:
+  1) Step by step     # guided prompts, type < to go back
+  2) Write JSON       # opens $EDITOR
+
+ANTHROPIC_BASE_URL: https://openrouter.ai/api/v1
+ANTHROPIC_AUTH_TOKEN: sk-or-xxx
+ANTHROPIC_MODEL: anthropic/claude-opus-4.6
+ANTHROPIC_DEFAULT_OPUS_MODEL (optional):
+ANTHROPIC_DEFAULT_SONNET_MODEL (optional):
+ANTHROPIC_DEFAULT_HAIKU_MODEL (optional):
+
+✓ Saved configuration "OpenRouter"
+Switch to this configuration now? (Y/n)
+```
+
+### Edit JSON directly
+
+<details>
+<summary>Standalone mode: <code>~/.ccm/config.json</code></summary>
+
+```json
+{
+  "profiles": {
+    "OpenRouter": {
+      "env": {
+        "ANTHROPIC_BASE_URL": "https://openrouter.ai/api/v1",
+        "ANTHROPIC_AUTH_TOKEN": "sk-or-...",
+        "ANTHROPIC_MODEL": "anthropic/claude-opus-4.6"
+      }
+    }
+  }
+}
+```
+</details>
+
+Aliases are stored in `~/.ccm/rc.json`:
+
+```json
+{
+  "aliases": {
+    "or": "OpenRouter"
+  }
+}
+```
+
+## 📖 Commands
+
+### Core
+
+| Command | Alias | Description |
+|---|---|---|
+| `ccm init` | | Initialize, auto-detect cc-switch |
+| `ccm list` | `ls` | Interactive list & switch |
+| `ccm use <name>` | | Switch by name |
+| `ccm add` | `new` | Interactive add wizard |
+| `ccm save <name>` | | Save current settings as profile |
+| `ccm show [name]` | | View config details |
+| `ccm modify [name]` | `edit` | Edit existing configuration |
+| `ccm remove [name]` | `rm` | Interactive or named delete |
+| `ccm current` | | Show active configuration |
+| `ccm config` | | Switch storage mode |
+
+### Aliases
+
+| Command | Description |
+|---|---|
+| `ccm alias set <short> <name>` | Create alias, e.g. `ccm alias set or OpenRouter` |
+| `ccm alias rm <short>` | Remove alias |
+| `ccm alias list` / `ls` | List all aliases |
+
+```bash
+ccm alias set or OpenRouter
+ccm use or  # same as: ccm use OpenRouter
+```
+
+### Locale
+
+| Command | Description |
+|---|---|
+| `ccm locale` / `ls` | List & switch language |
+| `ccm locale set <lang>` | Set language (`zh` / `en`) |
+
+### Examples
+
+```bash
+# Switch provider
+$ ccm use OpenRouter
+✓ Switched to OpenRouter
+  Model: anthropic/claude-opus-4.6
+  Restart Claude Code to apply
+
+# View current config
+$ ccm current
+Current configuration: OpenRouter
+  ANTHROPIC_BASE_URL: https://openrouter.ai/api/v1
+  ANTHROPIC_MODEL: anthropic/claude-opus-4.6
+  ANTHROPIC_AUTH_TOKEN: sk-or-v1...a3f2
+
+# Save current settings.json as a new profile
+$ ccm save my-backup
+✓ Saved current configuration as "my-backup"
+```
+
+## ⚙️ How It Works
+
+Claude Code reads `~/.claude/settings.json` on startup. The `env` field controls the API provider and model:
+
+| Variable | Description |
+|---|---|
+| `ANTHROPIC_BASE_URL` | API endpoint URL |
+| `ANTHROPIC_AUTH_TOKEN` | Authentication token |
+| `ANTHROPIC_MODEL` | Default model |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Model used when selecting Opus via `/model` |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Model used when selecting Sonnet via `/model` |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Model used when selecting Haiku via `/model` |
+
+`ccm use` writes the selected profile into `settings.json` while preserving personal settings (`language`, `permissions`, etc.). Restart Claude Code to apply.
+
+## 📄 License
+
+[MIT](./LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,195 @@
+<div align="center">
+
+# ccm
+
+**Claude Code Model Switcher**
+
+在终端几秒内完成 Claude Code 自定义模型配置的管理和切换。
+
+[![npm version](https://img.shields.io/npm/v/@daylenjeez/ccm-switch.svg?style=flat-square)](https://www.npmjs.com/package/@daylenjeez/ccm-switch)
+[![license](https://img.shields.io/npm/l/@daylenjeez/ccm-switch.svg?style=flat-square)](https://github.com/daylenjeez/ccm-switch/blob/main/LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://nodejs.org)
+
+English | [中文文档](./README.zh-CN.md)
+
+[安装](#-安装) · [快速开始](#-快速开始) · [命令一览](#-命令一览) · [工作原理](#%EF%B8%8F-工作原理)
+
+</div>
+
+---
+
+## ✨ 亮点
+
+- 🔌 **cc-switch 无缝对接** — 直接读取 [cc-switch](https://github.com/farion1231/cc-switch) 数据库，无需迁移
+- 🧙 **交互式向导** — `ccm add` 逐步引导，输入 `<` 可返回上一步
+- ⚡ **一键切换** — `ccm use OpenRouter` 或 `ccm ls` 方向键选择
+- 🛡️ **安全切换** — 自动保留 `language`、`permissions` 等个人设置
+- 🚀 **零配置上手** — 直接 `ccm init`，跟着提示走，无需阅读文档
+- 🌍 **中英双语** — `ccm locale set zh/en` 切换界面语言
+
+## 📦 安装
+
+```bash
+npm install -g @daylenjeez/ccm-switch
+```
+
+或从源码构建：
+
+```bash
+git clone git@github.com:daylenjeez/ccm-switch.git
+cd ccm && npm install && npm run build && npm link
+```
+
+## 🚀 快速开始
+
+```bash
+ccm init   # 自动检测 cc-switch 或初始化独立模式
+ccm add    # 交互式向导添加供应商
+```
+
+> **没有 ccm**: 手动编辑 `~/.claude/settings.json`，复制粘贴 API key，重启，祈祷 JSON 没写错。
+> **使用 ccm**: `ccm use OpenRouter` — 搞定。
+
+## 🔌 cc-switch 集成
+
+已经在用 [cc-switch](https://github.com/farion1231/cc-switch)？ccm 直接读取它的 SQLite 数据库：
+
+```bash
+$ ccm init
+检测到 cc-switch 已安装，是否从中导入配置？(Y/n)
+✓ 已初始化为 cc-switch 模式
+✓ 已导入 4 个配置
+当前激活: OpenRouter
+```
+
+双向同步 — 在 ccm 中添加的配置在 cc-switch UI 中也能看到，反之亦然。
+
+## ➕ 添加配置
+
+### 交互式向导（推荐）
+
+```bash
+$ ccm add
+供应商名称 (如 OpenRouter): OpenRouter
+
+选择添加方式:
+  1) 逐步填写           # 按步骤输入，输入 < 返回上一步
+  2) 直接编写 JSON      # 打开 $EDITOR 编辑
+
+ANTHROPIC_BASE_URL: https://openrouter.ai/api/v1
+ANTHROPIC_AUTH_TOKEN: sk-or-xxx
+ANTHROPIC_MODEL: anthropic/claude-opus-4.6
+ANTHROPIC_DEFAULT_OPUS_MODEL (可选):
+ANTHROPIC_DEFAULT_SONNET_MODEL (可选):
+ANTHROPIC_DEFAULT_HAIKU_MODEL (可选):
+
+✓ 已保存配置 "OpenRouter"
+是否立即切换到此配置？(Y/n)
+```
+
+### 直接编辑 JSON
+
+<details>
+<summary>独立模式：<code>~/.ccm/config.json</code></summary>
+
+```json
+{
+  "profiles": {
+    "OpenRouter": {
+      "env": {
+        "ANTHROPIC_BASE_URL": "https://openrouter.ai/api/v1",
+        "ANTHROPIC_AUTH_TOKEN": "sk-or-...",
+        "ANTHROPIC_MODEL": "anthropic/claude-opus-4.6"
+      }
+    }
+  }
+}
+```
+</details>
+
+别名存储在 `~/.ccm/rc.json` 中：
+
+```json
+{
+  "aliases": {
+    "or": "OpenRouter"
+  }
+}
+```
+
+## 📖 命令一览
+
+### 核心命令
+
+| 命令 | 缩写 | 说明 |
+|---|---|---|
+| `ccm init` | | 初始化，自动检测 cc-switch |
+| `ccm list` | `ls` | 交互式列表 & 切换 |
+| `ccm use <name>` | | 按名称切换 |
+| `ccm add` | `new` | 交互式添加向导 |
+| `ccm save <name>` | | 将当前设置保存为方案 |
+| `ccm show [name]` | | 查看配置详情 |
+| `ccm modify [name]` | `edit` | 修改已有配置 |
+| `ccm remove [name]` | `rm` | 交互式或指定名称删除 |
+| `ccm current` | | 显示当前激活配置 |
+| `ccm config` | | 切换存储模式 |
+
+### 别名管理
+
+| 命令 | 说明 |
+|---|---|
+| `ccm alias set <short> <name>` | 创建别名，如 `ccm alias set or OpenRouter` |
+| `ccm alias rm <short>` | 删除别名 |
+| `ccm alias list` / `ls` | 列出所有别名 |
+
+```bash
+ccm alias set or OpenRouter
+ccm use or  # 等同于: ccm use OpenRouter
+```
+
+### 语言设置
+
+| 命令 | 说明 |
+|---|---|
+| `ccm locale` / `ls` | 列出并切换语言 |
+| `ccm locale set <lang>` | 设置语言（`zh` / `en`） |
+
+### 使用示例
+
+```bash
+# 切换供应商
+$ ccm use OpenRouter
+✓ 已切换到 OpenRouter
+  模型: anthropic/claude-opus-4.6
+  重启 Claude Code 生效
+
+# 查看当前配置
+$ ccm current
+当前配置: OpenRouter
+  ANTHROPIC_BASE_URL: https://openrouter.ai/api/v1
+  ANTHROPIC_MODEL: anthropic/claude-opus-4.6
+  ANTHROPIC_AUTH_TOKEN: sk-or-v1...a3f2
+
+# 将当前 settings.json 保存为新方案
+$ ccm save my-backup
+✓ 已保存当前配置为 "my-backup"
+```
+
+## ⚙️ 工作原理
+
+Claude Code 启动时读取 `~/.claude/settings.json`，`env` 字段控制 API 供应商和模型：
+
+| 变量 | 说明 |
+|---|---|
+| `ANTHROPIC_BASE_URL` | API 端点地址 |
+| `ANTHROPIC_AUTH_TOKEN` | 认证令牌 |
+| `ANTHROPIC_MODEL` | 默认模型 |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | 在 Claude Code 中通过 `/model` 选择 Opus 时使用的模型 |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | 选择 Sonnet 时使用的模型 |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 选择 Haiku 时使用的模型 |
+
+`ccm use` 将选中配置写入 `settings.json`，同时保留 `language`、`permissions` 等个人设置。重启 Claude Code 后生效。
+
+## 📄 License
+
+[MIT](./LICENSE)

package/dist/claude.d.ts

@@ -0,0 +1,3 @@
+export declare function readClaudeSettings(): Record<string, unknown>;
+export declare function applyProfile(settingsConfig: Record<string, unknown>): void;
+export declare function getSettingsPath(): string;

package/dist/claude.js

@@ -0,0 +1,25 @@
+import { homedir } from "os";
+import { join } from "path";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+const SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
+export function readClaudeSettings() {
+    if (!existsSync(SETTINGS_PATH))
+        return {};
+    return JSON.parse(readFileSync(SETTINGS_PATH, "utf-8"));
+}
+export function applyProfile(settingsConfig) {
+    const current = readClaudeSettings();
+    // 保留用户级字段，用 profile 的配置覆盖
+    const preserved = {};
+    const USER_FIELDS = ["language", "permissions"];
+    for (const key of USER_FIELDS) {
+        if (key in current) {
+            preserved[key] = current[key];
+        }
+    }
+    const merged = { ...preserved, ...settingsConfig };
+    writeFileSync(SETTINGS_PATH, JSON.stringify(merged, null, 2));
+}
+export function getSettingsPath() {
+    return SETTINGS_PATH;
+}

package/dist/i18n/en.d.ts

@@ -0,0 +1,3 @@
+import type { TranslationKey } from "./zh.js";
+declare const en: Record<TranslationKey, string>;
+export default en;

package/dist/i18n/en.js

@@ -0,0 +1,124 @@
+const en = {
+    // program
+    "program.description": "Claude Code Model Switcher - Quickly switch Claude Code custom model configurations",
+    // common
+    "common.not_init": "Not initialized yet. Run: ccm init",
+    "common.model": "Model",
+    "common.model_default": "default",
+    "common.source": "Source",
+    // error
+    "error.not_found": 'Configuration "{name}" not found',
+    "error.alias_target_missing": 'Alias "{alias}" points to "{target}", but it does not exist',
+    "error.invalid_choice": "Invalid choice",
+    // suggest
+    "suggest.did_you_mean": "Did you mean: {name}?",
+    "suggest.did_you_mean_header": "Did you mean:",
+    "suggest.use_list": "Use ccm list to see all available configurations",
+    // init
+    "init.description": "Initialize ccm",
+    "init.cc_switch_found": "cc-switch detected. Import configurations from it? (Y/n) ",
+    "init.imported": "✓ Imported {count} configurations",
+    "init.current": "Active: {name}",
+    "init.no_current": "No active configuration",
+    "init.done_cc_switch": "✓ Initialized in cc-switch mode",
+    "init.done_standalone": "✓ Initialized in standalone mode",
+    // config
+    "config.description": "View or switch data source mode",
+    "config.current_mode": "Current mode: {mode}",
+    "config.switch_confirm": "Switch mode? (y/N) ",
+    "config.cc_switch_not_installed": "cc-switch is not installed",
+    "config.switched": "✓ Switched to {mode} mode",
+    // list
+    "list.description": "List and select configurations",
+    "list.empty": "No configurations yet. Use ccm save <name> to save current config",
+    "list.header": "Available configurations:",
+    "list.select": "Select configuration:",
+    "list.current_marker": "(current)",
+    "list.cancelled": "Cancelled",
+    "list.choose_number": "Enter number to switch (Enter to skip): ",
+    // current
+    "current.description": "Show the currently active configuration",
+    "current.none": "No active configuration",
+    "current.settings_header": "Current settings.json:",
+    "current.not_exist": 'Current configuration "{name}" no longer exists',
+    "current.header": "Current configuration: {name}",
+    // use
+    "use.description": "Switch to a specified configuration",
+    "use.done": "✓ Switched to {name}",
+    "use.restart": "Restart Claude Code to apply",
+    // save
+    "save.description": "Save current settings.json as a new configuration",
+    "save.overwrite": 'Configuration "{name}" already exists, will overwrite',
+    "save.done": '✓ Saved current configuration as "{name}"',
+    // show
+    "show.description": "View configuration details (defaults to current)",
+    "show.no_current": "No active configuration. Specify a name: ccm show <name>",
+    // remove
+    "remove.description": "Delete a configuration",
+    "remove.select": "Select configuration to delete:",
+    "remove.confirm": 'Delete "{name}"? (y/N) ',
+    "remove.done": '✓ Deleted "{name}"',
+    // alias
+    "alias.description": "Manage aliases",
+    "alias.set_description": "Set alias, e.g.: ccm alias set or openrouter-opus4.6",
+    "alias.set_done": "✓ Alias set: {short} → {name}",
+    "alias.rm_description": "Remove an alias",
+    "alias.rm_not_found": 'Alias "{short}" not found',
+    "alias.rm_done": '✓ Removed alias "{short}"',
+    "alias.list_description": "List all aliases",
+    "alias.list_empty": "No aliases yet. Use ccm alias set <short> <name> to add one",
+    "alias.list_header": "Aliases:",
+    // locale
+    "locale.description": "Manage interface language",
+    "locale.current": "Current language: {locale}",
+    "locale.set_description": "Set language (zh/en)",
+    "locale.set_done": "✓ Language set to {locale}",
+    "locale.set_invalid": "Unsupported language: {locale}. Available: zh, en",
+    "locale.list_description": "List and select language",
+    "locale.list_header": "Supported languages:",
+    "locale.list_current_marker": "(current)",
+    "locale.select": "Select language:",
+    "locale.choose_number": "Enter number to switch (Enter to skip): ",
+    // add
+    "add.description": "Interactively add a new configuration",
+    "add.prompt_name": "Provider name (e.g. OpenRouter): ",
+    "add.prompt_base_url": "ANTHROPIC_BASE_URL: ",
+    "add.prompt_auth_token": "ANTHROPIC_AUTH_TOKEN: ",
+    "add.prompt_model": "ANTHROPIC_MODEL: ",
+    "add.prompt_default_opus": "ANTHROPIC_DEFAULT_OPUS_MODEL (press Enter to skip): ",
+    "add.prompt_default_sonnet": "ANTHROPIC_DEFAULT_SONNET_MODEL (press Enter to skip): ",
+    "add.prompt_default_haiku": "ANTHROPIC_DEFAULT_HAIKU_MODEL (press Enter to skip): ",
+    "add.mode_select": "Choose how to add:",
+    "add.mode_interactive": "Step by step",
+    "add.mode_json": "Write JSON directly",
+    "add.mode_choose": "Choose (1/2): ",
+    "add.json_template_hint": "Fill in the configuration in editor, save and exit",
+    "add.json_parse_error": "JSON parse error, please check format",
+    "add.back_hint": "Type < to go back",
+    "add.name_required": "Provider name cannot be empty",
+    "add.field_required": "{field} cannot be empty",
+    "add.already_exists": 'Configuration "{name}" already exists. Overwrite? (y/N) ',
+    "add.edit_confirm": "Edit configuration in editor? (y/N) ",
+    "add.preview_header": "Configuration preview:",
+    "add.done": '✓ Saved configuration "{name}"',
+    "add.switch_confirm": "Switch to this configuration now? (Y/n) ",
+    "add.cancelled": "Cancelled",
+    // modify
+    "modify.description": "Modify an existing configuration",
+    "modify.select": "Select configuration to modify:",
+    "modify.done": '✓ Updated configuration "{name}"',
+    "modify.no_change": "No changes made",
+    // alias conflict
+    "alias.is_alias": '"{name}" is an alias for "{target}"',
+    "alias.conflict": '"{name}" is both an alias (→ {target}) and a config name. Which one?',
+    "alias.conflict_alias": "Alias (→ {target})",
+    "alias.conflict_config": "Config {name}",
+    "alias.choose_conflict": "Choose (1/2): ",
+    "alias.rm_which": "Which one to delete?",
+    "alias.rm_alias": "Alias {name}",
+    "alias.rm_config": "Config {target}",
+    "alias.rm_choose": "Choose (1/2): ",
+    // store errors
+    "store.db_not_found": "cc-switch database not found: {path}",
+};
+export default en;

package/dist/i18n/index.d.ts

@@ -0,0 +1,5 @@
+import { type TranslationKey } from "./zh.js";
+export type Locale = "zh" | "en";
+export declare function setLocale(locale: Locale): void;
+export declare function t(key: TranslationKey, vars?: Record<string, string>): string;
+export { type TranslationKey };

package/dist/i18n/index.js

@@ -0,0 +1,35 @@
+import zh from "./zh.js";
+import en from "./en.js";
+import { readRc } from "../utils.js";
+const locales = { zh, en };
+function detectLocale() {
+    // 1. rc.json locale setting takes priority
+    const rc = readRc();
+    if (rc?.locale && rc.locale in locales)
+        return rc.locale;
+    // 2. Fallback to system LANG/LC_ALL
+    const lang = process.env.LC_ALL || process.env.LANG || "";
+    if (lang.startsWith("en"))
+        return "en";
+    // 3. Default to Chinese
+    return "zh";
+}
+let currentLocale;
+function getLocale() {
+    if (!currentLocale)
+        currentLocale = detectLocale();
+    return currentLocale;
+}
+export function setLocale(locale) {
+    currentLocale = locale;
+}
+export function t(key, vars) {
+    const locale = getLocale();
+    let text = locales[locale][key] ?? locales.zh[key] ?? key;
+    if (vars) {
+        for (const [k, v] of Object.entries(vars)) {
+            text = text.replace(new RegExp(`\\{${k}\\}`, "g"), v);
+        }
+    }
+    return text;
+}