@openxiaobu/codexl 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,164 @@
+# codexl
+
+Local multi-account / multi-workspace switcher for Codex.
+
+`codexl` 是一个本地 `Codex` 多账号 / 多工作空间切换器。
+
+## Overview
+
+English:
+
+- Reuse the official `~/.codex` login state
+- Manage multiple accounts or workspaces as separate slots
+- Fetch the latest usage from the official usage endpoint
+- Expose a local provider endpoint for Codex
+- Apply local cooldown rules for temporary, 5-hour, and weekly limits
+
+中文：
+
+- 复用官方 `~/.codex` 登录态
+- 将多个账号或工作空间作为独立槽位管理
+- 直接调用官方 usage 接口获取最新额度
+- 暴露本地 provider 给 `Codex` 使用
+- 对临时限流、5 小时限制、周限制做本地熔断
+
+## Install
+
+```bash
+npm i -g @openxiaobu/codexl
+```
+
+Verify:
+
+```bash
+codexl --help
+```
+
+## Quick Start
+
+1. Import your current Codex login state
+
+```bash
+codexl import current ~
+```
+
+2. Check latest usage
+
+```bash
+codexl status
+```
+
+3. Start the local proxy
+
+```bash
+codexl start
+```
+
+Custom port:
+
+```bash
+codexl start --port 4399
+```
+
+4. Show current local endpoint and key
+
+```bash
+codexl get
+```
+
+5. Write provider config into `~/.codex/config.toml`
+
+```bash
+codexl config
+```
+
+## Commands
+
+```bash
+codexl add <name>
+codexl del <name>
+codexl import <name> [HOME]
+codexl status
+codexl start [--port <port>]
+codexl stop
+codexl get
+codexl config [codexPath]
+```
+
+More details: [HELP.md](./HELP.md)
+
+## How `status` Works
+
+English:
+
+1. Read `access_token` / `refresh_token` / `account_id` from the official Codex login state
+2. Request `https://chatgpt.com/backend-api/wham/usage`
+3. Store the latest result in `~/.codexl/state.json`
+4. Render the latest local cache
+
+中文：
+
+1. 从官方登录态中读取 `access_token` / `refresh_token` / `account_id`
+2. 请求 `https://chatgpt.com/backend-api/wham/usage`
+3. 将最新结果写入 `~/.codexl/state.json`
+4. 最后读取本地最新缓存进行展示
+
+## Generated Codex Config
+
+`codexl config` writes a managed provider block like this:
+
+```toml
+# >>> codexl managed start >>>
+[model_providers.codexl]
+name = "codexl"
+base_url = "http://127.0.0.1:4389/v1"
+http_headers = { Authorization = "Bearer codexl-defaultkey" }
+wire_api = "responses"
+# <<< codexl managed end <<<
+```
+
+Rules:
+
+- If `[model_providers.codexl]` already exists, it is replaced
+- If global `model_provider` exists, it is changed to `codexl`
+- If commented `# model_provider = ...` exists, it is reopened as `model_provider = "codexl"`
+- Global `model` is kept unchanged
+- If you start with `--port`, the port is saved to `~/.codexl/config.yaml`, and later `get` / `config` will use that port
+
+## Data Directory
+
+`codexl` uses:
+
+- `~/.codexl/config.yaml`
+- `~/.codexl/state.json`
+- `~/.codexl/codexl.pid`
+- `~/.codexl/logs/service.log`
+
+If you previously used `~/.codexsw`, it will be migrated automatically.
+
+## Limit Handling
+
+English:
+
+- Weekly limit: blocked until weekly reset time
+- 5-hour limit: blocked until 5-hour reset time
+- Temporary limit: blocked for 5 minutes
+
+中文：
+
+- 周限制：禁用到周窗口重置时间
+- 5 小时限制：禁用到 5 小时窗口重置时间
+- 临时限流：先禁用 5 分钟
+
+## Repository
+
+- GitHub: https://github.com/openxiaobu/codexl
+- Issues: https://github.com/openxiaobu/codexl/issues
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run check
+```

package/dist/account-store.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCodexDataDir = getCodexDataDir;
+exports.readRegistry = readRegistry;
+exports.readAuthFile = readAuthFile;
+exports.writeAuthFile = writeAuthFile;
+exports.resolvePrimaryRegistryAccount = resolvePrimaryRegistryAccount;
+exports.registerManagedAccount = registerManagedAccount;
+exports.removeManagedAccount = removeManagedAccount;
+exports.findManagedAccount = findManagedAccount;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const config_1 = require("./config");
+/**
+ * 读取指定账号 HOME 下的 `.codex` 目录。
+ *
+ * @param codexHome 账号独立 HOME 目录。
+ * @returns `.codex` 目录绝对路径。
+ */
+function getCodexDataDir(codexHome) {
+    return node_path_1.default.join((0, config_1.expandHome)(codexHome), ".codex");
+}
+/**
+ * 读取某账号对应的 `registry.json`。
+ *
+ * @param codexHome 账号独立 HOME 目录。
+ * @returns 解析后的 registry；不存在时返回 `null`。
+ */
+function readRegistry(codexHome) {
+    const registryPath = node_path_1.default.join(getCodexDataDir(codexHome), "accounts", "registry.json");
+    if (!node_fs_1.default.existsSync(registryPath)) {
+        return null;
+    }
+    return JSON.parse(node_fs_1.default.readFileSync(registryPath, "utf8"));
+}
+/**
+ * 读取账号目录下当前激活凭据文件。
+ *
+ * @param codexHome 账号独立 HOME 目录。
+ * @returns 解析后的 auth.json；不存在时返回 `null`。
+ */
+function readAuthFile(codexHome) {
+    const authPath = node_path_1.default.join(getCodexDataDir(codexHome), "auth.json");
+    if (!node_fs_1.default.existsSync(authPath)) {
+        return null;
+    }
+    return JSON.parse(node_fs_1.default.readFileSync(authPath, "utf8"));
+}
+/**
+ * 将最新认证信息回写到指定账号的 `auth.json`。
+ *
+ * @param codexHome 账号独立 HOME 目录。
+ * @param auth 最新认证信息。
+ * @returns 无返回值。
+ */
+function writeAuthFile(codexHome, auth) {
+    const authPath = node_path_1.default.join(getCodexDataDir(codexHome), "auth.json");
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(authPath), { recursive: true });
+    node_fs_1.default.writeFileSync(authPath, `${JSON.stringify(auth, null, 2)}\n`, "utf8");
+}
+/**
+ * 根据当前账号目录中的 registry 推断主账号信息。
+ *
+ * @param codexHome 账号独立 HOME 目录。
+ * @returns 当前活跃账号元数据；无可用账号时返回 `null`。
+ */
+function resolvePrimaryRegistryAccount(codexHome) {
+    const registry = readRegistry(codexHome);
+    if (!registry || registry.accounts.length === 0) {
+        return null;
+    }
+    if (registry.active_email) {
+        const active = registry.accounts.find((item) => item.email === registry.active_email);
+        if (active) {
+            return active;
+        }
+    }
+    return registry.accounts[0] ?? null;
+}
+/**
+ * 将账号注册到 codexl 配置中，并为其准备独立 HOME 目录。
+ *
+ * @param accountId 本地账号标识。
+ * @param codexHome 可选的自定义 HOME 目录；未提供时使用默认路径。
+ * @returns 写入后的账号配置。
+ */
+function registerManagedAccount(accountId, codexHome) {
+    const home = codexHome ? (0, config_1.expandHome)(codexHome) : (0, config_1.getManagedHome)(accountId);
+    // 预先创建账号隔离目录，方便后续直接执行 codex login。
+    node_fs_1.default.mkdirSync(home, { recursive: true });
+    const primary = resolvePrimaryRegistryAccount(home);
+    const account = {
+        id: accountId,
+        name: accountId,
+        codex_home: home,
+        email: primary?.email,
+        enabled: true,
+        imported_at: new Date().toISOString()
+    };
+    (0, config_1.upsertAccount)(account);
+    return account;
+}
+/**
+ * 从配置中删除指定账号；默认仅删除配置项，不主动删除本地 HOME 目录。
+ *
+ * @param accountId 本地账号标识。
+ * @returns 被删除的账号配置；未命中时返回 `null`。
+ */
+function removeManagedAccount(accountId) {
+    const config = (0, config_1.loadConfig)();
+    const index = config.accounts.findIndex((item) => item.id === accountId);
+    if (index < 0) {
+        return null;
+    }
+    const [removed] = config.accounts.splice(index, 1);
+    (0, config_1.saveConfig)(config);
+    return removed ?? null;
+}
+/**
+ * 根据账号标识读取配置中的账号项。
+ *
+ * @param accountId 本地账号标识。
+ * @returns 命中的账号配置；未命中时返回 `null`。
+ */
+function findManagedAccount(accountId) {
+    const config = (0, config_1.loadConfig)();
+    return config.accounts.find((item) => item.id === accountId) ?? null;
+}

package/dist/cli.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const commander_1 = require("commander");
+const account_store_1 = require("./account-store");
+const config_1 = require("./config");
+const login_1 = require("./login");
+const status_1 = require("./status");
+const usage_sync_1 = require("./usage-sync");
+/**
+ * 刷新所有已录入账号的远端额度，并输出最新状态表格。
+ *
+ * @returns Promise，无返回值。
+ */
+async function handleStatus() {
+    await (0, usage_sync_1.refreshAllAccountUsage)();
+    const statuses = (0, status_1.collectAccountStatuses)();
+    console.log((0, status_1.renderStatusTable)(statuses));
+    const available = statuses.filter((item) => item.isAvailable).length;
+    const cooldown = statuses.filter((item) => item.isFiveHourLimited && !item.isWeeklyLimited).length;
+    const weeklyLimited = statuses.filter((item) => item.isWeeklyLimited).length;
+    console.log("");
+    console.log(`available=${available} cooldown=${cooldown} weekly_limited=${weeklyLimited}`);
+}
+/**
+ * 将已有的 Codex HOME 目录纳入 codexl 管理。
+ *
+ * @param accountId 本地账号标识。
+ * @param codexHome 现有 HOME 目录；若未传则默认使用当前用户 HOME。
+ * @returns 无返回值。
+ */
+function handleAccountImport(accountId, codexHome) {
+    const home = codexHome ? (0, config_1.expandHome)(codexHome) : process.env.HOME ?? "";
+    const account = (0, account_store_1.registerManagedAccount)(accountId, home);
+    console.log(`账号已导入: ${account.id}`);
+    console.log(`来源 HOME: ${account.codex_home}`);
+}
+/**
+ * 执行隔离登录流程，将账号录入到 codexl 管理目录。
+ *
+ * @param accountId 本地账号标识。
+ * @returns Promise，无返回值。
+ */
+async function handleAccountLogin(accountId) {
+    const home = await (0, login_1.loginManagedAccount)(accountId);
+    console.log(`登录完成，账号目录: ${home}`);
+}
+/**
+ * 删除配置中的账号项。
+ *
+ * @param accountId 本地账号标识。
+ * @returns 无返回值。
+ * @throws 当账号不存在时抛出错误。
+ */
+function handleAccountRemove(accountId) {
+    const removed = (0, account_store_1.removeManagedAccount)(accountId);
+    if (!removed) {
+        throw new Error(`未找到账号 ${accountId}`);
+    }
+    console.log(`已删除账号配置: ${removed.id}`);
+}
+/**
+ * 判断后台服务当前是否在运行。
+ *
+ * @returns 运行中的 PID；未运行时返回 `null`。
+ */
+function getRunningPid() {
+    const pidPath = (0, config_1.getPidPath)();
+    if (!node_fs_1.default.existsSync(pidPath)) {
+        return null;
+    }
+    const raw = node_fs_1.default.readFileSync(pidPath, "utf8").trim();
+    const pid = Number(raw);
+    if (!Number.isInteger(pid) || pid <= 0) {
+        node_fs_1.default.rmSync(pidPath, { force: true });
+        return null;
+    }
+    try {
+        process.kill(pid, 0);
+        return pid;
+    }
+    catch {
+        node_fs_1.default.rmSync(pidPath, { force: true });
+        return null;
+    }
+}
+/**
+ * 后台启动 codexl 服务并写入 PID 文件。
+ *
+ * @returns Promise，无返回值。
+ * @throws 当服务已在运行或子进程启动失败时抛出异常。
+ */
+async function handleStart(portOverride) {
+    const config = (0, config_1.loadConfig)();
+    const port = portOverride ? Number(portOverride) : config.server.port;
+    if (portOverride) {
+        config.server.port = port;
+        (0, config_1.saveConfig)(config);
+    }
+    const runningPid = getRunningPid();
+    if (runningPid) {
+        console.log(`服务已在运行，PID=${runningPid}`);
+        if (portOverride) {
+            console.log(`已将新端口写入配置: ${port}`);
+            console.log("请先执行 codexl stop，再执行 codexl start 使新端口生效。");
+        }
+        return;
+    }
+    const logPath = (0, config_1.getServiceLogPath)();
+    const logFd = node_fs_1.default.openSync(logPath, "a");
+    const child = (0, node_child_process_1.spawn)(process.execPath, [__filename.replace(/cli\.js$/, "serve.js"), "--port", String(port)], {
+        detached: true,
+        stdio: ["ignore", logFd, logFd]
+    });
+    child.unref();
+    node_fs_1.default.writeFileSync((0, config_1.getPidPath)(), `${child.pid}\n`, "utf8");
+    console.log(`服务已启动: http://${config.server.host}:${port}`);
+    console.log(`PID: ${child.pid}`);
+    console.log(`日志: ${logPath}`);
+}
+/**
+ * 停止后台运行的 codexl 服务。
+ *
+ * @returns 无返回值。
+ */
+function handleStop() {
+    const pid = getRunningPid();
+    if (!pid) {
+        console.log("服务未运行");
+        return;
+    }
+    process.kill(pid, "SIGTERM");
+    node_fs_1.default.rmSync((0, config_1.getPidPath)(), { force: true });
+    console.log(`服务已停止，PID=${pid}`);
+}
+/**
+ * 输出当前 `codex` 需要的 provider 配置与本地 key 信息。
+ *
+ * @returns 无返回值。
+ */
+function handleGetConfig() {
+    const config = (0, config_1.loadConfig)();
+    console.log(`base_url=${`http://${config.server.host}:${config.server.port}/v1`}`);
+    console.log(`api_key=${config.server.api_key}`);
+}
+function escapeRegExp(input) {
+    return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * 将 codexl provider 配置写入指定的 codex config.toml。
+ *
+ * @param targetPathOrDir 可选的 codex 配置目录或 config.toml 文件路径。
+ * @returns 无返回值。
+ */
+function handleConfig(targetPathOrDir) {
+    const config = (0, config_1.loadConfig)();
+    const rawTarget = targetPathOrDir ? (0, config_1.expandHome)(targetPathOrDir) : node_path_1.default.join(process.env.HOME ?? "", ".codex", "config.toml");
+    const targetFile = rawTarget.endsWith(".toml") ? rawTarget : node_path_1.default.join(rawTarget, "config.toml");
+    const startMarker = "# >>> codexl managed start >>>";
+    const endMarker = "# <<< codexl managed end <<<";
+    const block = [
+        startMarker,
+        "[model_providers.codexl]",
+        'name = "codexl"',
+        `base_url = "http://${config.server.host}:${config.server.port}/v1"`,
+        `http_headers = { Authorization = "Bearer ${config.server.api_key}" }`,
+        'wire_api = "responses"',
+        endMarker
+    ].join("\n");
+    let original = "";
+    if (node_fs_1.default.existsSync(targetFile)) {
+        original = node_fs_1.default.readFileSync(targetFile, "utf8");
+    }
+    else {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(targetFile), { recursive: true });
+    }
+    const managedBlockPattern = new RegExp(`${escapeRegExp(startMarker)}[\\s\\S]*?${escapeRegExp(endMarker)}\\n?`, "g");
+    const lines = original.replace(managedBlockPattern, "").split(/\r?\n/);
+    let insertAfterIndex = -1;
+    let hasGlobalModelProvider = false;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (/^#\s*model_provider\s*=/.test(trimmed)) {
+            lines[i] = 'model_provider = "codexl"';
+            hasGlobalModelProvider = true;
+            continue;
+        }
+        if (trimmed.startsWith("#")) {
+            continue;
+        }
+        if (/^model_provider\s*=/.test(trimmed)) {
+            lines[i] = 'model_provider = "codexl"';
+            hasGlobalModelProvider = true;
+            continue;
+        }
+        if (trimmed === "[model_providers.codexl]") {
+            let j = i;
+            while (j < lines.length) {
+                const current = lines[j];
+                const currentTrimmed = current.trim();
+                if (j > i && currentTrimmed.startsWith("[") && !currentTrimmed.startsWith("[[")) {
+                    break;
+                }
+                insertAfterIndex = j;
+                j += 1;
+            }
+            lines.splice(i, j - i);
+            insertAfterIndex = i - 1;
+            i = j - 1;
+        }
+    }
+    const blockLines = block.split("\n");
+    if (insertAfterIndex >= 0) {
+        lines.splice(insertAfterIndex + 1, 0, "", ...blockLines);
+    }
+    else {
+        if (!hasGlobalModelProvider) {
+            const firstNonEmptyIndex = lines.findIndex((line) => line.trim() !== "");
+            if (firstNonEmptyIndex >= 0) {
+                lines.splice(firstNonEmptyIndex, 0, 'model_provider = "codexl"', "");
+            }
+            else {
+                lines.push('model_provider = "codexl"', "");
+            }
+        }
+        if (lines.length > 0 && lines[lines.length - 1].trim() !== "") {
+            lines.push("");
+        }
+        lines.push(...blockLines);
+    }
+    const nextContent = `${lines.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
+    node_fs_1.default.writeFileSync(targetFile, nextContent, "utf8");
+    console.log(`已写入: ${targetFile}`);
+    console.log(`base_url=http://${config.server.host}:${config.server.port}/v1`);
+    console.log(`api_key=${config.server.api_key}`);
+    console.log('提示: 已写入 codexl provider；如果原来存在 model_provider，则已切换为 codexl；model 保持不变。');
+}
+/**
+ * CLI 主入口，负责命令注册与执行。
+ *
+ * @returns Promise，无返回值。
+ * @throws 当命令执行失败时向上抛出异常。
+ */
+async function main() {
+    const program = new commander_1.Command();
+    (0, config_1.getCodexSwHome)();
+    (0, config_1.loadConfig)();
+    program
+        .name("codexsw")
+        .name("codexl")
+        .description("本地 Codex 多账号切换与状态管理工具")
+        .version("0.1.0");
+    program
+        .command("add")
+        .description("登录并新增一个账号或工作空间")
+        .argument("<accountId>", "账号标识")
+        .action(async (accountId) => {
+        await handleAccountLogin(accountId);
+    });
+    program
+        .command("del")
+        .description("删除一个已录入账号")
+        .argument("<accountId>", "账号标识")
+        .action(handleAccountRemove);
+    program
+        .command("import")
+        .description("导入当前或指定 HOME 下的官方 codex 登录态")
+        .argument("<accountId>", "账号标识")
+        .argument("[codexHome]", "已有 HOME 目录，默认当前用户 HOME")
+        .action(handleAccountImport);
+    program
+        .command("status")
+        .description("刷新并查看所有已录入账号或工作空间的最新额度")
+        .action(async () => {
+        await handleStatus();
+    });
+    program
+        .command("start")
+        .description("后台启动本地代理服务")
+        .option("--port <port>", "监听端口")
+        .action(async (options) => {
+        await handleStart(options.port);
+    });
+    program.command("stop").description("停止后台代理服务").action(handleStop);
+    program.command("get").description("输出当前 base_url 和 api_key").action(handleGetConfig);
+    program
+        .command("config")
+        .description("自动写入 codex 的 config.toml，默认 ~/.codex/config.toml")
+        .argument("[codexPath]", "codex 配置目录或 config.toml 文件路径")
+        .action(handleConfig);
+    await program.parseAsync(process.argv);
+}
+void main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`codexl 执行失败: ${message}`);
+    process.exit(1);
+});