@praeviso/code-env-switch 0.1.0 → 0.1.2

package/README_zh.md

@@ -0,0 +1,265 @@
+# code-env-switch
+
+一个轻量的 CLI，用于在 Claude Code 与 Codex 的环境变量之间快速切换。
+
+[English](README.md)
+
+## 特性
+
+- 多 profile 管理，按名称或类型切换
+- `codenv use` 输出可执行的 shell 命令，方便在当前终端生效
+- 支持交互式添加与选择 profile
+- 支持 `removeFiles` 与 `commands` 做清理与自动化
+- 配置文件自动发现与按类型自动补充 `unset` 键
+
+## 快速开始
+
+1) 安装：
+
+```bash
+npm install -g @praeviso/code-env-switch
+```
+
+2) 交互式添加 profile（若不存在会创建 `~/.config/code-env/config.json`）：
+
+```bash
+codenv add
+# 再执行一次，用来添加另一种 type
+codenv add
+```
+
+交互示例：
+
+```text
+$ codenv add
+Select type (1=codex, 2=claude): 1
+Profile name (default: default): primary
+Base URL (required): https://api.example.com/v1
+API key (required): YOUR_API_KEY
+```
+
+3) 按 type 设置默认项：
+
+```bash
+codenv default codex primary
+codenv default claude default
+```
+
+4) 启用自动应用：
+
+```bash
+codenv init
+```
+
+新开终端（或执行 `source ~/.bashrc` / `source ~/.zshrc`）即可自动应用默认配置。
+
+本地开发可用：
+
+```bash
+npm install -g .
+# 或
+npm link
+```
+
+## 使用方法
+
+> 默认情况下，`codenv use` 仅输出 shell 命令；执行 `codenv init` 后，
+> shell 包装函数会自动在当前终端生效。
+> 该片段还会包装 `codex`/`claude` 以绑定会话到 profile；如需绕过，
+> 可使用 `command codex` / `command claude`。
+
+### 常用命令
+
+```bash
+codenv list
+codenv show codex primary
+codenv default codex primary
+codenv remove codex primary
+```
+
+`codenv list`（或 `codenv ls`）会输出 `PROFILE` / `TYPE` / `NOTE` 的表格。默认项会标注在 `NOTE` 列，当前激活的配置会用绿色显示。
+如果设置了 `profile.name`，`PROFILE` 列会显示该名称；否则显示 profile 的 key（会尽量去掉旧的 `type-` 前缀）。
+
+### 添加 / 更新 profile
+
+```bash
+codenv add primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY --note "Primary endpoint"
+# 指定 type（codex/claude，claude 也可写 cc）
+codenv add --type codex primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY
+```
+
+当设置 `--type` 时，名称保持不变，`type` 会单独存储。
+profiles 使用内部 key，展示名称存放在 `profile.name`。
+
+交互式添加（默认）：
+
+```bash
+codenv add
+```
+
+### 删除 profile
+
+```bash
+codenv remove primary
+# 或按类型 + 名称（名称重复时推荐）
+codenv remove codex primary
+# 一次删多个
+codenv remove codex primary claude default
+# （也兼容形如 codex-primary 的旧 key）
+codenv remove codex-primary claude-default
+# 全部删除
+codenv remove --all
+```
+
+### 切换并生效（bash/zsh）
+
+```bash
+codenv use
+# 上下选择，回车确认（q 退出）
+codenv use primary
+# 或按类型 + 名称匹配（也兼容形如 codex-primary 的旧 key）
+codenv use codex primary
+codenv use cc primary
+```
+
+先执行一次 `codenv init` 安装 shell 包装函数：
+
+```bash
+codenv init
+# 或指定 shell
+codenv init --shell zsh
+```
+
+该包装函数会让 `codenv use` 和 `codenv unset` 在当前终端自动生效。
+如果只想打印片段而不写入，可用 `codenv init --print`。
+
+### 默认 profile 自动生效（按 type）
+
+为不同 type 设置默认 profile，并重新执行一次 `codenv init`：
+
+```bash
+codenv default codex primary
+codenv default claude default
+```
+
+```json
+{
+  "defaultProfiles": {
+    "codex": "primary",
+    "claude": "default"
+  }
+}
+```
+
+之后每次新开终端都会自动执行 `codenv auto` 应用所有默认配置。
+如需清除全部默认设置，可执行 `codenv default --clear`（需确认）。
+
+如果不想安装，可一次性执行：
+
+```bash
+eval "$(codenv use codex primary)"
+```
+
+注意：写入后对新终端生效；如需立刻生效，可执行：
+
+```bash
+source ~/.bashrc
+# 或 zsh
+source ~/.zshrc
+```
+
+### 清理已知键
+
+```bash
+codenv unset
+# 或一次性执行
+eval "$(codenv unset)"
+```
+
+### Fish shell
+
+```fish
+codenv use codex primary
+# 或一次性执行
+codenv use codex primary | source
+```
+
+## 配置文件查找顺序
+
+`codenv` 按以下顺序查找：
+
+1) `--config <path>`
+2) `CODE_ENV_CONFIG`
+3) `~/.config/code-env/config.json`
+
+可用 `codenv config` 输出当前目录会使用的配置路径。
+
+`codenv add` 在找不到配置时，会默认写入 `~/.config/code-env/config.json`。
+
+## 配置格式
+
+```json
+{
+  "unset": [],
+  "defaultProfiles": {
+    "codex": "primary",
+    "claude": "default"
+  },
+  "codexStatusline": {
+    "command": ["codenv", "statusline", "--type", "codex", "--sync-usage"],
+    "showHints": false,
+    "updateIntervalMs": 300,
+    "timeoutMs": 1000
+  },
+  "claudeStatusline": {
+    "command": "codenv statusline --type claude --sync-usage",
+    "type": "command",
+    "padding": 0
+  },
+  "profiles": {
+    "p_a1b2c3": {
+      "name": "primary",
+      "type": "codex",
+      "note": "Primary endpoint",
+      "env": {
+        "OPENAI_BASE_URL": "https://api.example.com/v1",
+        "OPENAI_API_KEY": "YOUR_API_KEY"
+      },
+      "removeFiles": ["$HOME/.config/example/auth.json"],
+      "commands": ["echo \"Switched to codex primary\""]
+    }
+  }
+}
+```
+
+说明：
+- `unset`：全局需要清理的环境变量。按 type 的默认清理键只会对当前 type 生效，不会影响其他 type。
+- `defaultProfiles`：可选；`codex`/`claude` 对应的默认 profile 名称或 key，供 `codenv auto` 使用。
+- `codexStatusline`：可选；在启动 `codex` 时写入 Codex TUI status line 配置。
+  - `command`：字符串或字符串数组；写入 Codex 的 `tui.status_line.command`。
+  - `showHints`：布尔值；状态栏激活时是否拼接 footer 提示。
+  - `updateIntervalMs`：数字；状态栏命令的刷新间隔（毫秒）。
+  - `timeoutMs`：数字；状态栏命令超时（毫秒）。
+  - `configPath`：可选；覆盖 `~/.codex/config.toml`（也可用 `CODE_ENV_CODEX_CONFIG_PATH`）。
+- `claudeStatusline`：可选；在启动 `claude` 时写入 Claude Code statusLine 配置。
+  - `command`：字符串（或字符串数组；数组会被拼接成单个命令字符串）。
+  - `type`：字符串；statusLine 类型（默认 `command`）。
+  - `padding`：数字；statusLine padding（默认 0）。
+  - `settingsPath`：可选；覆盖 `~/.claude/settings.json`（也可用 `CODE_ENV_CLAUDE_SETTINGS_PATH`）。
+- `name`：用于展示的 profile 名称，`codenv list` 与 `codenv use <name>` 会使用它。
+- `type`：可选，`codex` 或 `claude`（别名 `cc`），便于用 `codenv use <type> <name>` 匹配。
+- `note`：显示在 `codenv list` 输出中。
+- `removeFiles`：可选；`codenv use` 会输出对应 `rm -f`。Codex profile 还会删除 `~/.codex/auth.json`。
+- `ANTHROPIC_AUTH_TOKEN`：当设置了 `ANTHROPIC_API_KEY` 时，`codenv use` 会自动以同样的值导出 `ANTHROPIC_AUTH_TOKEN`。
+- `commands`：可选；原样输出到切换脚本中。
+
+## 安全提示
+
+配置文件包含 API key，请妥善保存并避免提交到公共仓库。
+
+## 开发
+
+```bash
+npm install
+npm run build
+```

package/bin/cli/args.js

@@ -0,0 +1,303 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.parseInitArgs = parseInitArgs;
+exports.parseAddArgs = parseAddArgs;
+exports.parseStatuslineArgs = parseStatuslineArgs;
+const type_1 = require("../profile/type");
+function parseArgs(argv) {
+    let configPath = null;
+    const args = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "-h" || arg === "--help") {
+            return { args: [], configPath: null, help: true };
+        }
+        if (arg === "-c" || arg === "--config") {
+            configPath = argv[i + 1];
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--config=")) {
+            configPath = arg.slice("--config=".length);
+            continue;
+        }
+        args.push(arg);
+    }
+    return { args, configPath, help: false };
+}
+function parseInitArgs(args) {
+    const result = { apply: true, print: false, shell: null };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--apply") {
+            result.apply = true;
+            result.print = false;
+            continue;
+        }
+        if (arg === "--print") {
+            result.print = true;
+            result.apply = false;
+            continue;
+        }
+        if (arg === "--shell") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --shell.");
+            result.shell = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--shell=")) {
+            result.shell = arg.slice("--shell=".length);
+            continue;
+        }
+        throw new Error(`Unknown init argument: ${arg}`);
+    }
+    return result;
+}
+function parseAddArgs(args) {
+    const result = {
+        profile: null,
+        pairs: [],
+        note: null,
+        removeFiles: [],
+        commands: [],
+        unset: [],
+        type: null,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!result.profile && !arg.startsWith("-")) {
+            result.profile = arg;
+            continue;
+        }
+        if (arg === "-n" || arg === "--note") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --note.");
+            result.note = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--note=")) {
+            result.note = arg.slice("--note=".length);
+            continue;
+        }
+        if (arg === "-t" || arg === "--type") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --type.");
+            result.type = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--type=")) {
+            result.type = arg.slice("--type=".length);
+            continue;
+        }
+        if (arg === "-r" || arg === "--remove-file") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --remove-file.");
+            result.removeFiles.push(val);
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--remove-file=")) {
+            result.removeFiles.push(arg.slice("--remove-file=".length));
+            continue;
+        }
+        if (arg === "-x" || arg === "--command") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --command.");
+            result.commands.push(val);
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--command=")) {
+            result.commands.push(arg.slice("--command=".length));
+            continue;
+        }
+        if (arg === "-u" || arg === "--unset") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --unset.");
+            result.unset.push(val);
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--unset=")) {
+            result.unset.push(arg.slice("--unset=".length));
+            continue;
+        }
+        if (arg.includes("=")) {
+            result.pairs.push(arg);
+            continue;
+        }
+        throw new Error(`Unknown add argument: ${arg}`);
+    }
+    if (!result.profile) {
+        throw new Error("Missing profile name.");
+    }
+    if (result.type) {
+        const normalized = (0, type_1.normalizeType)(result.type);
+        if (!normalized) {
+            throw new Error(`Unknown type: ${result.type}`);
+        }
+        result.type = normalized;
+    }
+    return result;
+}
+function parseNumberFlag(value, flag) {
+    if (value === null || value === undefined || value === "") {
+        throw new Error(`Missing value for ${flag}.`);
+    }
+    const num = Number(value);
+    if (!Number.isFinite(num)) {
+        throw new Error(`Invalid number for ${flag}: ${value}`);
+    }
+    return num;
+}
+function parseStatuslineArgs(args) {
+    const result = {
+        format: "text",
+        cwd: null,
+        type: null,
+        profileKey: null,
+        profileName: null,
+        model: null,
+        usageToday: null,
+        usageTotal: null,
+        usageInput: null,
+        usageOutput: null,
+        syncUsage: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--format") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --format.");
+            const normalized = val.toLowerCase();
+            if (normalized !== "text" && normalized !== "json") {
+                throw new Error(`Unknown format: ${val}`);
+            }
+            result.format = normalized;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--format=")) {
+            const val = arg.slice("--format=".length);
+            const normalized = val.toLowerCase();
+            if (normalized !== "text" && normalized !== "json") {
+                throw new Error(`Unknown format: ${val}`);
+            }
+            result.format = normalized;
+            continue;
+        }
+        if (arg === "--cwd") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --cwd.");
+            result.cwd = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--cwd=")) {
+            result.cwd = arg.slice("--cwd=".length);
+            continue;
+        }
+        if (arg === "--type") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --type.");
+            result.type = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--type=")) {
+            result.type = arg.slice("--type=".length);
+            continue;
+        }
+        if (arg === "--profile-key") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --profile-key.");
+            result.profileKey = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--profile-key=")) {
+            result.profileKey = arg.slice("--profile-key=".length);
+            continue;
+        }
+        if (arg === "--profile-name") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --profile-name.");
+            result.profileName = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--profile-name=")) {
+            result.profileName = arg.slice("--profile-name=".length);
+            continue;
+        }
+        if (arg === "--model") {
+            const val = args[i + 1];
+            if (!val)
+                throw new Error("Missing value for --model.");
+            result.model = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--model=")) {
+            result.model = arg.slice("--model=".length);
+            continue;
+        }
+        if (arg === "--usage-today") {
+            result.usageToday = parseNumberFlag(args[i + 1], "--usage-today");
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--usage-today=")) {
+            result.usageToday = parseNumberFlag(arg.slice("--usage-today=".length), "--usage-today");
+            continue;
+        }
+        if (arg === "--usage-total") {
+            result.usageTotal = parseNumberFlag(args[i + 1], "--usage-total");
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--usage-total=")) {
+            result.usageTotal = parseNumberFlag(arg.slice("--usage-total=".length), "--usage-total");
+            continue;
+        }
+        if (arg === "--usage-input") {
+            result.usageInput = parseNumberFlag(args[i + 1], "--usage-input");
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--usage-input=")) {
+            result.usageInput = parseNumberFlag(arg.slice("--usage-input=".length), "--usage-input");
+            continue;
+        }
+        if (arg === "--usage-output") {
+            result.usageOutput = parseNumberFlag(args[i + 1], "--usage-output");
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--usage-output=")) {
+            result.usageOutput = parseNumberFlag(arg.slice("--usage-output=".length), "--usage-output");
+            continue;
+        }
+        if (arg === "--sync-usage") {
+            result.syncUsage = true;
+            continue;
+        }
+        throw new Error(`Unknown statusline argument: ${arg}`);
+    }
+    return result;
+}

package/bin/cli/help.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Help message for codenv CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printHelp = printHelp;
+function printHelp() {
+    const msg = `codenv - switch Claude/Codex env vars
+
+Usage:
+  codenv list
+  codenv ls
+  codenv config
+  codenv auto
+  codenv use
+  codenv use <profile>
+  codenv use <type> <name>
+  codenv show <profile>
+  codenv show <type> <name>
+  codenv default <profile>
+  codenv default <type> <name>
+  codenv default --clear
+  codenv remove <profile> [<profile> ...]
+  codenv remove <type> <name> [<type> <name> ...]
+  codenv remove --all
+  codenv unset
+  codenv add <profile> KEY=VALUE [KEY=VALUE ...]
+  codenv add
+  codenv launch <codex|claude> [--] [args...]
+  codenv init
+  codenv statusline [options]
+
+Options:
+  -c, --config <path>   Path to config JSON
+  -h, --help            Show help
+
+Init options:
+  --apply                 Append shell helper to your shell rc (default)
+  --print                 Print helper snippet to stdout
+  --shell <bash|zsh|fish> Explicitly set the target shell
+
+Add options:
+  -t, --type <codex|claude>   Set profile type (alias: cc)
+  -n, --note <text>           Set profile note
+  -r, --remove-file <path>    Add a removeFiles entry (repeat)
+  -x, --command <cmd>         Add a commands entry (repeat)
+  -u, --unset <KEY>           Add a global unset key (repeat)
+
+Statusline options:
+  --format <text|json>        Output format (default: text)
+  --cwd <path>                Override working directory
+  --type <type>               Set profile type
+  --profile-key <key>         Set profile key
+  --profile-name <name>       Set profile name
+  --model <model>             Set model label
+  --usage-today <n>           Set today's token usage
+  --usage-total <n>           Set total token usage
+  --usage-input <n>           Set input token usage
+  --usage-output <n>          Set output token usage
+  --sync-usage                Sync usage from sessions before reading
+
+Examples:
+  codenv init
+  codenv use codex primary
+  codenv list
+  codenv default codex primary
+  codenv remove codex primary
+  codenv remove codex primary claude default
+  codenv remove --all
+  codenv launch codex -- --help
+  codenv statusline --format json
+  CODE_ENV_CONFIG=~/.config/code-env/config.json codenv use claude default
+  codenv add --type codex primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY
+  codenv add
+`;
+    console.log(msg);
+}

package/bin/cli/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printHelp = exports.parseStatuslineArgs = exports.parseAddArgs = exports.parseInitArgs = exports.parseArgs = void 0;
+/**
+ * CLI module exports
+ */
+var args_1 = require("./args");
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return args_1.parseArgs; } });
+Object.defineProperty(exports, "parseInitArgs", { enumerable: true, get: function () { return args_1.parseInitArgs; } });
+Object.defineProperty(exports, "parseAddArgs", { enumerable: true, get: function () { return args_1.parseAddArgs; } });
+Object.defineProperty(exports, "parseStatuslineArgs", { enumerable: true, get: function () { return args_1.parseStatuslineArgs; } });
+var help_1 = require("./help");
+Object.defineProperty(exports, "printHelp", { enumerable: true, get: function () { return help_1.printHelp; } });