@praeviso/code-env-switch 0.1.0 → 0.1.1

package/.eslintrc.cjs

@@ -0,0 +1,18 @@
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    es2021: true,
+  },
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    ecmaVersion: 2021,
+    sourceType: "module",
+  },
+  plugins: ["@typescript-eslint"],
+  extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  ignorePatterns: ["bin/", "node_modules/"],
+  rules: {
+    "no-constant-condition": ["error", { "checkLoops": false }]
+  }
+};

package/.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "typescript.enablePromptUseWorkspaceTsdk": true
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Krito.
+
+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

@@ -2,19 +2,60 @@
 
 A tiny CLI to switch between Claude Code and Codex environment variables.
 
-## Setup
+[中文说明](README_zh.md)
 
-1) Copy the example config and fill in your keys:
+## Features
+
+- Manage multiple profiles and switch by name or type
+- `codenv use` prints shell commands for the current terminal
+- Interactive profile creation and selection
+- Optional cleanup via `removeFiles` and post-switch `commands`
+- Config auto-discovery and type-based default `unset` keys
+
+## Quick start
+
+1) Install:
 
 ```bash
-cp code-env.example.json code-env.json
+npm install -g @praeviso/code-env-switch
 ```
 
-2) Install from npm (after publish) or locally:
+2) Add profiles interactively (this creates `~/.config/code-env/config.json` if missing):
+
+```bash
+codenv add
+# run it again to add the second type
+codenv add
+```
+
+Example session:
+
+```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) Set defaults per type:
+
+```bash
+codenv default codex primary
+codenv default claude default
+```
+
+4) Enable auto-apply in your shell:
+
+```bash
+codenv init
+```
+
+Open a new terminal (or `source ~/.bashrc` / `source ~/.zshrc`) to auto-apply the defaults.
+
+For local development install:
 
 ```bash
-npm install -g code-env-switch
-# or local dev
 npm install -g .
 # or
 npm link
@@ -22,69 +63,180 @@ npm link
 
 ## Usage
 
-List profiles:
+> By default, `codenv use` only outputs shell commands. After running
+> `codenv init`, the shell wrapper applies them automatically.
+
+### Common commands
 
 ```bash
 codenv list
+codenv show codex primary
+codenv default codex primary
+codenv remove codex primary
+```
+
+`codenv list` (or `codenv ls`) prints a table with `PROFILE`, `TYPE`, and `NOTE`. Default profiles are labeled in the `NOTE` column, and the active profile is shown in green.
+If `profile.name` is set, it is shown in `PROFILE`. Otherwise the profile key is shown (with legacy `type-` prefixes stripped when possible).
+
+### Add / update a profile
+
+```bash
+codenv add primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY --note "Primary endpoint"
+# with explicit type (codex/claude, claude also accepts cc)
+codenv add --type codex primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY
 ```
 
-Add or update a profile from the CLI:
+When `--type` is set, the profile name is kept as-is and `type` is stored separately.
+Profiles are keyed by an internal id; the human-facing name lives in `profile.name`.
+
+Interactive add (default):
+
+```bash
+codenv add
+```
+
+### Remove a profile
 
 ```bash
-codenv add codex-88 OPENAI_BASE_URL=https://api.openai.com/v1 OPENAI_API_KEY=sk-REPLACE_ME --note "OpenAI official"
+codenv remove primary
+# or by type + name (recommended when names overlap)
+codenv remove codex primary
+# multiple at once
+codenv remove codex primary claude default
+# (legacy keys like codex-primary also work)
+codenv remove codex-primary claude-default
+# remove all
+codenv remove --all
 ```
 
-Switch in the current shell (bash/zsh):
+### Switch in the current shell (bash/zsh)
 
 ```bash
-eval "$(codenv use codex-88)"
+codenv use
+# use up/down then Enter (q to exit)
+codenv use primary
+# or by type + name (also matches legacy keys like codex-primary)
+codenv use codex primary
+codenv use cc primary
 ```
 
-Unset all known keys:
+First run `codenv init` once to install the shell wrapper:
 
 ```bash
+codenv init
+# or target a specific shell
+codenv init --shell zsh
+```
+
+This wrapper makes `codenv use` and `codenv unset` apply automatically in the
+current shell. To print the snippet without writing to rc, use
+`codenv init --print`.
+
+### Auto-apply default profiles (per type)
+
+Set a default per type (codex/claude) and re-run `codenv init`:
+
+```bash
+codenv default codex primary
+codenv default claude default
+```
+
+```json
+{
+  "defaultProfiles": {
+    "codex": "primary",
+    "claude": "default"
+  }
+}
+```
+
+On new terminal sessions, `codenv` will auto-apply all defaults via `codenv auto`.
+To clear all defaults, run `codenv default --clear` (with confirmation).
+
+One-off without init:
+
+```bash
+eval "$(codenv use codex primary)"
+```
+
+Note: the change takes effect in new terminals. To apply immediately, run:
+
+```bash
+source ~/.bashrc
+# or for zsh
+source ~/.zshrc
+```
+
+### Unset known keys
+
+```bash
+codenv unset
+# or one-off without init
 eval "$(codenv unset)"
 ```
 
-### Config lookup order
+### Fish shell
+
+```fish
+codenv use codex primary
+# or one-off without init
+codenv use codex primary | source
+```
+
+## Config lookup order
 
 `codenv` searches in this order:
 
 1) `--config <path>`
 2) `CODE_ENV_CONFIG`
-3) `./code-env.json`
-4) `./profiles.json`
-5) `./code-env.config.json`
-6) `~/.config/code-env/config.json`
+3) `~/.config/code-env/config.json`
+
+Use `codenv config` to print the path selected for the current directory.
+
+If nothing is found, `codenv add` writes to `~/.config/code-env/config.json`.
 
 ## Config format
 
 ```json
 {
-  "unset": ["OPENAI_BASE_URL", "OPENAI_API_KEY"],
+  "unset": [],
+  "defaultProfiles": {
+    "codex": "primary",
+    "claude": "default"
+  },
   "profiles": {
-    "codex-88": {
-      "note": "OpenAI official",
+    "p_a1b2c3": {
+      "name": "primary",
+      "type": "codex",
+      "note": "Primary endpoint",
       "env": {
-        "OPENAI_BASE_URL": "https://api.openai.com/v1",
-        "OPENAI_API_KEY": "sk-REPLACE_ME",
-        "CODEX_PROVIDER": "OpenAI"
+        "OPENAI_BASE_URL": "https://api.example.com/v1",
+        "OPENAI_API_KEY": "YOUR_API_KEY"
       },
-      "removeFiles": ["$HOME/.config/openai/auth.json"],
-      "commands": ["echo \"Switched to codex-88\""]
+      "removeFiles": ["$HOME/.config/example/auth.json"],
+      "commands": ["echo \"Switched to codex primary\""]
     }
   }
 }
 ```
 
 Notes:
-- `removeFiles` is optional; when present, `codenv use <profile>` emits `rm -f` lines for those paths.
-- `commands` is optional; any strings are emitted as-is.
-- `note` is shown in `codenv list` output.
-- `codenv add` creates the config file if it does not exist (default: `./code-env.json`).
+- `unset`: global keys to clear. Type-specific defaults are applied only for the active type and won't clear the other type.
+- `defaultProfiles`: optional; map of `codex`/`claude` to profile name or key used by `codenv auto`.
+- `name`: human-facing profile name shown in `codenv list` and used by `codenv use <name>`.
+- `type`: optional; `codex` or `claude` (alias `cc`) for `codenv use <type> <name>` matching.
+- `note`: shown in `codenv list`.
+- `removeFiles`: optional; `codenv use` emits `rm -f` for each path. Codex profiles also remove `~/.codex/auth.json`.
+- `ANTHROPIC_AUTH_TOKEN`: when `ANTHROPIC_API_KEY` is set, `codenv use` also exports `ANTHROPIC_AUTH_TOKEN` with the same value.
+- `commands`: optional; emitted as-is in the switch script.
 
-## Fish shell
+## Security
 
-```fish
-codenv use codex-88 | source
+Your config contains API keys. Keep it private and out of public repositories.
+
+## Development
+
+```bash
+npm install
+npm run build
 ```

package/README_zh.md

@@ -0,0 +1,241 @@
+# 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 包装函数会自动在当前终端生效。
+
+### 常用命令
+
+```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"
+  },
+  "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` 使用。
+- `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
+```