@wangxt0223/codex-switcher 0.4.1 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.5.1 - 2026-04-12
+
+- Added `version: <semver>` output in `codex-sw check` for quick runtime version verification.
+- Added smoke-test assertion to verify `check` includes the version line.
+
+## 0.5.0 - 2026-04-12
+
+- Added automatic Codex CLI launch behavior for `use/switch` in interactive shells (`--launch=auto`).
+- Added explicit `--launch` / `--no-launch` controls for `use/switch`.
+- Added support for `use/switch -- <codex args...>` to switch profile and run Codex command in one step.
+- Improved non-interactive UX with explicit auto-launch skip hint.
+- Added smoke-test coverage for launch/no-launch behavior and argument conflict handling.
+- Updated Chinese/English docs to describe launch semantics and new command forms.
+
 ## 0.4.1 - 2026-04-12
 
 - Refined README wording for a more conversational background/auth mechanism explanation.

package/README.en.md

@@ -58,6 +58,10 @@ codex-switcher app use personal
 - `login --sync`: sync `~/.codex` into the target profile (excluding `auth.json`).
 - `use/switch --sync`: sync current CLI profile into target profile (excluding `auth.json`).
 - `--no-sync`: keep strict isolation without data copy (default).
+- `use/switch` defaults to `--launch=auto`: on an interactive terminal, `codex` starts automatically after switch.
+- `use/switch --launch`: launch `codex` CLI immediately after switching.
+- `use/switch --no-launch`: switch CLI pointer only, without launching `codex`.
+- `use/switch -- <codex args...>`: run `codex` with args right after switch (implies launch).
 
 ## Command reference
 

package/README.md

@@ -55,6 +55,10 @@ codex-switcher app use personal
 - `login --sync`：将 `~/.codex` 同步到目标 profile（不包含 `auth.json`）。
 - `use/switch --sync`：将当前 CLI profile 同步到目标 profile（不包含 `auth.json`）。
 - `--no-sync`：不进行数据同步（默认）。
+- `use/switch` 默认 `--launch=auto`：交互终端中切换后会自动启动 `codex` CLI。
+- `use/switch --launch`：切换后立即启动 `codex` CLI。
+- `use/switch --no-launch`：仅切换当前 CLI profile，不启动 `codex` CLI。
+- `use/switch -- <codex args...>`：切换后直接执行 `codex` 参数（隐式启用 launch）。
 
 ## 命令参考
 
@@ -67,8 +71,8 @@ codex-switcher app use personal
 | Profile 管理 | `codex-switcher list` | 列出所有 profile |
 | Profile 管理 | `codex-switcher current [cli\|app]` | 查看当前 CLI / App profile |
 | Profile 管理 | `codex-switcher status` | 查看当前 profile 登录状态 |
-| Profile 管理 | `codex-switcher use <profile> [--sync\|--no-sync]` | 切换当前 CLI profile |
-| Profile 管理 | `codex-switcher switch <profile> [--sync\|--no-sync]` | `use` 的等价命令 |
+| Profile 管理 | `codex-switcher use <profile> [--sync\|--no-sync] [--launch\|--no-launch] [-- <codex args...>]` | 切换当前 CLI profile，可选立即启动 `codex` |
+| Profile 管理 | `codex-switcher switch <profile> [--sync\|--no-sync] [--launch\|--no-launch] [-- <codex args...>]` | `use` 的等价命令 |
 | 数据迁移 | `codex-switcher import-default <profile> [--with-auth] [--force]` | 从 `~/.codex` 导入数据到 profile |
 | CLI 登录态 | `codex-switcher login [profile] [--sync\|--no-sync]` | 登录指定或当前 CLI profile |
 | CLI 登录态 | `codex-switcher logout [profile]` | 登出指定或当前 CLI profile |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wangxt0223/codex-switcher",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Profile-based account switcher for Codex CLI and Codex App using isolated CODEX_HOME directories.",
   "license": "MIT",
   "author": "wangxt",

package/plugins/codex-switcher/README.en.md

@@ -18,8 +18,8 @@ codex-switcher add <profile>
 codex-switcher remove <profile> [--force]
 codex-switcher list
 codex-switcher import-default <profile> [--with-auth] [--force]
-codex-switcher use <profile> [--sync|--no-sync]
-codex-switcher switch <profile> [--sync|--no-sync]
+codex-switcher use <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
+codex-switcher switch <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
 codex-switcher current [cli|app]
 codex-switcher status
 
@@ -75,6 +75,10 @@ codex-switcher import-default work --with-auth
 - `login --sync`: overwrite sync from default `~/.codex` to target profile, excluding `auth.json`.
 - `use/switch --sync`: overwrite sync from current CLI profile to target profile, excluding `auth.json`.
 - `--no-sync`: explicit no-sync mode (default behavior).
+- `use/switch` defaults to `--launch=auto`: in interactive terminals, `codex` starts right after switching.
+- `use/switch --launch`: launch `codex` CLI immediately after switching profile.
+- `use/switch --no-launch`: switch pointer only without launching `codex`.
+- `use/switch -- <codex args...>`: run `codex` with provided args after switch (implies launch).
 
 Examples:
 

package/plugins/codex-switcher/README.md

@@ -18,8 +18,8 @@ codex-switcher add <profile>
 codex-switcher remove <profile> [--force]
 codex-switcher list
 codex-switcher import-default <profile> [--with-auth] [--force]
-codex-switcher use <profile> [--sync|--no-sync]
-codex-switcher switch <profile> [--sync|--no-sync]
+codex-switcher use <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
+codex-switcher switch <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
 codex-switcher current [cli|app]
 codex-switcher status
 
@@ -75,6 +75,10 @@ codex-switcher import-default work --with-auth
 - `login --sync`：从默认 `~/.codex` 覆盖同步到目标 profile，排除 `auth.json`。
 - `use/switch --sync`：从当前 CLI profile 覆盖同步到目标 profile，排除 `auth.json`。
 - `--no-sync`：显式关闭同步（默认行为）。
+- `use/switch` 默认 `--launch=auto`：交互终端中切换后自动启动 `codex` CLI。
+- `use/switch --launch`：切换后立即以目标 profile 启动 `codex` CLI。
+- `use/switch --no-launch`：切换后只更新 profile 指针，不启动 `codex` CLI。
+- `use/switch -- <codex args...>`：切换后执行指定 `codex` 参数（等价于隐式 `--launch`）。
 
 示例：
 

package/plugins/codex-switcher/scripts/codex-switcher

@@ -18,8 +18,8 @@ Usage:
   codex-sw remove <profile> [--force]
   codex-sw list
   codex-sw import-default <profile> [--with-auth] [--force]
-  codex-sw use <profile> [--sync|--no-sync]
-  codex-sw switch <profile> [--sync|--no-sync]
+  codex-sw use <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
+  codex-sw switch <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
   codex-sw current [cli|app]
   codex-sw status
 
@@ -76,6 +76,18 @@ now_utc() {
   date -u +"%Y-%m-%dT%H:%M:%SZ"
 }
 
+switcher_version() {
+  local script_dir package_json version
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  package_json="$(cd "$script_dir/../../.." && pwd)/package.json"
+
+  if [[ -f "$package_json" ]]; then
+    version="$(sed -nE 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p' "$package_json" | head -n 1)"
+  fi
+
+  echo "${version:-unknown}"
+}
+
 redact() {
   sed -E \
     -e 's/sk-[A-Za-z0-9_-]{8,}/sk-***REDACTED***/g' \
@@ -514,15 +526,53 @@ cmd_use() {
   ensure_profile "$profile"
   set_current cli "$profile"
   log_event INFO "cli_use profile=$profile sync=$sync_mode"
-  echo "Switched CLI profile to: $profile"
-  echo "Run in current shell if needed:"
-  echo "  export CODEX_HOME='$(profile_path "$profile")'"
 }
 
 cmd_switch() {
   cmd_use "$1" "${2:-false}"
 }
 
+should_launch_codex() {
+  local mode="$1"
+  case "$mode" in
+    true)
+      return 0
+      ;;
+    false)
+      return 1
+      ;;
+    auto)
+      [[ -t 0 && -t 1 ]]
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+}
+
+cmd_use_and_maybe_launch() {
+  local mode_cmd="$1"
+  local profile="$2"
+  local sync_mode="${3:-false}"
+  local launch_mode="${4:-auto}"
+  shift 4 || true
+
+  with_lock "$mode_cmd" "$profile" "$sync_mode"
+
+  echo "Switched CLI profile to: $profile"
+  if should_launch_codex "$launch_mode"; then
+    echo "Launching codex with profile: $profile"
+    CODEX_HOME="$(profile_path "$profile")" command codex "$@"
+    return
+  fi
+
+  if [[ "$launch_mode" == "auto" ]]; then
+    echo "Auto launch skipped (non-interactive shell). Use --launch to force start."
+  fi
+  echo "Run in current shell if needed:"
+  echo "  export CODEX_HOME='$(profile_path "$profile")'"
+}
+
 cmd_current() {
   local target="${1:-all}"
   case "$target" in
@@ -836,6 +886,7 @@ cmd_check() {
     err "log redaction check failed"
   fi
 
+  echo "version: $(switcher_version)"
   echo "check: ok"
 }
 
@@ -977,30 +1028,88 @@ main() {
       with_lock cmd_import_default "$profile" "$with_auth" "$force"
       ;;
     use)
-      [[ "$#" -ge 1 && "$#" -le 2 ]] || err "usage: $SCRIPT_NAME use <profile> [--sync|--no-sync]"
+      [[ "$#" -ge 1 ]] || err "usage: $SCRIPT_NAME use <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]"
       local profile="$1"
+      shift
       local sync="false"
-      if [[ "${2:-}" == "--sync" ]]; then
-        sync="true"
-      elif [[ "${2:-}" == "--no-sync" || -z "${2:-}" ]]; then
-        :
+      local launch="auto"
+      local codex_args=()
+      while [[ "$#" -gt 0 ]]; do
+        case "$1" in
+          --sync)
+            sync="true"
+            ;;
+          --no-sync)
+            sync="false"
+            ;;
+          --launch)
+            launch="true"
+            ;;
+          --no-launch)
+            launch="false"
+            ;;
+          --)
+            shift
+            codex_args=("$@")
+            break
+            ;;
+          *)
+            err "unknown option: $1"
+            ;;
+        esac
+        shift
+      done
+      if [[ "${#codex_args[@]}" -gt 0 ]]; then
+        [[ "$launch" != "false" ]] || err "cannot pass codex args with --no-launch"
+        launch="true"
+      fi
+      if [[ "${#codex_args[@]}" -gt 0 ]]; then
+        cmd_use_and_maybe_launch cmd_use "$profile" "$sync" "$launch" "${codex_args[@]}"
       else
-        err "unknown option: ${2:-}"
+        cmd_use_and_maybe_launch cmd_use "$profile" "$sync" "$launch"
       fi
-      with_lock cmd_use "$profile" "$sync"
       ;;
     switch)
-      [[ "$#" -ge 1 && "$#" -le 2 ]] || err "usage: $SCRIPT_NAME switch <profile> [--sync|--no-sync]"
+      [[ "$#" -ge 1 ]] || err "usage: $SCRIPT_NAME switch <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]"
       local profile="$1"
+      shift
       local sync="false"
-      if [[ "${2:-}" == "--sync" ]]; then
-        sync="true"
-      elif [[ "${2:-}" == "--no-sync" || -z "${2:-}" ]]; then
-        :
+      local launch="auto"
+      local codex_args=()
+      while [[ "$#" -gt 0 ]]; do
+        case "$1" in
+          --sync)
+            sync="true"
+            ;;
+          --no-sync)
+            sync="false"
+            ;;
+          --launch)
+            launch="true"
+            ;;
+          --no-launch)
+            launch="false"
+            ;;
+          --)
+            shift
+            codex_args=("$@")
+            break
+            ;;
+          *)
+            err "unknown option: $1"
+            ;;
+        esac
+        shift
+      done
+      if [[ "${#codex_args[@]}" -gt 0 ]]; then
+        [[ "$launch" != "false" ]] || err "cannot pass codex args with --no-launch"
+        launch="true"
+      fi
+      if [[ "${#codex_args[@]}" -gt 0 ]]; then
+        cmd_use_and_maybe_launch cmd_switch "$profile" "$sync" "$launch" "${codex_args[@]}"
       else
-        err "unknown option: ${2:-}"
+        cmd_use_and_maybe_launch cmd_switch "$profile" "$sync" "$launch"
       fi
-      with_lock cmd_switch "$profile" "$sync"
       ;;
     current)
       [[ "$#" -le 1 ]] || err "usage: $SCRIPT_NAME current [cli|app]"

package/plugins/codex-switcher/scripts/test-switcher.sh

@@ -21,6 +21,7 @@ trap cleanup EXIT INT TERM
 cat > "$BIN/codex" <<'FAKE'
 #!/usr/bin/env bash
 set -euo pipefail
+echo "${CODEX_HOME:-}|$*" >> "${CODEX_SWITCHER_TEST_CODEX_LOG:?}"
 if [[ "${1:-}" == "login" && "${2:-}" == "status" ]]; then
   if [[ -f "${CODEX_HOME}/auth.json" ]]; then
     echo "Logged in"
@@ -64,6 +65,8 @@ export CODEX_SWITCHER_APP_BIN="$BIN/fake-codex-app"
 export CODEX_SWITCHER_LOCK_WAIT_SECONDS=2
 export CODEX_SWITCHER_DEFAULT_HOME="$TMPBASE/default-home"
 export CODEX_SWITCHER_TEST_NPM_LOG="$TMPBASE/npm-args.log"
+export CODEX_SWITCHER_TEST_CODEX_LOG="$TMPBASE/codex-args.log"
+: > "$CODEX_SWITCHER_TEST_CODEX_LOG"
 
 mkdir -p "$CODEX_SWITCHER_DEFAULT_HOME/memories"
 echo '{"auth_mode":"chatgpt"}' > "$CODEX_SWITCHER_DEFAULT_HOME/auth.json"
@@ -71,6 +74,7 @@ echo '{"projects":["demo"]}' > "$CODEX_SWITCHER_DEFAULT_HOME/state_5.sqlite"
 echo '{"memo":"persist"}' > "$CODEX_SWITCHER_DEFAULT_HOME/memories/demo.json"
 
 check_out="$("$SW" check)"
+echo "$check_out" | grep -Eq '^version: [0-9]+\.[0-9]+\.[0-9]+$'
 echo "$check_out" | grep -q "check: ok"
 init_out="$("$SW" init --dry-run)"
 echo "$init_out" | grep -q "\[dry-run\]"
@@ -79,9 +83,22 @@ grep -q "i -g @wangxt0223/codex-switcher@latest --registry https://registry.npmj
 
 "$SW" add work
 "$SW" add personal
-"$SW" use personal
+codex_calls_before="$(wc -l < "$CODEX_SWITCHER_TEST_CODEX_LOG" 2>/dev/null || echo 0)"
+"$SW" use personal --no-launch
+codex_calls_after="$(wc -l < "$CODEX_SWITCHER_TEST_CODEX_LOG" 2>/dev/null || echo 0)"
+[[ "$codex_calls_before" -eq "$codex_calls_after" ]]
 [[ "$("$SW" current cli)" == "personal" ]]
 
+"$SW" use personal -- --version
+grep -Fq "$PROFILES/personal|--version" "$CODEX_SWITCHER_TEST_CODEX_LOG"
+
+set +e
+"$SW" use personal --no-launch -- --version >/tmp/codex_sw_use_no_launch_conflict 2>&1
+use_no_launch_conflict_rc=$?
+set -e
+[[ "$use_no_launch_conflict_rc" -ne 0 ]]
+grep -q "cannot pass codex args with --no-launch" /tmp/codex_sw_use_no_launch_conflict
+
 "$SW" login personal
 "$SW" login sync-login --sync
 [[ -f "$PROFILES/sync-login/state_5.sqlite" ]]