codex-mode 0.1.0a7__tar.gz

codex_mode-0.1.0a7/CHANGELOG.md

@@ -0,0 +1,8 @@
+# 0.1.0a7
+
+- Named ChatGPT accounts, isolated device login, credential refresh preservation,
+  identity mismatch refusal and rollback. Existing unnamed commands remain valid.
+- `speed`: isolated hello requests, equal model/effort, alternating sample order,
+  successful-sample median, bounded timeout and private sanitized diagnostics.
+- No automatic routing, task interruption, service restart or production migration.
+- Linux alpha; Codex 0.153.4 / 0.154.0 only. MIT; PyPI name ownership pending.

codex_mode-0.1.0a7/LICENSE

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

codex_mode-0.1.0a7/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md RELEASE.md SHARE.md
+include PUBLISH.md CHANGELOG.md
+recursive-include tests *.py
+exclude nr151-codex-mode.py codex_mode_accounts.py codex_mode_benchmark.py VALIDATION.md MULTIACCOUNT.md
+global-exclude *.pyc

codex_mode-0.1.0a7/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: codex-mode
+Version: 0.1.0a7
+Summary: Independent Linux tool to switch Codex ChatGPT and API routes with shared history
+Author: henrychi
+License-Expression: MIT
+Keywords: codex,cli,authentication,benchmark
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tomlkit<1,>=0.13
+Dynamic: license-file
+
+# codex-mode (Linux alpha)
+
+独立的 Codex 鉴权切换工具，不是 OpenAI 官方产品。让 ChatGPT 登录与
+Responses API 路由使用同一个 CODEX_HOME，保留聊天历史。
+
+当前版本 `0.1.0a7` 是 PyPI 候选发布包，尚未上传。Linux / Python 3.11+，
+已验证 Codex 0.153.4 / 0.154.0；不是 OpenAI 官方产品。
+
+新增命名 ChatGPT 账号和隔离测速：
+
+```bash
+codex-mode login --account second       # 保存登录，不立即启用
+codex-mode accounts
+codex-mode account-save --account first # 服务停止后，保存当前登录
+codex-mode chatgpt --account second     # 停止任务、暂停 goal、断开 Desktop 后切换
+codex-mode speed                        # hello，gpt-5.6-sol / medium，各一次
+codex-mode speed --rounds 3 --timeout 60
+```
+
+测速消耗额度/费用，使用空白临时目录，不发送旧聊天或代码，不切换当前线路。
+结果为端到端完整回复耗时，包含 CLI 启动、排队和内部重试，不是首 token 延迟。
+多轮交替顺序，并汇总成功次数和成功样本中位数；失败样本不算成功。
+上游实际模型映射无法由本工具保证，hello 结果也不代表长任务吞吐。
+ChatGPT 测试临时凭据可能触发令牌刷新；首次建议避开重要运行任务。
+命名账号共享本地历史，不能同步云端任务，也不支持同目录双账号并发。
+Python >= 3.11；仅支持 Linux。版本检查目前只接受 Codex 0.153.4 / 0.154.0；
+实验接口可能变化，其他版本需要先完成兼容验证。
+
+## 本地安装
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install .
+.venv/bin/codex-mode --version
+```
+
+不要覆盖已有稳定版的命令；先在独立虚拟环境验证。包名 `codex-mode` 暂定，
+PyPI 名称可用性、许可证、作者信息和发布账户尚待确认。
+
+## 推荐：逐步配置向导
+
+先安装 Codex 并运行一次，确保 CODEX_HOME 已有 config.toml。手动停止所有任务、
+暂停 goal，断开该机器的 Desktop；在服务器终端而不是运行中的 Codex 聊天执行：
+
+```bash
+codex-mode setup
+# 不带参数也启动向导；指定其他目录：
+codex-mode setup --state-dir /absolute/path/to/codex-home
+```
+
+六步：检查环境 → 完整备份 → 扫描历史 provider → 隐藏输入 API key 和模型名
+→ 复用或完成官方 ChatGPT 设备登录 → 隔离验证两种模式。逐步确认是否托管历史
+provider、是否发送真实测试请求、是否最终启用路由。默认不激活路由。
+旧任务只读取，不 resume、不启动 turn、不操作 goal。真实请求仅使用新建临时
+任务和固定一句话，不发送旧聊天。跳过真实请求时不会宣称实际线路可用。
+测试配置关闭 shell、unified exec 和 web search，移除生产 MCP/hooks 等设置。
+参考官方 [鉴权](https://learn.chatgpt.com/docs/auth)、
+[App Server](https://learn.chatgpt.com/docs/app-server) 和
+[配置字段](https://learn.chatgpt.com/docs/config-file/config-reference)。
+
+完整备份位于父目录/.codex-mode-backups/<目录名>-<时间>/home，含凭据、聊天、
+数据库和插件，可能占用数十 GB，不要分享。目录 0700、普通文件 0600；SQLite
+backup API 合并已提交 WAL。运行时 socket 不复制，符号链接不跟随，异常及原始
+权限记录在 manifest.json。正式向导拒绝运行中的服务；测试 live capture 不是
+跨文件一致性快照。验证只写元数据/结果，不在报告中写正文和 token。
+
+逐个检查全部任务摘要，检查置顶任务和少量样本的最新轮次内容；不是逐字校验全部
+历史，也不能保证 Desktop 每个筛选都显示所有任务。内置 openai 不覆盖，历史
+provider/source/cwd 筛选仍可能隐藏任务，需按 ID 或相应筛选打开。缺失代码目录
+会提示，工具不迁移代码。失败不启用新路由；工具配置/凭据会保留供排查，原主配置
+和鉴权保持不变。
+
+```bash
+codex-mode scan
+codex-mode restore --backup /absolute/path/to/backup-directory
+codex-mode verify --backup /absolute/path/to/backup-directory
+# 已有完整备份时重试验证，无需再次备份；加 --request-test 确认后测试真实请求
+```
+
+restore 需停止服务并确认，只还原配置和登录，先保存当前控制文件的撤销副本；不
+覆盖聊天、数据库或代码。旧登录可能需重新授权。备份中不存在的控制文件会移除，
+可从撤销副本找回。只分享 wheel 和 SHARE.md，不分享备份或真实 CODEX_HOME。
+
+## 初始化与使用
+
+先安装、初始化 Codex，确保选定 CODEX_HOME 中有 config.toml。
+默认使用环境变量 CODEX_HOME，否则使用当前用户的 ~/.codex。
+
+```bash
+# API 地址需要指向支持 Responses 的服务，不要在 URL 中放密钥。
+codex-mode init --api-url https://api.example.com/v1 --prompt-key
+# 或使用环境变量（该变量也必须对 Desktop 远程服务可见）
+codex-mode init --api-url https://api.example.com/v1 --key-env MY_CODEX_API_KEY
+
+codex-mode doctor
+codex-mode login
+codex-mode chatgpt --dry-run
+codex-mode chatgpt
+codex-mode api
+codex-mode status
+```
+
+`sub2api` 是 `api` 的兼容命令。`--state-dir DIR` 指定独立目录；
+`--codex-bin PATH` 覆盖 Codex 可执行文件；`init --codex-bin PATH` 将其保存。
+`init --import-api-key` 显式导入现有 auth.json 的 API key，不改现有鉴权。
+可选 `init --health-url URL` 启用独立健康检查，默认不假定服务有 /health。
+
+工具配置保存在 CODEX_HOME/codex-mode.json。隐藏输入的 API key 保存在
+CODEX_HOME/auth-profiles/sub2api.auth.json（0600）；不是加密保险库。
+也可使用 key_env，不保存 key 值。`_key` 是凭据读取专用内部命令，不应手动调用。
+安装路径及对应虚拟环境必须在 Codex 使用期间保持可访问，生成的凭据命令
+使用该 Python 的绝对路径和 `-m codex_mode`。
+
+## 中断与历史边界
+
+普通切换前，请手动停止正在运行的任务、暂停 goal，并断开 Desktop。
+工具只复查已加载会话是否空闲，不查询 goal，也不自动暂停或中断任务。
+空闲服务使用 SIGTERM 请求退出，最多等待 30 秒；无法确认空闲时拒绝切换。
+空闲 Desktop 代理仍在时，可用 --disconnect-idle；无法正常停止时用 --force。
+显式 `codex-mode chatgpt --force`（或 `api --force`）绕过会话查询，要求终端确认，
+先向当前用户/当前 CODEX_HOME 的既有服务与代理发送 SIGTERM，5 秒后仍未退出才
+发送 SIGKILL。需要 Python/kernel 的 Linux pidfd 支持；不会终止新出现的连接。
+force 模式不能保证未完成轮次完整保存，也不会暂停或清除 goal；外部后台进程可能
+继续运行。切换完成后重连 Desktop，启动新配置服务。force 仅适合正常切换失败时使用。
+未手动暂停的 goal 可能在重连后继续运行；工具不会改变 goal 状态。
+已中断的轮次不会自动继续，已落盘代码修改不会撤销。
+切换期间不要重新连接 Desktop 或提交新任务；外部客户端不受本工具锁约束，
+状态复查只能缩小并发窗口，不能提供跨客户端事务保证。
+
+重新连接 Desktop，在同一聊天检查进度并继续。训练、下载、nohup/systemd 等
+外部进程不受会话中断统一管理，重新运行命令前检查它们。
+
+默认只管理稳定 provider ID `direct`。历史 provider ID 不会自动统一，
+CLI 列表可能仍按 provider 过滤；`resume --all` 只取消目录筛选。
+使用 `init --provider-alias OpenAI --provider-alias sub2api` 显式允许工具在切换时
+重写这些 provider 的配置，使它们跟随所选路由。它不会改历史 JSONL 或数据库。
+这些别名原有的专有设置将被替换；其他 providers、项目设置、注释和多行值保留。
+新配置使用文件凭据存储，替代 forced_login_method；不保留 keyring-only 设置。
+
+默认日志精简，TTY 支持颜色，NO_COLOR / TERM=dumb 禁用颜色；
+`--verbose` 查看任务 ID、备份路径等。`--dry-run` 仅验证配置转换，不验证网络、
+任务状态或实际模型请求。
+
+## 网络与发布
+
+不自动配置 SSH、系统路由或中继。已有 SSH 转发可作为 api-url 指向的本地端口，
+由用户另外管理。
+
+```bash
+python -m unittest discover -s tests -v
+# 实际 Codex + 临时 CODEX_HOME + loopback 模拟 API，不使用真实凭据：
+python tests/integration_smoke.py /absolute/path/to/codex
+python -m build
+python -m twine check dist/*
+# 先确认名称/许可证/账号，再手动上传 TestPyPI；不要上传凭据或历史。
+# python -m twine upload --repository testpypi dist/*
+```
+
+发布前待办见 RELEASE.md。安装不会读取或修改实际 Codex 登录；init 只更改
+工具自己的配置/凭据，mode 命令才执行切换并备份 config.toml/auth.json。

codex_mode-0.1.0a7/PUBLISH.md

@@ -0,0 +1,46 @@
+# 发布与迁移
+
+当前候选版本 0.1.0a7，MIT，署名 henrychi，尚未上传。公开前确认包名及账号权限。
+
+## 发布（维护者）
+
+1. 注册 PyPI 和 TestPyPI（两个站点账号独立），验证邮箱，开启 2FA。
+2. 确认包名可用/属于自己；页面不存在不保证包名可注册。
+3. 本版已写入 MIT 许可证与署名；修改后必须重新构建、测试。
+4. 在发布虚拟环境执行：
+
+```bash
+python -m build --outdir release/0.1.0a7
+python -m twine check release/0.1.0a7/*
+python -m twine upload --repository testpypi release/0.1.0a7/*
+```
+
+上传使用站点 API token：用户名 `__token__`，密码提示中粘贴 token。
+不要把 token 写入命令、代码或发到聊天。正式 PyPI 和 TestPyPI token 不通用。
+未来可用 Trusted Publishing 避免长期 token。
+
+在新虚拟环境先从正式 PyPI 安装依赖 tomlkit，再仅从 TestPyPI 安装候选包：
+
+```bash
+python -m pip install 'tomlkit>=0.13,<1'
+python -m pip install --index-url https://test.pypi.org/simple/ --no-deps codex-mode==0.1.0a7
+codex-mode --version
+codex-mode --help
+```
+
+完成隔离验证后，再执行 `python -m twine upload release/0.1.0a7/*`。
+只上传此版本目录，不上传 dist 中旧包或分享 ZIP。已上传文件名不能重用；
+修复后递增版本。alpha 版安装需指定版本或使用 --pre。
+
+## NR151 迁移（任务停止后，由我们处理）
+
+无需删除 CODEX_HOME 或聊天。保留现用脚本及入口作为回滚备份。
+先独立安装 wheel/PyPI 包到新虚拟环境，确认入口、版本和隔离测试通过，
+再原子替换 codex-mode 入口；不修改 Codex 本身的安装。
+用 init 显式登记原有 API 地址、中继健康地址、Codex 路径、历史 provider 别名。
+现有 API key 文件可继续读取，无需重新输入或分享。
+迁移时只备份并调整工具配置；不得覆盖聊天数据库、账号登录或启动旧任务。
+当前 stable 脚本 1.5.0 与 package 0.1.0a7 是两套版本号，功能统一后只维护包。
+
+参考：https://packaging.python.org/en/latest/tutorials/packaging-projects/
+PyPI：https://pypi.org/help/

codex_mode-0.1.0a7/README.md

@@ -0,0 +1,160 @@
+# codex-mode (Linux alpha)
+
+独立的 Codex 鉴权切换工具，不是 OpenAI 官方产品。让 ChatGPT 登录与
+Responses API 路由使用同一个 CODEX_HOME，保留聊天历史。
+
+当前版本 `0.1.0a7` 是 PyPI 候选发布包，尚未上传。Linux / Python 3.11+，
+已验证 Codex 0.153.4 / 0.154.0；不是 OpenAI 官方产品。
+
+新增命名 ChatGPT 账号和隔离测速：
+
+```bash
+codex-mode login --account second       # 保存登录，不立即启用
+codex-mode accounts
+codex-mode account-save --account first # 服务停止后，保存当前登录
+codex-mode chatgpt --account second     # 停止任务、暂停 goal、断开 Desktop 后切换
+codex-mode speed                        # hello，gpt-5.6-sol / medium，各一次
+codex-mode speed --rounds 3 --timeout 60
+```
+
+测速消耗额度/费用，使用空白临时目录，不发送旧聊天或代码，不切换当前线路。
+结果为端到端完整回复耗时，包含 CLI 启动、排队和内部重试，不是首 token 延迟。
+多轮交替顺序，并汇总成功次数和成功样本中位数；失败样本不算成功。
+上游实际模型映射无法由本工具保证，hello 结果也不代表长任务吞吐。
+ChatGPT 测试临时凭据可能触发令牌刷新；首次建议避开重要运行任务。
+命名账号共享本地历史，不能同步云端任务，也不支持同目录双账号并发。
+Python >= 3.11；仅支持 Linux。版本检查目前只接受 Codex 0.153.4 / 0.154.0；
+实验接口可能变化，其他版本需要先完成兼容验证。
+
+## 本地安装
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install .
+.venv/bin/codex-mode --version
+```
+
+不要覆盖已有稳定版的命令；先在独立虚拟环境验证。包名 `codex-mode` 暂定，
+PyPI 名称可用性、许可证、作者信息和发布账户尚待确认。
+
+## 推荐：逐步配置向导
+
+先安装 Codex 并运行一次，确保 CODEX_HOME 已有 config.toml。手动停止所有任务、
+暂停 goal，断开该机器的 Desktop；在服务器终端而不是运行中的 Codex 聊天执行：
+
+```bash
+codex-mode setup
+# 不带参数也启动向导；指定其他目录：
+codex-mode setup --state-dir /absolute/path/to/codex-home
+```
+
+六步：检查环境 → 完整备份 → 扫描历史 provider → 隐藏输入 API key 和模型名
+→ 复用或完成官方 ChatGPT 设备登录 → 隔离验证两种模式。逐步确认是否托管历史
+provider、是否发送真实测试请求、是否最终启用路由。默认不激活路由。
+旧任务只读取，不 resume、不启动 turn、不操作 goal。真实请求仅使用新建临时
+任务和固定一句话，不发送旧聊天。跳过真实请求时不会宣称实际线路可用。
+测试配置关闭 shell、unified exec 和 web search，移除生产 MCP/hooks 等设置。
+参考官方 [鉴权](https://learn.chatgpt.com/docs/auth)、
+[App Server](https://learn.chatgpt.com/docs/app-server) 和
+[配置字段](https://learn.chatgpt.com/docs/config-file/config-reference)。
+
+完整备份位于父目录/.codex-mode-backups/<目录名>-<时间>/home，含凭据、聊天、
+数据库和插件，可能占用数十 GB，不要分享。目录 0700、普通文件 0600；SQLite
+backup API 合并已提交 WAL。运行时 socket 不复制，符号链接不跟随，异常及原始
+权限记录在 manifest.json。正式向导拒绝运行中的服务；测试 live capture 不是
+跨文件一致性快照。验证只写元数据/结果，不在报告中写正文和 token。
+
+逐个检查全部任务摘要，检查置顶任务和少量样本的最新轮次内容；不是逐字校验全部
+历史，也不能保证 Desktop 每个筛选都显示所有任务。内置 openai 不覆盖，历史
+provider/source/cwd 筛选仍可能隐藏任务，需按 ID 或相应筛选打开。缺失代码目录
+会提示，工具不迁移代码。失败不启用新路由；工具配置/凭据会保留供排查，原主配置
+和鉴权保持不变。
+
+```bash
+codex-mode scan
+codex-mode restore --backup /absolute/path/to/backup-directory
+codex-mode verify --backup /absolute/path/to/backup-directory
+# 已有完整备份时重试验证，无需再次备份；加 --request-test 确认后测试真实请求
+```
+
+restore 需停止服务并确认，只还原配置和登录，先保存当前控制文件的撤销副本；不
+覆盖聊天、数据库或代码。旧登录可能需重新授权。备份中不存在的控制文件会移除，
+可从撤销副本找回。只分享 wheel 和 SHARE.md，不分享备份或真实 CODEX_HOME。
+
+## 初始化与使用
+
+先安装、初始化 Codex，确保选定 CODEX_HOME 中有 config.toml。
+默认使用环境变量 CODEX_HOME，否则使用当前用户的 ~/.codex。
+
+```bash
+# API 地址需要指向支持 Responses 的服务，不要在 URL 中放密钥。
+codex-mode init --api-url https://api.example.com/v1 --prompt-key
+# 或使用环境变量（该变量也必须对 Desktop 远程服务可见）
+codex-mode init --api-url https://api.example.com/v1 --key-env MY_CODEX_API_KEY
+
+codex-mode doctor
+codex-mode login
+codex-mode chatgpt --dry-run
+codex-mode chatgpt
+codex-mode api
+codex-mode status
+```
+
+`sub2api` 是 `api` 的兼容命令。`--state-dir DIR` 指定独立目录；
+`--codex-bin PATH` 覆盖 Codex 可执行文件；`init --codex-bin PATH` 将其保存。
+`init --import-api-key` 显式导入现有 auth.json 的 API key，不改现有鉴权。
+可选 `init --health-url URL` 启用独立健康检查，默认不假定服务有 /health。
+
+工具配置保存在 CODEX_HOME/codex-mode.json。隐藏输入的 API key 保存在
+CODEX_HOME/auth-profiles/sub2api.auth.json（0600）；不是加密保险库。
+也可使用 key_env，不保存 key 值。`_key` 是凭据读取专用内部命令，不应手动调用。
+安装路径及对应虚拟环境必须在 Codex 使用期间保持可访问，生成的凭据命令
+使用该 Python 的绝对路径和 `-m codex_mode`。
+
+## 中断与历史边界
+
+普通切换前，请手动停止正在运行的任务、暂停 goal，并断开 Desktop。
+工具只复查已加载会话是否空闲，不查询 goal，也不自动暂停或中断任务。
+空闲服务使用 SIGTERM 请求退出，最多等待 30 秒；无法确认空闲时拒绝切换。
+空闲 Desktop 代理仍在时，可用 --disconnect-idle；无法正常停止时用 --force。
+显式 `codex-mode chatgpt --force`（或 `api --force`）绕过会话查询，要求终端确认，
+先向当前用户/当前 CODEX_HOME 的既有服务与代理发送 SIGTERM，5 秒后仍未退出才
+发送 SIGKILL。需要 Python/kernel 的 Linux pidfd 支持；不会终止新出现的连接。
+force 模式不能保证未完成轮次完整保存，也不会暂停或清除 goal；外部后台进程可能
+继续运行。切换完成后重连 Desktop，启动新配置服务。force 仅适合正常切换失败时使用。
+未手动暂停的 goal 可能在重连后继续运行；工具不会改变 goal 状态。
+已中断的轮次不会自动继续，已落盘代码修改不会撤销。
+切换期间不要重新连接 Desktop 或提交新任务；外部客户端不受本工具锁约束，
+状态复查只能缩小并发窗口，不能提供跨客户端事务保证。
+
+重新连接 Desktop，在同一聊天检查进度并继续。训练、下载、nohup/systemd 等
+外部进程不受会话中断统一管理，重新运行命令前检查它们。
+
+默认只管理稳定 provider ID `direct`。历史 provider ID 不会自动统一，
+CLI 列表可能仍按 provider 过滤；`resume --all` 只取消目录筛选。
+使用 `init --provider-alias OpenAI --provider-alias sub2api` 显式允许工具在切换时
+重写这些 provider 的配置，使它们跟随所选路由。它不会改历史 JSONL 或数据库。
+这些别名原有的专有设置将被替换；其他 providers、项目设置、注释和多行值保留。
+新配置使用文件凭据存储，替代 forced_login_method；不保留 keyring-only 设置。
+
+默认日志精简，TTY 支持颜色，NO_COLOR / TERM=dumb 禁用颜色；
+`--verbose` 查看任务 ID、备份路径等。`--dry-run` 仅验证配置转换，不验证网络、
+任务状态或实际模型请求。
+
+## 网络与发布
+
+不自动配置 SSH、系统路由或中继。已有 SSH 转发可作为 api-url 指向的本地端口，
+由用户另外管理。
+
+```bash
+python -m unittest discover -s tests -v
+# 实际 Codex + 临时 CODEX_HOME + loopback 模拟 API，不使用真实凭据：
+python tests/integration_smoke.py /absolute/path/to/codex
+python -m build
+python -m twine check dist/*
+# 先确认名称/许可证/账号，再手动上传 TestPyPI；不要上传凭据或历史。
+# python -m twine upload --repository testpypi dist/*
+```
+
+发布前待办见 RELEASE.md。安装不会读取或修改实际 Codex 登录；init 只更改
+工具自己的配置/凭据，mode 命令才执行切换并备份 config.toml/auth.json。

codex_mode-0.1.0a7/RELEASE.md

@@ -0,0 +1,23 @@
+# Release candidate checklist
+
+Prepared: Linux alpha package, configurable endpoint/state/binary, optional health
+check, file/env credentials, format-preserving TOML changes, console entry point,
+manual-stop switching, explicit force shutdown and regression tests.
+
+Before a public release:
+
+- Confirm distribution name ownership/availability; current name is provisional.
+- MIT confirmed; attribution henrychi. LICENSE and SPDX metadata included.
+- Configure a PyPI/TestPyPI account or trusted publisher; never commit tokens.
+- Review the archive contents for private paths, credentials and conversation data.
+- Validate TestPyPI install in a clean environment before uploading to PyPI.
+- Add CI and broader verified Codex version coverage before calling this stable.
+
+This project is independent, not endorsed by OpenAI. The package includes only
+source/tests/docs/metadata, not the machine's CODEX_HOME or SSH relay credentials.
+
+0.1.0a7 candidate validation: clean wheel installation; 97 tests (95 passed,
+2 skipped for unavailable pidfd); twine checks passed for wheel and sdist;
+archive privacy scan passed. Isolated ChatGPT hello completed in 8.44 seconds
+with requested gpt-5.6-sol / medium. Live API benchmark and installed NR151
+package migration are pending; do not describe both routes as live-verified yet.

codex_mode-0.1.0a7/SHARE.md

@@ -0,0 +1,48 @@
+# codex-mode 快速使用
+
+Linux 内部试用版，Python 3.11+，支持 Codex 0.153.4 / 0.154.0。
+Desktop SSH 用户在服务器安装；先运行一次 Codex，完成初始化。
+
+## 安装与配置
+
+解压分享包，在解压目录执行（需联网安装依赖）：
+
+```bash
+python3 -m venv "$HOME/.local/share/codex-mode-venv"
+"$HOME/.local/share/codex-mode-venv/bin/python" -m pip install ./codex_mode-0.1.0a7-py3-none-any.whl
+export PATH="$HOME/.local/share/codex-mode-venv/bin:$PATH"
+codex-mode setup
+```
+
+配置前停止任务、暂停 goal、断开 Desktop，并清理 OPENAI_API_KEY /
+OPENAI_BASE_URL 等覆盖变量。准备 Responses API 地址、自己的 key 和支持的模型名。
+向导会备份、扫描历史、引导登录并验证；真实请求测试可选，可能计费。
+目录不是 ~/.codex 时，命令添加 `--state-dir /absolute/path/to/codex-home`。
+
+## 日常切换
+
+先停止任务、暂停 goal、断开 Desktop，然后执行：
+
+```bash
+codex-mode api       # API
+codex-mode chatgpt   # ChatGPT
+codex-mode speed     # 相同模型的 hello 完整响应耗时，真实请求可能计费
+```
+
+重连后在原任务继续。新终端需重新执行上面的 export PATH；不要移动或删除安装环境。
+正常退出失败才用 `--force`：需要 Linux pidfd 支持，可能丢失未保存输出，
+不暂停 goal，也不停止训练、下载等外部进程。
+
+## 故障处理与安全
+
+```bash
+codex-mode verify --backup <备份目录>   # 重试验证；加 --request-test 测试真实请求
+codex-mode restore --backup <备份目录>  # 停止服务后恢复配置，不覆盖聊天或代码
+```
+
+- 切换影响整个 CODEX_HOME；聊天保留不保证所有客户端筛选都显示。
+- 备份可能很大且含凭据，API key 文件为明文；不要分享备份、鉴权或聊天。
+- 第三方 API 会接收实际任务上下文和代码，先确认公司政策；优先用 HTTPS。
+- 工具不是 OpenAI 官方产品；网络中继另配，上游 overload 不由它修复。
+- 多账号：login --account NAME 保存；accounts 查看；chatgpt --account NAME 切换。
+- 测速不切换线路，包含 CLI 启动与重试；临时 ChatGPT 凭据可能刷新，首次避开重要任务。

codex_mode-0.1.0a7/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "codex-mode"
+version = "0.1.0a7"
+description = "Independent Linux tool to switch Codex ChatGPT and API routes with shared history"
+keywords = ["codex", "cli", "authentication", "benchmark"]
+authors = [{name = "henrychi"}]
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = ["tomlkit>=0.13,<1"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+]
+
+[project.scripts]
+codex-mode = "codex_mode.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = false

codex_mode-0.1.0a7/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

codex_mode-0.1.0a7/src/codex_mode/__init__.py

@@ -0,0 +1,2 @@
+"""Independent Linux utility for switching Codex authentication routes."""
+__version__ = '0.1.0a7'

codex_mode-0.1.0a7/src/codex_mode/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

codex_mode-0.1.0a7/src/codex_mode/accounts.py

@@ -0,0 +1,91 @@
+"""Named ChatGPT credentials; history stays in the selected CODEX_HOME."""
+import json
+import re
+from . import engine as e
+
+def path(root, name, create=True):
+    if not re.fullmatch(r'[A-Za-z0-9][A-Za-z0-9_-]{0,63}', name):
+        raise ValueError('账号名仅允许字母、数字、横线和下划线，最长 64 字符。')
+    folder=root/'auth-profiles'/'accounts'
+    if (root/'auth-profiles').is_symlink() or folder.is_symlink():
+        raise RuntimeError('账号目录不能是符号链接。')
+    if create:folder.mkdir(parents=True,mode=0o700,exist_ok=True)
+    target=folder/(name+'.json')
+    if target.is_symlink():raise RuntimeError('账号文件不能是符号链接。')
+    return target
+
+def identity(auth):
+    return (auth.get('tokens') or {}).get('account_id')
+
+def save(root, name):
+    auth=e.read_auth(root/'auth.json')
+    if not e.chat_auth(auth):raise RuntimeError('当前目录没有 ChatGPT 登录。')
+    target=path(root,name)
+    if target.exists():raise RuntimeError('账号名已存在，请使用新名称，避免覆盖凭据。')
+    e.atomic(target,json.dumps(auth))
+    settings=e.read_auth(root/'codex-mode.json')
+    settings['active_account']=name
+    e.atomic(root/'codex-mode.json',json.dumps(settings))
+    e.say('✓ 当前登录已保存为 '+name+'（未切换线路）。','ok')
+
+def login(root,name):
+    target=path(root,name)
+    if target.exists():raise RuntimeError('账号名已存在，请使用新名称。')
+    # Official login runs in an empty staging home, never the active home.
+    import tempfile
+    import shutil
+    staging=e.Path(tempfile.mkdtemp(prefix='account-login-',dir=target.parent))
+    try:
+        e.atomic(staging/'config.toml','model_provider="openai"\ncli_auth_credentials_store="file"\n')
+        result=e.subprocess.run([e.BIN,'login','--device-auth'],env=e.codex_env(staging))
+        if result.returncode:raise RuntimeError('登录未完成，当前登录未修改。')
+        auth=e.read_auth(staging/'auth.json')
+        if not e.chat_auth(auth):raise RuntimeError('未获得 ChatGPT 登录凭据。')
+        e.atomic(target,json.dumps(auth))
+        e.say('✓ 已保存账号 '+name+'；尚未启用。','ok')
+    finally:shutil.rmtree(staging)
+
+def listing(root):
+    settings=e.read_auth(root/'codex-mode.json')
+    folder=root/'auth-profiles'/'accounts'
+    if folder.is_symlink():raise RuntimeError('账号目录不能是符号链接。')
+    names=sorted(p.stem for p in folder.glob('*.json') if not p.is_symlink())
+    for name in names:
+        print(name+(' · 当前选中' if name==settings.get('active_account') else ''))
+    if not names:print('尚无命名账号。运行 login --account NAME。')
+
+def switch(root,name,force=False,disconnect_idle=False):
+    target=path(root,name)
+    selected=e.read_auth(target)
+    if not e.chat_auth(selected):raise RuntimeError('账号未登录：'+name)
+    # Stop only servers associated with this home, before changing any credentials.
+    if force:e.force_stop(root)
+    else:e.ensure_idle(root,disconnect_idle=disconnect_idle,allow_interrupt=False)
+    originals={p:p.read_bytes() if p.exists() else None for p in
+               (root/'auth.json',root/'codex-mode.json',root/'config.toml',root/'auth-profiles'/'chatgpt.auth.json')}
+    settings=e.read_auth(root/'codex-mode.json')
+    current=e.read_auth(root/'auth.json')
+    old=settings.get('active_account')
+    if not old and e.chat_auth(current):
+        # Preserve the pre-existing login when adopting named accounts.
+        old='previous-'+e.datetime.datetime.now().strftime('%Y%m%d-%H%M%S-%f')
+        e.atomic(path(root,old),json.dumps(current))
+    if old and e.chat_auth(current):
+        previous=path(root,old)
+        stored=e.read_auth(previous)
+        if not identity(current) or identity(current)!=identity(stored):
+            raise RuntimeError('当前登录与记录账号不一致，已取消，避免覆盖其他账号。')
+        e.atomic(previous,json.dumps(current))
+    # Reload: switching to the same account must use refreshed credentials.
+    selected=e.read_auth(target)
+    try:
+        e.atomic(root/'auth.json',json.dumps(selected))
+        e.switch(root,'chatgpt',disconnect_idle=disconnect_idle,force=False)
+        settings['active_account']=name
+        e.atomic(root/'codex-mode.json',json.dumps(settings))
+    except BaseException:
+        for p,data in originals.items():
+            if data is None:p.unlink(missing_ok=True)
+            else:e.atomic(p,data)
+        raise
+    e.say('账号：'+name)