Releases: mileson/CodexSwitcher
CJFCodexSwitcher v0.1.10
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
SPACEcolumn 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 cjfcodexswitcherpipx
pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
python3 -m py_compile codex_switcher.py codex-switcher.py install.pyopenspec validate further-tighten-space-column-widthcodex-switcher --listshows a tighterSPACEcolumn while keepingSPACEbeforePLAN
How To Use
- Run
codex-switcher - Read the tighter
SPACEcolumn after the account email - Use
#to switch accounts after reviewing workspace, plan, and quota in one line
CJFCodexSwitcher v0.1.9
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
SPACEcolumn 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 cjfcodexswitcherpipx
pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
python3 -m py_compile codex_switcher.py codex-switcher.py install.pyopenspec validate tighten-space-column-widthcodex-switcher --listshows a visibly narrowerSPACEcolumn while keepingSPACEbeforePLAN
How To Use
- Run
codex-switcher - Read the compact
SPACEcolumn after the account email - Use
#to switch accounts after reviewing workspace, plan, and quota in one line
CJFCodexSwitcher v0.1.8
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 cjfcodexswitcherpipx
pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
python3 -m py_compile codex_switcher.py codex-switcher.py install.pyopenspec validate reorder-space-column-ahead-of-plancodex-switcher --listshowsSPACEbeforePLAN
How To Use
- Run
codex-switcher - Read the
SPACEcolumn 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
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
SPACEcolumn 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, andwheel
Installation
Homebrew
brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcherpipx
pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
python3 -m py_compile codex_switcher.pycodex-switcher --list --jsonincludes workspace fields such asworkspace_titleandworkspace_display- The live TUI shows the
SPACEcolumn while keeping the active-account-first layout - Homebrew formula is updated to the same release tag
How To Use
- Run
codex-switcher - Check the
SPACEcolumn to see the primary workspace label - Use
#to switch accounts and keep using the active-account-first layout
CJFCodexSwitcher v0.1.6
CJFCodexSwitcher v0.1.6
Automated release generated from tag v0.1.6.
CJFCodexSwitcher v0.1.5
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.mdand dedicatedREADME_CN.md - Homebrew distribution remains aligned with the latest release flow
Installation
Homebrew
brew tap mileson/cjfcodexswitcher && brew upgrade cjfcodexswitcherpipx
pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
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
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
aaction is available in the live quota view to start the officialcodex loginflow - 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.jsonstate - 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.mdwith a dedicatedREADME_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 cjfcodexswitcherpipx
pipx install --force git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
python3 -m py_compile codex_switcher.py- Simulated
codex loginruns cover new-account archive creation, same-account archive update, and failed-login rollback - The live quota view now shows
aas 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
ato start the official login flow - After login completes, return to the quota list and confirm the new account appears as
[当前]
CJFCodexSwitcher v0.1.3
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 cjfcodexswitcherpipx
pipx install git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
codex-switcher --list --jsonstill 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.mdprovides 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 --jsonandcodex-switcher --best --json - For direct switching: use
codex-switcher --switch best
CJFCodexSwitcher v0.1.2
CJFCodexSwitcher v0.1.2
这个版本聚焦查看余量页面的排序与交互优化。
Highlights
- 账号列表排序改为:
- 先按 5 小时剩余数量降序
- 相同再按每周剩余数量降序
- 刷新完成后会清屏重绘,最终界面不再保留进度条历史
- 当前账号如果还没有存档,会在进入查看余量页时自动创建存档
- 查看余量页不再依赖手动输入
S存档当前账号
Installation
Homebrew
brew tap mileson/cjfcodexswitcher && brew install cjfcodexswitcherpipx
pipx install git+https://github.com/mileson/CJFCodexSwitcher.gitVerification
- 交互页面已验证:
- 刷新完成后最终界面仅显示列表和操作面板
- 当前账号未存档时会自动创建存档
codex-switcher --list --json已验证符合新的排序规则openspec validate improve-live-view-ranking-and-autosave已通过
How To Use
- 新手用户:直接运行
codex-switcher - Agent:优先使用
codex-switcher --list --json和codex-switcher --best --json - 如果需要切换到最佳账号:运行
codex-switcher --switch best
CJFCodexSwitcher v0.1.1
CJFCodexSwitcher v0.1.1
这个版本用于收敛首个公开仓库的对外展示和分发体验。
Highlights
- README 升级为简体中文|English 双语结构
- 新增仓库徽章与产品截图
- 新增一句命令的 Homebrew / pipx 安装方式
- 从公开仓库当前版本中移除
openspec/内容 - 保留项目内 Skill,继续指导用户与 Agent 使用工具
Installation
Homebrew
brew tap mileson/cjfcodexswitcher && brew install cjfcodexswitcherpipx
pipx install git+https://github.com/mileson/CJFCodexSwitcher.gitpip
python3 -m pip install "git+https://github.com/mileson/CJFCodexSwitcher.git"Verification
- README 顶部徽章可见
- README 截图可访问
- Homebrew tap 可被识别
brew info cjfcodexswitcher正常返回stable 0.1.1brew reinstall cjfcodexswitcher已在本机完整通过,最终安装版本为0.1.1- Python 打包入口可用
- 公开仓库当前版本已不再包含
openspec/内容
How To Use
- 新手用户:直接运行
codex-switcher - Agent:优先使用
codex-switcher --list --json和codex-switcher --best --json - 需要直接切换:运行
codex-switcher --switch best