Skip to content

Releases: mileson/CodexSwitcher

CJFCodexSwitcher v0.1.10

25 Mar 14:33

Choose a tag to compare

CJFCodexSwitcher v0.1.10

This release further tightens the SPACE column so the account table stays readable while leaving even less unused horizontal space in the terminal.

Highlights

  • Reduced the SPACE column width from 18 to 14 characters
  • Kept the current table order:
    • 邮箱 / SPACE / PLAN / 5小时 / 每周
  • Preserved the current active-account UX:
    • active account stays at the top
    • active account stays visually separated from the remaining rows
  • Preserved the current remaining-count based ranking logic

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcher

pipx

pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • python3 -m py_compile codex_switcher.py codex-switcher.py install.py
  • openspec validate further-tighten-space-column-width
  • codex-switcher --list shows a tighter SPACE column while keeping SPACE before PLAN

How To Use

  • Run codex-switcher
  • Read the tighter SPACE column after the account email
  • Use # to switch accounts after reviewing workspace, plan, and quota in one line

CJFCodexSwitcher v0.1.9

25 Mar 14:28

Choose a tag to compare

CJFCodexSwitcher v0.1.9

This release tightens the SPACE column width so the account table keeps the same information but reads more compactly in the terminal.

Highlights

  • Reduced the SPACE column width from 24 to 18 characters
  • Kept the current table order:
    • 邮箱 / SPACE / PLAN / 5小时 / 每周
  • Preserved the current active-account UX:
    • active account stays at the top
    • active account stays visually separated from the remaining rows
  • Preserved the current remaining-count based ranking logic

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcher

pipx

pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • python3 -m py_compile codex_switcher.py codex-switcher.py install.py
  • openspec validate tighten-space-column-width
  • codex-switcher --list shows a visibly narrower SPACE column while keeping SPACE before PLAN

How To Use

  • Run codex-switcher
  • Read the compact SPACE column after the account email
  • Use # to switch accounts after reviewing workspace, plan, and quota in one line

CJFCodexSwitcher v0.1.8

25 Mar 14:23

Choose a tag to compare

CJFCodexSwitcher v0.1.8

This release moves the SPACE column ahead of PLAN so the account table reads in a more natural order: account, workspace, plan, then remaining quota.

Highlights

  • Reordered the live account table to 邮箱 / SPACE / PLAN / 5小时 / 每周
  • Kept the current active-account UX:
    • active account stays at the top
    • active account stays visually separated from the remaining rows
  • Preserved the current remaining-count based ranking logic
  • Keeps Windows restart support and Homebrew bootstrap fixes from the previous release

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcher

pipx

pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • python3 -m py_compile codex_switcher.py codex-switcher.py install.py
  • openspec validate reorder-space-column-ahead-of-plan
  • codex-switcher --list shows SPACE before PLAN

How To Use

  • Run codex-switcher
  • Read the SPACE column right after the account email to identify the primary workspace first
  • Use # to switch accounts after reviewing workspace, plan, and quota in one line

CJFCodexSwitcher v0.1.7

25 Mar 14:11

Choose a tag to compare

CJFCodexSwitcher v0.1.7

This release ships the restored SPACE column on top of the current mainline UX and publishes the same behavior through GitHub Release, Homebrew, and local installation.

Highlights

  • Restored the SPACE column using workspace metadata from auth claims
  • Kept the current active-account UX:
    • active account stays at the top
    • active account stays visually separated from the remaining rows
  • Preserved the current remaining-count based ranking logic
  • Includes Windows restart support after account switching
  • Keeps the Homebrew installation bootstrap fix for pip, setuptools, and wheel

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcher

pipx

pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • python3 -m py_compile codex_switcher.py
  • codex-switcher --list --json includes workspace fields such as workspace_title and workspace_display
  • The live TUI shows the SPACE column while keeping the active-account-first layout
  • Homebrew formula is updated to the same release tag

How To Use

  • Run codex-switcher
  • Check the SPACE column to see the primary workspace label
  • Use # to switch accounts and keep using the active-account-first layout

CJFCodexSwitcher v0.1.6

25 Mar 14:00

Choose a tag to compare

CJFCodexSwitcher v0.1.6

Automated release generated from tag v0.1.6.

CJFCodexSwitcher v0.1.5

25 Mar 13:04

Choose a tag to compare

CJFCodexSwitcher v0.1.5

This release aligns the public distribution channels with the latest live-view UX and adds Windows restart support after account switching.

Highlights

  • Windows now supports automatic Codex Desktop restart after account switching
  • The active account is rendered at the top of the live quota view and separated from the remaining rows
  • The repository keeps the English-first README.md and dedicated README_CN.md
  • Homebrew distribution remains aligned with the latest release flow

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcher

pipx

pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • python3 -m py_compile codex_switcher.py
  • Windows restart support code is now part of the main branch release
  • The live quota view shows the active account first with visual separation
  • Homebrew formula now installs required Python build backend dependencies before installing the package

How To Use

  • Run codex-switcher
  • In the live quota view, use # to switch accounts
  • On Windows, the tool now schedules a Codex Desktop restart after a successful switch

CJFCodexSwitcher v0.1.4

25 Mar 12:33

Choose a tag to compare

CJFCodexSwitcher v0.1.4

This release adds a direct add-account flow to the live quota view and consolidates the latest onboarding and live-view UX improvements already shipped before the v0.1.4 tag.

Highlights

  • A new a action is available in the live quota view to start the official codex login flow
  • Newly authenticated accounts are archived automatically and kept as the active account
  • Existing archives for the same account are updated in place instead of creating duplicate snapshots
  • Failed or canceled login attempts restore the previous ~/.codex/auth.json state
  • The active account is rendered at the top of the live quota view and visually separated from the rest
  • The public repository now defaults to an English README.md with a dedicated README_CN.md
  • Homebrew installation is part of the documented first-class install path
  • The English and Chinese READMEs now describe the Homebrew-ready add-account workflow

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcher

pipx

pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • python3 -m py_compile codex_switcher.py
  • Simulated codex login runs cover new-account archive creation, same-account archive update, and failed-login rollback
  • The live quota view now shows a as the add-account action
  • The active account is shown first in the live quota view with separation before the remaining rows
  • Homebrew installation and upgrade path have been validated for the documented formula

Note

Windows automatic restart support has landed on main after v0.1.4 and will be described in the next release note instead of being backfilled into this tag.

How To Use

  • Run codex-switcher
  • In the live quota view, press a to start the official login flow
  • After login completes, return to the quota list and confirm the new account appears as [当前]

CJFCodexSwitcher v0.1.3

25 Mar 11:12

Choose a tag to compare

CJFCodexSwitcher v0.1.3

This release focuses on making the live account view easier to understand and aligning the public repository docs with the latest onboarding pattern.

Highlights

  • The active account is rendered at the top of the live account view
  • The active account is visually separated from the remaining rows
  • The public repository now uses an English-first README.md
  • A dedicated Chinese document is available in README_CN.md
  • Homebrew installation hardening is included for better end-user setup reliability

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew install cjfcodexswitcher

pipx

pipx install git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • codex-switcher --list --json still follows the remaining-count ranking rule
  • The live TUI shows the active account first with visual separation
  • The English README is now the default GitHub landing page
  • README_CN.md provides the Simplified Chinese version
  • Homebrew bootstrap logic now installs required Python build backend dependencies before installing the package

How To Use

  • End users: run codex-switcher
  • Agents: prefer codex-switcher --list --json and codex-switcher --best --json
  • For direct switching: use codex-switcher --switch best

CJFCodexSwitcher v0.1.2

25 Mar 10:39

Choose a tag to compare

CJFCodexSwitcher v0.1.2

这个版本聚焦查看余量页面的排序与交互优化。

Highlights

  • 账号列表排序改为:
    • 先按 5 小时剩余数量降序
    • 相同再按每周剩余数量降序
  • 刷新完成后会清屏重绘,最终界面不再保留进度条历史
  • 当前账号如果还没有存档,会在进入查看余量页时自动创建存档
  • 查看余量页不再依赖手动输入 S 存档当前账号

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew install cjfcodexswitcher

pipx

pipx install git+https://github.com/mileson/CJFCodexSwitcher.git

Verification

  • 交互页面已验证:
    • 刷新完成后最终界面仅显示列表和操作面板
    • 当前账号未存档时会自动创建存档
  • codex-switcher --list --json 已验证符合新的排序规则
  • openspec validate improve-live-view-ranking-and-autosave 已通过

How To Use

  • 新手用户:直接运行 codex-switcher
  • Agent:优先使用 codex-switcher --list --jsoncodex-switcher --best --json
  • 如果需要切换到最佳账号:运行 codex-switcher --switch best

CJFCodexSwitcher v0.1.1

25 Mar 10:01

Choose a tag to compare

CJFCodexSwitcher v0.1.1

这个版本用于收敛首个公开仓库的对外展示和分发体验。

Highlights

  • README 升级为简体中文|English 双语结构
  • 新增仓库徽章与产品截图
  • 新增一句命令的 Homebrew / pipx 安装方式
  • 从公开仓库当前版本中移除 openspec/ 内容
  • 保留项目内 Skill,继续指导用户与 Agent 使用工具

Installation

Homebrew

brew tap mileson/cjfcodexswitcher && brew install cjfcodexswitcher

pipx

pipx install git+https://github.com/mileson/CJFCodexSwitcher.git

pip

python3 -m pip install "git+https://github.com/mileson/CJFCodexSwitcher.git"

Verification

  • README 顶部徽章可见
  • README 截图可访问
  • Homebrew tap 可被识别
  • brew info cjfcodexswitcher 正常返回 stable 0.1.1
  • brew reinstall cjfcodexswitcher 已在本机完整通过,最终安装版本为 0.1.1
  • Python 打包入口可用
  • 公开仓库当前版本已不再包含 openspec/ 内容

How To Use

  • 新手用户:直接运行 codex-switcher
  • Agent:优先使用 codex-switcher --list --jsoncodex-switcher --best --json
  • 需要直接切换:运行 codex-switcher --switch best