codex-mux 0.1.0

package/LICENSE

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

@@ -0,0 +1,218 @@
+# codex-mux
+
+`codex-mux`는 Codex CLI(`@openai/codex`)를 여러 계정 프로필로 분리해 쓰기 위한 비공식 래퍼 CLI입니다.
+
+핵심 목적:
+- 터미널 A는 계정 A, 터미널 B는 계정 B로 동시에 사용
+- 매번 `codex logout` -> `codex login` 반복하는 불편 최소화
+- `CODEX_HOME`을 프로필별로 자동 분리
+
+## Important Notice (Unofficial)
+
+- 이 프로젝트는 OpenAI의 공식 제품이 아닙니다.
+- OpenAI/Codex의 이름은 해당 권리자에게 있습니다.
+- 이 도구는 설치된 `codex` 실행 파일을 호출하는 래퍼이며, 계정 제한 우회 기능을 제공하지 않습니다.
+
+## Prerequisites
+
+- Node.js + npm
+- Codex CLI 설치
+
+```bash
+npm i -g @openai/codex
+```
+
+Codex CLI가 PATH에 있어야 `mux login`, `mux logout`, `mux run`이 동작합니다.
+
+## Install (Local Development)
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+설치 후:
+
+```bash
+mux --help
+```
+
+## Why This Exists
+
+Codex CLI 기본 동작은 단일 `~/.codex`를 사용합니다. 그래서 계정 전환이 자주 필요할 때 로그인/로그아웃이 번거롭습니다.
+
+`codex-mux`는 아래처럼 프로필별 저장소를 분리합니다:
+
+- `~/.codex-mux/state.json`
+- `~/.codex-mux/profiles/<profile>/codex-home`
+
+각 프로필은 서로 다른 `auth.json`을 가지므로 로그인 상태가 분리됩니다.
+
+## Quick Start
+
+1. 프로필 선택
+
+```bash
+mux use a
+```
+
+2. 로그인
+
+```bash
+mux login
+```
+
+3. Codex 실행
+
+```bash
+mux run
+```
+
+다른 터미널에서는:
+
+```bash
+mux use b
+mux login
+mux run
+```
+
+## A/B Account Example
+
+아래 예시는 터미널 2개를 열고, 각각 다른 계정을 유지하는 가장 일반적인 흐름입니다.
+
+Terminal 1 (Account A):
+
+```bash
+mux use a
+mux login
+mux run
+```
+
+Terminal 2 (Account B):
+
+```bash
+mux use b
+mux login
+mux run
+```
+
+상태 확인:
+
+```bash
+mux current
+mux list
+mux list --json
+```
+
+필요할 때 로그아웃:
+
+```bash
+mux logout -p a
+mux logout -p b
+```
+
+프로필 지정으로 한 번에 실행하고 싶을 때:
+
+```bash
+mux login -p a
+mux run -p a
+mux login -p b
+mux run -p b
+```
+
+## Commands
+
+### `mux use <profile>`
+현재 터미널 세션의 활성 프로필을 설정합니다.
+
+옵션:
+- `--global`: 세션이 아닌 전역 기본 프로필로 설정
+- `--json`: JSON 출력
+- `--verbose`: 디버그 정보 출력
+
+예시:
+
+```bash
+mux use a
+mux use team-b --global
+```
+
+### `mux current`
+현재 활성 프로필을 확인합니다.
+
+옵션:
+- `-p, --profile <name>`: 특정 프로필 기준으로 확인
+- `--json`
+- `--verbose`
+
+예시:
+
+```bash
+mux current
+mux current --json
+```
+
+### `mux login [codexArgs...]`
+선택된 프로필의 `CODEX_HOME`으로 `codex login`을 실행합니다.
+
+옵션:
+- `-p, --profile <name>`
+- `--verbose`
+
+예시:
+
+```bash
+mux login
+mux login -p b
+```
+
+### `mux logout [codexArgs...]`
+선택된 프로필의 `CODEX_HOME`으로 `codex logout`을 실행합니다.
+
+옵션:
+- `-p, --profile <name>`
+- `--verbose`
+
+예시:
+
+```bash
+mux logout
+mux logout -p a
+```
+
+### `mux run [codexArgs...]`
+선택된 프로필의 `CODEX_HOME`으로 `codex`를 실행합니다.
+
+옵션:
+- `-p, --profile <name>`
+- `--verbose`
+
+예시:
+
+```bash
+mux run
+mux run -p b -- --help
+mux run -p a chat
+```
+
+### `mux list`
+등록된 프로필 목록과 로그인 상태를 보여줍니다.
+
+옵션:
+- `--json`
+- `--verbose`
+
+예시:
+
+```bash
+mux list
+mux list --json
+```
+
+## Recommended Usage Pattern
+
+- 터미널 1: `mux use a` -> `mux run`
+- 터미널 2: `mux use b` -> `mux run`
+
+필요할 때만 각 터미널에서 `mux login`/`mux logout`을 실행하세요.

package/README.md

@@ -0,0 +1,222 @@
+# codex-mux
+
+`codex-mux` is an unofficial wrapper CLI that lets you use Codex CLI (`@openai/codex`) with multiple account profiles.
+
+Primary goals:
+- Use account A in terminal A and account B in terminal B at the same time
+- Avoid repetitive `codex logout` -> `codex login` switching
+- Isolate `CODEX_HOME` per profile automatically
+
+## Important Notice (Unofficial)
+
+- This project is not an official OpenAI product.
+- OpenAI and Codex names are trademarks of their respective owners.
+- This tool wraps an installed `codex` binary and does not provide account-limit bypass features.
+
+## Prerequisites
+
+- Node.js + npm
+- Codex CLI installed
+
+```bash
+npm i -g @openai/codex
+```
+
+`codex` must be available in your PATH for `mux login`, `mux logout`, and `mux run`.
+
+## Install (Local Development)
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+Then check:
+
+```bash
+mux --help
+```
+
+## Why This Exists
+
+Codex CLI uses a single default home (`~/.codex`). If you switch accounts often, repeated login/logout becomes tedious.
+
+`codex-mux` isolates profile storage under:
+
+- `~/.codex-mux/state.json`
+- `~/.codex-mux/profiles/<profile>/codex-home`
+
+Each profile has its own `auth.json`, so login sessions remain separated.
+
+## Quick Start
+
+1. Select a profile
+
+```bash
+mux use a
+```
+
+2. Login for that profile
+
+```bash
+mux login
+```
+
+3. Run Codex with that profile
+
+```bash
+mux run
+```
+
+In another terminal:
+
+```bash
+mux use b
+mux login
+mux run
+```
+
+## A/B Account Example
+
+Use two terminals and keep different accounts active.
+
+Terminal 1 (Account A):
+
+```bash
+mux use a
+mux login
+mux run
+```
+
+Terminal 2 (Account B):
+
+```bash
+mux use b
+mux login
+mux run
+```
+
+Check status:
+
+```bash
+mux current
+mux list
+mux list --json
+```
+
+Logout when needed:
+
+```bash
+mux logout -p a
+mux logout -p b
+```
+
+If you prefer explicit profile flags:
+
+```bash
+mux login -p a
+mux run -p a
+mux login -p b
+mux run -p b
+```
+
+## Commands
+
+### `mux use <profile>`
+Set the active profile for the current terminal session.
+
+Options:
+- `--global`: set global default profile instead of session-only
+- `--json`: JSON output
+- `--verbose`: debug output
+
+Examples:
+
+```bash
+mux use a
+mux use team-b --global
+```
+
+### `mux current`
+Show the active profile for this terminal.
+
+Options:
+- `-p, --profile <name>`: resolve/show a specific profile
+- `--json`
+- `--verbose`
+
+Examples:
+
+```bash
+mux current
+mux current --json
+```
+
+### `mux login [codexArgs...]`
+Run `codex login` with the selected profile's `CODEX_HOME`.
+
+Options:
+- `-p, --profile <name>`
+- `--verbose`
+
+Examples:
+
+```bash
+mux login
+mux login -p b
+```
+
+### `mux logout [codexArgs...]`
+Run `codex logout` with the selected profile's `CODEX_HOME`.
+
+Options:
+- `-p, --profile <name>`
+- `--verbose`
+
+Examples:
+
+```bash
+mux logout
+mux logout -p a
+```
+
+### `mux run [codexArgs...]`
+Run `codex` with the selected profile's `CODEX_HOME`.
+
+Options:
+- `-p, --profile <name>`
+- `--verbose`
+
+Examples:
+
+```bash
+mux run
+mux run -p b -- --help
+mux run -p a chat
+```
+
+### `mux list`
+List registered profiles and login status.
+
+Options:
+- `--json`
+- `--verbose`
+
+Examples:
+
+```bash
+mux list
+mux list --json
+```
+
+## Recommended Usage Pattern
+
+- Terminal 1: `mux use a` -> `mux run`
+- Terminal 2: `mux use b` -> `mux run`
+
+Use `mux login`/`mux logout` only when needed.
+
+## Korean README
+
+For Korean documentation, see `README.ko.md`.

package/dist/index.js

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+import { Command, Option } from 'commander';
+import { execa } from 'execa';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import which from 'which';
+const DEFAULT_STATE = {
+    version: 1,
+    sessionProfiles: {},
+    profiles: {}
+};
+const MUX_HOME = process.env.CODEX_MUX_HOME ?? path.join(homedir(), '.codex-mux');
+const STATE_FILE = path.join(MUX_HOME, 'state.json');
+const PROFILES_DIR = path.join(MUX_HOME, 'profiles');
+function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+function readState() {
+    ensureDir(MUX_HOME);
+    if (!fs.existsSync(STATE_FILE)) {
+        return { ...DEFAULT_STATE };
+    }
+    try {
+        const raw = fs.readFileSync(STATE_FILE, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            version: 1,
+            globalProfile: parsed.globalProfile,
+            sessionProfiles: parsed.sessionProfiles ?? {},
+            profiles: parsed.profiles ?? {}
+        };
+    }
+    catch {
+        return { ...DEFAULT_STATE };
+    }
+}
+function writeState(state) {
+    ensureDir(MUX_HOME);
+    fs.writeFileSync(STATE_FILE, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
+}
+function sanitizeProfile(name) {
+    const trimmed = name.trim();
+    if (!trimmed) {
+        throw new Error('Profile name cannot be empty.');
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(trimmed)) {
+        throw new Error('Profile name must match /^[a-zA-Z0-9_-]+$/.');
+    }
+    return trimmed;
+}
+function profileCodexHome(name) {
+    return path.join(PROFILES_DIR, name, 'codex-home');
+}
+function ensureProfile(state, profile) {
+    if (!state.profiles[profile]) {
+        state.profiles[profile] = { codexHome: profileCodexHome(profile) };
+    }
+    ensureDir(state.profiles[profile].codexHome);
+}
+function getSessionKey() {
+    const envSession = process.env.CODEX_MUX_SESSION ??
+        process.env.TERM_SESSION_ID ??
+        process.env.ITERM_SESSION_ID ??
+        process.env.TMUX_PANE;
+    if (envSession) {
+        return envSession;
+    }
+    try {
+        const ttyPath = fs.realpathSync('/dev/fd/0');
+        if (ttyPath && ttyPath !== '/dev/null') {
+            return ttyPath;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return `pid:${process.ppid}`;
+}
+function resolveProfile(state, options) {
+    if (options.profile) {
+        const selected = sanitizeProfile(options.profile);
+        ensureProfile(state, selected);
+        return selected;
+    }
+    const sessionKey = getSessionKey();
+    const sessionProfile = state.sessionProfiles[sessionKey];
+    if (sessionProfile) {
+        ensureProfile(state, sessionProfile);
+        return sessionProfile;
+    }
+    if (state.globalProfile) {
+        ensureProfile(state, state.globalProfile);
+        return state.globalProfile;
+    }
+    throw new Error('No active profile. Run `mux use <profile>` first.');
+}
+function codexExecutable() {
+    try {
+        return which.sync('codex');
+    }
+    catch {
+        throw new Error('`codex` command not found in PATH. Install Codex CLI first.');
+    }
+}
+async function runCodexWithProfile(profile, args, verbose = false) {
+    const state = readState();
+    ensureProfile(state, profile);
+    writeState(state);
+    const codexHome = state.profiles[profile].codexHome;
+    const codexBin = codexExecutable();
+    if (verbose) {
+        console.error(`[mux] profile=${profile} CODEX_HOME=${codexHome}`);
+    }
+    const child = execa(codexBin, args, {
+        stdio: 'inherit',
+        env: {
+            ...process.env,
+            CODEX_HOME: codexHome
+        }
+    });
+    try {
+        await child;
+        return 0;
+    }
+    catch (error) {
+        const execaError = error;
+        return execaError.exitCode ?? 1;
+    }
+}
+function authSummary(codexHome) {
+    const authFile = path.join(codexHome, 'auth.json');
+    if (!fs.existsSync(authFile)) {
+        return { loggedIn: false };
+    }
+    try {
+        const raw = fs.readFileSync(authFile, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            loggedIn: true,
+            accountId: parsed.tokens?.account_id,
+            authMode: parsed.auth_mode
+        };
+    }
+    catch {
+        return { loggedIn: true };
+    }
+}
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+async function main() {
+    const program = new Command();
+    const commonProfileOption = new Option('-p, --profile <name>', 'profile name');
+    const commonVerboseOption = new Option('--verbose', 'show debug details');
+    program
+        .name('mux')
+        .description('Multi-account profile switcher for Codex CLI')
+        .version('0.1.0');
+    program
+        .command('use <profile>')
+        .description('set active profile for this terminal session (or globally)')
+        .addOption(new Option('--global', 'set global default profile'))
+        .addOption(new Option('--json', 'output as JSON'))
+        .addOption(commonVerboseOption)
+        .action((profileArg, options) => {
+        const profile = sanitizeProfile(profileArg);
+        const state = readState();
+        ensureProfile(state, profile);
+        const sessionKey = getSessionKey();
+        if (options.global) {
+            state.globalProfile = profile;
+        }
+        else {
+            state.sessionProfiles[sessionKey] = profile;
+        }
+        writeState(state);
+        const codexHome = state.profiles[profile].codexHome;
+        if (options.json) {
+            printJson({
+                ok: true,
+                profile,
+                scope: options.global ? 'global' : 'session',
+                sessionKey: options.global ? undefined : sessionKey,
+                codexHome
+            });
+            return;
+        }
+        if (options.verbose) {
+            console.log(`profile=${profile}`);
+            console.log(`scope=${options.global ? 'global' : 'session'}`);
+            console.log(`session=${sessionKey}`);
+            console.log(`CODEX_HOME=${codexHome}`);
+            return;
+        }
+        console.log(`${profile}`);
+    });
+    program
+        .command('current')
+        .description('show active profile for this terminal')
+        .addOption(commonProfileOption)
+        .addOption(new Option('--json', 'output as JSON'))
+        .addOption(commonVerboseOption)
+        .action((options) => {
+        const state = readState();
+        const sessionKey = getSessionKey();
+        const profile = resolveProfile(state, options);
+        ensureProfile(state, profile);
+        writeState(state);
+        const codexHome = state.profiles[profile].codexHome;
+        if (options.json) {
+            printJson({
+                profile,
+                codexHome,
+                from: options.profile ? 'option' : state.sessionProfiles[sessionKey] ? 'session' : 'global',
+                sessionKey
+            });
+            return;
+        }
+        if (options.verbose) {
+            console.log(`profile=${profile}`);
+            console.log(`session=${sessionKey}`);
+            console.log(`CODEX_HOME=${codexHome}`);
+            return;
+        }
+        console.log(`${profile}`);
+    });
+    program
+        .command('login')
+        .description('run `codex login` with selected profile')
+        .allowUnknownOption(true)
+        .addOption(commonProfileOption)
+        .addOption(commonVerboseOption)
+        .argument('[codexArgs...]', 'extra args forwarded to codex login')
+        .action(async (codexArgs, options) => {
+        const state = readState();
+        const profile = resolveProfile(state, options);
+        writeState(state);
+        const exitCode = await runCodexWithProfile(profile, ['login', ...codexArgs], options.verbose);
+        process.exitCode = exitCode;
+    });
+    program
+        .command('logout')
+        .description('run `codex logout` with selected profile')
+        .allowUnknownOption(true)
+        .addOption(commonProfileOption)
+        .addOption(commonVerboseOption)
+        .argument('[codexArgs...]', 'extra args forwarded to codex logout')
+        .action(async (codexArgs, options) => {
+        const state = readState();
+        const profile = resolveProfile(state, options);
+        writeState(state);
+        const exitCode = await runCodexWithProfile(profile, ['logout', ...codexArgs], options.verbose);
+        process.exitCode = exitCode;
+    });
+    program
+        .command('run')
+        .description('run `codex ...` with selected profile')
+        .allowUnknownOption(true)
+        .addOption(commonProfileOption)
+        .addOption(commonVerboseOption)
+        .argument('[codexArgs...]', 'args forwarded to codex')
+        .action(async (codexArgs, options) => {
+        const state = readState();
+        const profile = resolveProfile(state, options);
+        writeState(state);
+        const exitCode = await runCodexWithProfile(profile, codexArgs, options.verbose);
+        process.exitCode = exitCode;
+    });
+    program
+        .command('list')
+        .description('list profiles and login status')
+        .addOption(new Option('--json', 'output as JSON'))
+        .addOption(commonVerboseOption)
+        .action((options) => {
+        const state = readState();
+        const sessionKey = getSessionKey();
+        const activeSession = state.sessionProfiles[sessionKey];
+        const rows = Object.keys(state.profiles)
+            .sort()
+            .map((name) => {
+            const codexHome = state.profiles[name].codexHome;
+            const auth = authSummary(codexHome);
+            return {
+                profile: name,
+                codexHome,
+                sessionActive: activeSession === name,
+                globalDefault: state.globalProfile === name,
+                loggedIn: auth.loggedIn,
+                accountId: auth.accountId,
+                authMode: auth.authMode
+            };
+        });
+        if (options.json) {
+            printJson({
+                sessionKey,
+                activeSession,
+                globalProfile: state.globalProfile,
+                profiles: rows
+            });
+            return;
+        }
+        if (rows.length === 0) {
+            console.log('No profiles yet. Run `mux use <profile>` first.');
+            return;
+        }
+        for (const row of rows) {
+            const tags = [];
+            if (row.sessionActive) {
+                tags.push('session');
+            }
+            if (row.globalDefault) {
+                tags.push('global');
+            }
+            const status = row.loggedIn ? `logged-in${row.accountId ? `:${row.accountId}` : ''}` : 'logged-out';
+            const tagText = tags.length > 0 ? ` [${tags.join(',')}]` : '';
+            const base = `${row.profile}${tagText} ${status}`;
+            if (options.verbose) {
+                console.log(`${base} CODEX_HOME=${row.codexHome}`);
+            }
+            else {
+                console.log(base);
+            }
+        }
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "codex-mux",
+  "version": "0.1.0",
+  "description": "Unofficial wrapper CLI for using Codex CLI with multiple account profiles",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "mux": "dist/index.js",
+    "cx": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "@types/which": "^3.0.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "execa": "^9.6.1",
+    "which": "^6.0.0"
+  }
+}