Skip to content

README.md

Latest commit

 

History

History
164 lines (116 loc) · 4.58 KB

README.md

File metadata and controls

164 lines (116 loc) · 4.58 KB
Raw

CJFCodexSwitcher

Fast switching and quota inspection for multiple Codex accounts.

简体中文

Release License Python Homebrew GitHub Stars Last Commit Downloads

CJFCodexSwitcher Screenshot

What It Does

CJFCodexSwitcher is a CLI/TUI tool for people who use multiple Codex accounts and need to:

  • inspect live 5-hour and weekly quota windows
  • switch accounts quickly from a ranked list
  • automate account selection through stable non-interactive CLI commands

Features

  • Direct startup into the live account list
  • Active account shown at the top and separated from the rest
  • Live refresh of quota windows and reset times
  • Automatic snapshot save for the current account when needed
  • Add a new account directly from the quota view via the official codex login flow
  • Agent-friendly CLI: --list, --json, --best, --switch, --save-current
  • Homebrew and pipx friendly distribution
  • Repository-local skill for guided agent usage

Tech Stack

Layer Technology
Runtime Python 3
Network Python stdlib urllib
Packaging pyproject.toml + setuptools
UI Terminal TUI

One-Line Install

brew tap mileson/cjfcodexswitcher && brew install cjfcodexswitcher
pipx install git+https://github.com/mileson/CJFCodexSwitcher.git

If you do not use pipx:

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

Quick Start

Requirements:

  • Python 3.8+
  • A working codex CLI on your machine

Install from source:

git clone https://github.com/mileson/CJFCodexSwitcher.git
cd CJFCodexSwitcher
python3 install.py
source ~/.zshrc  # or ~/.bashrc
codex-switcher

Interactive Usage

The tool opens directly into the live account view.

Key fields:

  • 邮箱: account email
  • SPACE: primary workspace / organization label for the account
  • PLAN: plan type such as TEAM
  • 5小时: 5-hour remaining amount and next reset time
  • 每周: weekly remaining amount and next reset time
  • [当前]: the active account, shown first

Bottom actions:

  • Enter: refresh current page
  • a: start the official codex login flow, then auto-save the authenticated account and keep it active
  • #: switch to the selected account
  • 0: exit the tool

Notes:

  • If the current account is not archived yet, entering the live quota view will save it automatically
  • The add-account flow reuses the official browser login from codex login; in headless environments you can use codex login --device-auth

Agent / CLI Commands

codex-switcher --list
codex-switcher --list --json
codex-switcher --best
codex-switcher --best --json
codex-switcher --switch 2
codex-switcher --switch user@example.com
codex-switcher --switch best
codex-switcher --switch best --json
codex-switcher --save-current
codex-switcher --refresh

Ranking rule:

  1. Sort by 5-hour remaining count descending
  2. If tied, sort by weekly remaining count descending
  3. Use email ascending as the final tie-breaker

Agent Prompt

Use the repository-local skill:

/Users/mileson/codex-switcher/.codex/skills/codex-switcher-help/SKILL.md

Then prefer non-interactive commands such as --list --json, --best --json, and --switch best --json.

Project Structure

CJFCodexSwitcher/
├── codex_switcher.py
├── codex-switcher.py
├── install.py
├── pyproject.toml
├── README.md
├── README_CN.md
├── .codex/skills/codex-switcher-help/
└── docs/

Security

See SECURITY.md.

Contributing

See CONTRIBUTING.md.

Release

Current recommended release notes:

License

MIT